chore: prepare yanting monorepo handoff

docs/DEVELOPMENT_HISTORY.md

@@ -0,0 +1,85 @@
+# Development History
+
+This is a handoff snapshot, not the product SSOT.
+
+Product SSOT: mall-docs report-notebooklm docs, snapshot date: 2026-06-03.
+
+## 2026-06-02 - Product Scope Freeze
+
+- Product scope was corrected away from the old "Wall Street listening" / pure-audio framing.
+- Phase 1 was frozen around a Chinese research-report interpretation app.
+- Main tabs were fixed as 推荐 / 研报 / 机构 / 听单 / 我的.
+- Non-goals were made explicit: no commercialization, comments, UGC, trading advice, professional terminal, or local Vision runtime dependency.
+- Vision was kept as reference/source experience, not production runtime.
+
+## 2026-06-02 - Development Plan and Review
+
+- Phase 1 technical baseline was selected:
+  - Flutter App.
+  - FastAPI backend.
+  - MySQL 8.
+  - Redis with `rnb:` namespace.
+  - Object storage for raw artifacts, heavy modules, audio, and images.
+  - Existing cloud/server deployment model.
+- External launch dependencies were identified:
+  - SMS template/signature.
+  - WeChat Open Platform.
+  - Apple login if required.
+  - AI-generated-content labeling.
+  - compliance review for source and media policies.
+- The plan passed independent review with changes requested around launch blockers and implementation details.
+
+## 2026-06-03 - Backend Scaffold
+
+- FastAPI service created under `report-notebooklm-api/`.
+- SQLAlchemy model layer created for Phase 1 tables.
+- Alembic initial migration added.
+- Seed importer added with institutions, reports, display artifacts, display modules, audio assets, users, favorites, and playback progress.
+- Public read routes implemented:
+  - `/health`
+  - `/feed/recommended`
+  - `/reports`
+  - `/reports/{id}`
+  - `/reports/{id}/modules/{module_id}`
+  - `/institutions`
+  - `/institutions/{id}`
+  - `/listen`
+- Tests added for seed counts, public API shape, hidden/review module boundaries, gray-source behavior, and listen list behavior.
+
+## 2026-06-03 - App Scaffold
+
+- Flutter app shell created under `report-notebooklm-app/`.
+- Five tabs implemented.
+- API client added with explicit `RNB_API_BASE`.
+- Feature folders created for feed, reports, institutions, listen, profile, detail, and shared widgets.
+- Detail module renderer registry added.
+- Local placeholders added for blocked behaviors:
+  - login
+  - favorite
+  - outbound confirmation
+  - playback progress
+  - real audio stream
+- Android platform scaffold added.
+
+## 2026-06-03 - Handoff Preparation
+
+- Backend and App documentation added.
+- Public docs were distilled from product documents without copying the full product-doc tree.
+- Local-only paths and raw session details were separated from public docs.
+- Root README and public AGENTS instructions were introduced for the single-repo Gitea handoff.
+
+## Current Verification Snapshot
+
+Validated during handoff preparation:
+
+- Backend editable install with dev dependencies.
+- Backend migration.
+- Backend seed import.
+- Backend tests.
+- Backend smoke checks for health, feed, and report detail.
+- App analyze.
+- App widget test.
+- App web build.
+- App debug APK build.
+
+Build artifacts are transient and are not committed.