yanting/docs/DEVELOPMENT_HISTORY.md

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.