starcoach-hackathon/zarinpal-analytics-backend
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(sdd): authorize backend implementation

Browse Source
This commit is contained in:
Amirhossein Khalili
2026-08-20 19:17:49 +03:30
parent b82ba0dc23
commit 552cae5f9d
12 changed files with 21 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
tasks/plan.md
View File

@@ -1,6 +1,6 @@
# Implementation Plan: ZarinPal Merchant Analytics Backend
- Status: Expanded implementation plan ready for stakeholder review — implementation not authorized
- Status: Approved — Phase 4 implementation authorized 2026-08-20
- Capabilities: Data foundation, demo identity, analytics engine, and Merchant API
- Approved contracts: physical schema, import workflow/validation, Identity, Analytics, metric catalogue `0.4.0`, API, and OpenAPI `1.0.0`
- Task list: `tasks/todo.md`
@@ -14,8 +14,8 @@ Build the complete Go capability-oriented modular monolith needed by the dashboa
- The approved Identity, Data Foundation, physical schema, importer, Analytics Engine, API, ADR, metric, and data-guide decisions remain authoritative.
- Architecture and dependency injection are already approved: capability-oriented modular monolith with manual constructor wiring in thin `cmd/` composition roots.
- This plan does not authorize `go.mod`, packages, generated files, dependencies, migrations, containers, or executable code.
- Implementation starts only after the plan and task list are approved and the user separately authorizes implementation.
- The user approved this plan and task list and authorized implementation on 2026-08-20.
- Implementation proceeds through `tasks/todo.md` in dependency order, starting with Task F1.
- The API work depends on implementation-ready provider interfaces from Identity and Analytics. Internal provider signatures may be refined without changing the approved HTTP contract.
- Any OpenAPI generator, validator, router, rate-limiter, or CSV dependency must be version-pinned, checked against official documentation, security-reviewed, and approved before addition.
@@ -202,7 +202,7 @@ Approved OpenAPI --> HTTP boundary --> auth/period/run/SSE/detail/CSV
## Implementation gates, not product questions
- Select and approve exact pinned OpenAPI generation/validation tooling before adding dependencies.
- Confirm repository-wide build/test/lint command wrappers when the separately authorized Go scaffold is created.
- Confirm repository-wide build/test/lint command wrappers when the authorized Go scaffold is created.
- Confirm the hosting mechanism that makes `https://zarinpal.amiirkhl.ir/docs/errors/{error-slug}` dereferenceable; the URI namespace and content responsibility are already approved.
## Product questions

2
tasks/todo.md
View File

@@ -1,6 +1,6 @@
# ZarinPal Merchant Analytics Backend Task List
- Status: Expanded task breakdown ready for stakeholder review — implementation not authorized
- Status: Approved — Phase 4 implementation authorized 2026-08-20
- Plan: `tasks/plan.md`
- Contract: `docs/API-SPEC.md` and `docs/openapi.yaml` version `1.0.0`