jimme
6c72b7d048
- Add docs/DATA_SOURCE_FLOW.md: end-to-end source -> NotebookLM -> storage -> App flow, source list with publish frequency, institution intro status, ingestion artifact structure, and known cadence gaps - Link the new doc from README and PROJECT_OVERVIEW indexes - Localize top-level and subproject READMEs to Chinese for handoff (pre-existing working-tree changes) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1.9 KiB
1.9 KiB
Project Overview
This is a handoff snapshot, not the product SSOT.
Product SSOT: mall-docs report-notebooklm docs, snapshot date: 2026-06-03.
Purpose
研听 is a Chinese app for understanding global institutional research reports. It converts difficult English research reports into reviewed Chinese reading and listening experiences.
The product is a research-report interpretation and annotation service. It does not provide investment advice.
Technical Shape
| Layer | Technology | Path |
|---|---|---|
| App | Flutter | report-notebooklm-app/ |
| API | FastAPI | report-notebooklm-api/ |
| Database | MySQL 8 | configured by RNB_DATABASE_URL |
| Cache | Redis | configured by RNB_REDIS_URL |
| Storage | Object storage | planned for raw artifacts, modules, audio, images |
Phase 1 Surfaces
- 推荐: latest and curated report interpretations.
- 研报: all published report interpretations with basic filters.
- 机构: institution list, institution detail, and recent reports.
- 听单: audio-backed reports.
- 我的: guest/login state and shallow personal-state entries.
Key Engineering Principle
The app consumes reviewed display artifacts through the API. Raw NotebookLM artifacts are internal evidence and must not be exposed publicly.
NotebookLM-native content may be cleaned, mapped, reviewed, and assembled deterministically. It must not be silently replaced by local LLM rewriting.
Repository Documentation
README.md: human entry point.AGENTS.md: public agent instructions.docs/DECISIONS.md: durable decisions.docs/DEVELOPMENT_HISTORY.md: major change history.docs/DATA_SOURCE_FLOW.md: end-to-end data source flow, source list with publish frequency, and storage/ingestion path.report-notebooklm-api/docs/: backend, data, API, and content pipeline details.report-notebooklm-app/docs/: App runbook and API consumption notes.