From 088735b948d46896b8af30efcb0a2dc5d362b97f Mon Sep 17 00:00:00 2001 From: "Somhairle H. Marisol" Date: Fri, 18 Sep 2026 08:27:41 +0800 Subject: docs(release): 全周期交接文档入库（含 ui-shadcn 迁移交付说明） MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit [变更性质] 纯文档提交，无运行时逻辑。 [文档内容] 补齐此前各轮未入库的交接/验收文档：backend-auth/backend-domain/ domain-authorization-user（认证与授权域）、etf-recovery-release- handoff（ETF 修复 + ops 演练定稿与生产部署命令）、recovery-* 系列、 frontend/parent-ui-findings（UI 迁移上下文）、worker/integration 等， 以及本轮 docs/ui-shadcn-handoff.md（shadcn-svelte 迁移交接，含 Chart.svelte 契约、runes $state 踩坑记录与 375/768/1440 验证证据）。 [更新方案] 按主题分文；每份文档只记录可复现的命令、验证结果与语义边界， 不导出密钥或生产敏感路径。 [影响范围] 文档渠道：后续 leader/client 审阅入口；与代码提交一一对应便于回溯。 --- docs/implementation-plan.md | 50 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 docs/implementation-plan.md (limited to 'docs/implementation-plan.md') diff --git a/docs/implementation-plan.md b/docs/implementation-plan.md new file mode 100644 index 0000000..275f324 --- /dev/null +++ b/docs/implementation-plan.md @@ -0,0 +1,50 @@ +# Strategy Lab Implementation Plan + +> Agentic workers: execute the approved SPEC.md task-by-task, use TDD and actual tool evidence. User explicitly selected OpenCode + GLM-5.3-Flash. + +Goal: working private self-service strategy research platform, not a mockup. +Architecture: static Svelte client, Rust/Axum API and persistent SQLite queue, isolated Python AKShare/Backtrader worker; replaceable remote model adapter. +Tech Stack: Rust, Axum, rusqlite, Svelte, TypeScript, Vite, Backtrader, AKShare, Docker. + +## Task A — Runtime prerequisites and contract +1. Install latest npm opencode-ai and record version (done 1.18.31). +2. Secure launcher reads only active Hermes OPENCODE_GO_API_KEY and injects subprocess environment; no key copied to source (done). +3. Smoke actual glm-5.3-flash call and record success (done). +4. Install Rust compiler and verify Docker and Node/Python tools (done). +5. Freeze SPEC.md HTTP/worker contracts; do not overwrite other agents' work. + +## Task B — Worker, tests before implementation +Files worker/{main,data,backtest}.py, worker/Dockerfile, requirements-worker.txt, tests/worker/, docs/worker.md. +1. Write failing normalization tests: preserve raw fields/units, reject bad dates/missing data, no substituted symbols. +2. Run pytest, then implement adapters and test until green. +3. Write failing deterministic Backtrader accounting/next-bar tests using labeled synthetic input. +4. Implement mature-engine runner and manifest/result protocol; rerun tests. +5. Probe real AKShare endpoints and report exact successes/failures, write actual evidence. +6. Build Docker image, backtest without network and credentials, measure memory. + +## Task C — Backend, tests before implementation +Files server/Cargo.toml, server/src/{main,db,auth,projects,datasets,runs,worker,ai}.rs, server/tests/, docs/backend.md. +1. Write failing owner/auth and immutable revision tests; implement SQLite schema and handlers. +2. Write failing request validation/cache key tests; implement safe dataset jobs and immutable blobs. +3. Write failing run lifecycle/restart/cancel tests; implement bounded Docker runner. +4. Write failing AI stale-generation/owner tests; implement configurable API adapter and real usage ledger. +5. Run cargo test, cargo build --release (CARGO_BUILD_JOBS=2 to avoid memory pressure). + +## Task D — Frontend, checks and interaction tests +Files frontend/package.json, frontend/src/... , docs/frontend.md. +1. Add executable tests for workflow state and API errors before implementation. +2. Build login, project list, actual self-service data wizard/preview. +3. Build editor/autosave/version diff/restore, dataset selector, run controls and status. +4. Build result charts/trades/run comparison, AI proposed-code diff/accept/usage. +5. Run check/test/build and Playwright browser smoke; no fixture data in production. + +## Task E — Integration and independent QA +1. Read all outputs; reconcile HTTP and worker contract differences through OpenCode fixes. +2. Start service loopback with secrets injected at runtime; health check independently. +3. Create private account, actual data request, cache reuse request, version/restore/run/compare, real AI suggestion+accept. +4. Negative tests authentication, cross-user access, stale edits, timeout/network worker policies. +5. Browser QA all main pages, screenshot and visual inspection, fix concrete problems. +6. Measure process RSS/CPU/build sizes and actual experiment duration. Record actual outcomes, no estimates called measured. +7. README with reproducible install/run/test, data/model licensing and internal-only limitations. Backup/restart test. Deliver local URL/source/screenshots. + +No public publishing, payment integration or API resale. Any unimplemented acceptance item must be explicitly listed as incomplete rather than claimed complete. -- cgit v1.2.3