docs: record Sprint 0.1 decisions across delivery plan, gap analysis, backend contract
Some checks failed
Architecture Governance / architecture (push) Has been cancelled
Some checks failed
Architecture Governance / architecture (push) Has been cancelled
User answered 8 of 9 Sprint 0.1 blocking decisions (2026-08-17); backend ownership stays open pending a clearer re-ask. Recorded and propagated: - Payment chain unfrozen -> BACKEND-API-REFERENCE.md §7 and the Phase 1 contract doc's status banner both updated; Phase 1/6/7 unblocked. - No fixed external-marketplace list -> Phase 4's connector framework respecified as config-driven/generic; Sprint 4.2 retired as "per named marketplace," replaced with a generic onboarding runbook. - FX rate source: ours, in-house, as the default (not just a fallback) -> Phase 1 contract's `source` field can read "internal" as the normal case. - VK ID before OTP -> Phase 8 sprints resequenced (VK ID now 8.2, OTP 8.3). - Multi-seller orders: unified -> Phase 3.3, Phase 5.2, and Z16 updated to the resolved model (one Order, per-seller Fulfillment groups). - "Fixed 5-second payment" claim: confirmed non-issue, PAYMENT_POLL_INTERVAL_MS is already 5000 (real polling cadence, not an artificial delay). - API namespace: new endpoints only (/api/v2/...), no forced migration of legacy endpoints. - Document version: v3.1 is canonical. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
@@ -2,7 +2,7 @@
|
||||
|
||||
Companion to [PRODUCT-PLAN-v3.1-DELIVERY-PLAN.md](../PRODUCT-PLAN-v3.1-DELIVERY-PLAN.md) Phase 1 (Sprints 1.1–1.4) and [PRODUCT-PLAN-v3.1-GAP-ANALYSIS.md](../PRODUCT-PLAN-v3.1-GAP-ANALYSIS.md) §3.3/§3.5/§3.6.
|
||||
|
||||
**Status: blocked.** [BACKEND-API-REFERENCE.md §7](../../BACKEND-API-REFERENCE.md) marks the cart/payment call chain "frozen — explicitly out of scope for changes." This document specifies the target contract so backend work can start the moment that freeze lifts or is scoped around; it does not imply the freeze has been lifted. See open decision in the delivery plan's Sprint 0.1.
|
||||
**Status: unblocked (2026-08-17).** [BACKEND-API-REFERENCE.md §7](../../BACKEND-API-REFERENCE.md) previously marked the cart/payment call chain frozen. Per the delivery plan's Sprint 0.1 decision, the freeze is lifted — this contract can move to implementation once backend ownership (also Sprint 0.1, still open) is confirmed.
|
||||
|
||||
This doc is the frontend's ask, in the same style as `BACKEND-API-REFERENCE.md`. It does not prescribe backend implementation (DB schema, service boundaries) — only the wire contract and the invariants the frontend needs to hold.
|
||||
|
||||
@@ -221,8 +221,9 @@ A retried call with the same `checkoutSessionId` must return the existing order,
|
||||
|
||||
---
|
||||
|
||||
## 9. Open questions (mirrors delivery-plan Sprint 0.1)
|
||||
## 9. Resolved / open questions (Sprint 0.1, 2026-08-17)
|
||||
|
||||
1. Payment chain freeze — must be lifted or explicitly scoped around before §5 can ship.
|
||||
2. FX rate source/provider — not named yet; `source` field above is provider-agnostic pending that answer.
|
||||
3. Does the backend return already-converted prices, or does the frontend request a specific display currency at checkout time (as modeled in §5.2)? This doc assumes the latter; confirm before implementation.
|
||||
1. **Payment chain freeze — lifted.** §5 can proceed.
|
||||
2. **FX rate source/provider — ours, in-house, as the default (not just a fallback).** No external provider committed. Backend computes and serves the quote itself; the `source` field in §3.1 can legitimately read `"internal"` as the normal case. Revisit if an external provider is chosen later — the contract shape doesn't need to change, only the value of `source`.
|
||||
3. **Backend-converted prices vs. frontend-requested display currency — still open, needs confirmation before implementation.** This doc's §5.2 models the frontend sending a target `currency` and the backend returning the converted total. Confirm this is the intended flow before backend implementation starts.
|
||||
4. **Backend ownership — still open.** This contract is ready regardless of who builds against it, but implementation can't be scheduled until this is answered.
|
||||
|
||||
Reference in New Issue
Block a user