chore: prepare yanting monorepo handoff

2026-06-03 10:39:03 +09:00
commit fde51468c6
106 changed files with 8171 additions and 0 deletions
@@ -0,0 +1,71 @@
+# Project Brief Snapshot
+
+This is a handoff snapshot, not the product SSOT.
+
+Product SSOT: mall-docs report-notebooklm docs, snapshot date: 2026-06-03.
+
+## Product
+
+`研听` is a Chinese research-report interpretation app for users who want to understand global institutional research with lower language and time barriers. It turns hard-to-read English research reports into structured Chinese reading and listening experiences.
+
+Technical identifiers remain `report-notebooklm` and `rnb`. Do not use the product display name in code identifiers, database schema names, Redis keys, object storage paths, or API prefixes.
+
+## Phase 1 Goals
+
+- Validate whether Chinese users will repeatedly consume global institutional research-report interpretations.
+- Ship a complete first app experience for discovery, reading, listening, saving, and returning to reports.
+- Establish a minimum loop from report sources to selection, NotebookLM-assisted interpretation, review, storage, API distribution, and app display.
+- Keep source attribution and compliance clear: this is report interpretation and annotation, not investment advice.
+- Keep the commercial app independent from any local-only Vision runtime.
+
+## Target Users
+
+- General Chinese users interested in macro, precious metals, commodities, energy, central banks, and cross-asset research.
+- Light professional users who want overseas institutional views and original-source traceability, without trading advice.
+- Commuting or fragmented-time users who want reports transformed into listenable content.
+
+Non-target users: professional terminal users, real-time trading-signal users, UGC/community users, and users expecting original investment recommendations.
+
+## Main Tabs
+
+| Tab | Phase 1 scope | Explicitly out of scope |
+|---|---|---|
+| 推荐 | Latest and curated report interpretations. | Ads, hard trading CTAs, real-time news flashes. |
+| 研报 | All published report interpretations with basic filters. | Advanced investment terminal search. |
+| 机构 | Institution list and institution report entry points. | Commercial institution ranking or onboarding backend. |
+| 听单 | Reports that have audio form. | User-created podcasts, downloads, offline packages. |
+| 我的 | Guest/login state, favorites, history, saved listening entry points. | Comments, UGC, paid membership, points. |
+
+## Phase 1 Must Do
+
+- Public browsing for recommended reports, report list, institutions, and listen list.
+- Report detail pages with title, institution, publication/release data, source type, topics, summary, structured modules, source/compliance information, and favorite entry.
+- Guest users can browse public content and fully listen to at least one episode.
+- Logged-in users can synchronize favorites, reading history, saved listens, and playback progress.
+- Published app responses must expose only reviewed display artifacts, not raw NotebookLM artifacts.
+- Every report detail must preserve source attribution and risk disclaimer wording.
+
+## Phase 1 Must Not Do
+
+- No commercialization: no ads, paid unlock, membership, task wall, or points.
+- No comments, community, UGC, or user-generated report interpretations.
+- No investment advice, trading signals, buy/sell points, return promises, or portfolio recommendations.
+- No original financial news, real-time reporting, or commentary positioned as original market views.
+- No in-product downloads for interpretation content, audio packages, or PDFs.
+- No long-term production dependency on a local Vision runtime, local SQLite, local scripts, local paths, or local account state.
+- No App or server-side LLM rewriting of NotebookLM-native content into unsupported original copy.
+
+## Compliance Boundary
+
+- Positioning: research-report interpretation and annotation service.
+- Content: Chinese interpretation of public or authorized institutional reports.
+- Detail pages, agreements, and store metadata must state that content is not investment advice.
+- Each item must show institution, source, publication time, and interpretation/source labels.
+- Gray broker sources require special handling and human review before public release.
+- Phase 1 does not open user content surfaces.
+
+## Vision Decoupling
+
+Vision source experience can be reused as reference material: source lists, source tiers, source-health lessons, NotebookLM experience, and prior pitfalls.
+
+The app must not depend on local Vision runtime state in production. Any short-term Vision consumption must be read-only transition input, must not write back to Vision, and must not leak local file paths into production data.