86 lines
3.1 KiB
Markdown
86 lines
3.1 KiB
Markdown
# 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.
|