# 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.