chore: prepare yanting monorepo handoff

docs/PROJECT_MAP.md

@@ -0,0 +1,75 @@
+# App Project Map
+
+This is a handoff snapshot, not the product SSOT.
+
+Product SSOT: mall-docs report-notebooklm docs, snapshot date: 2026-06-03.
+
+## Entry Points
+
+| Path | Purpose |
+|---|---|
+| `lib/main.dart` | Creates `RnbApiDataSource` and starts the App. |
+| `lib/app.dart` | Defines `MaterialApp`, app title, theme, and shell page. |
+| `lib/features/shell_page.dart` | Owns bottom navigation and mini-player state. |
+
+## Data Layer
+
+| Path | Purpose |
+|---|---|
+| `lib/data/api/report_data_source.dart` | API client interface and HTTP implementation. |
+| `lib/data/models/models.dart` | Data models, JSON parsing helpers, and formatting helpers. |
+
+The data source currently performs GET requests only. Mutating APIs for auth, favorites, playback progress, and outbound events are not implemented.
+
+## Feature Pages
+
+| Path | Purpose |
+|---|---|
+| `lib/features/feed/feed_page.dart` | Recommended feed. |
+| `lib/features/reports/reports_page.dart` | Report list and simple filters. |
+| `lib/features/institutions/institutions_page.dart` | Institution list. |
+| `lib/features/institutions/institution_detail_page.dart` | Institution detail and recent reports. |
+| `lib/features/listen/listen_page.dart` | Listen list. |
+| `lib/features/profile/profile_page.dart` | Guest/login placeholder and personal-state entries. |
+| `lib/features/detail/report_detail_page.dart` | Report detail shell and source/compliance display. |
+| `lib/features/detail/modules/renderer_registry.dart` | Module card rendering and module detail page rendering. |
+| `lib/features/shared/report_card_widget.dart` | Shared report card. |
+
+## Shared UI
+
+| Path | Purpose |
+|---|---|
+| `lib/widgets/app_buttons.dart` | Buttons. |
+| `lib/widgets/app_card.dart` | Cards. |
+| `lib/widgets/badges.dart` | Badges and chips. |
+| `lib/widgets/mini_player.dart` | Mini-player and placeholder player UI. |
+| `lib/widgets/sheets.dart` | Login/outbound sheets and toasts. |
+| `lib/widgets/states.dart` | Loading, skeleton, empty, and error states. |
+| `lib/theme/app_theme.dart` | Flutter `ThemeData`. |
+| `lib/theme/wise_tokens.dart` | Color, spacing, radius, motion, and shadow tokens. |
+
+## Platform
+
+| Path | Purpose |
+|---|---|
+| `android/` | Android scaffold. |
+| `android/app/src/debug/AndroidManifest.xml` | Debug-only cleartext allowance. |
+| `android/app/src/main/AndroidManifest.xml` | Main manifest; release should remain HTTPS-only. |
+| `web/` | Flutter web scaffold. |
+
+## Tests
+
+| Path | Purpose |
+|---|---|
+| `test/widget_test.dart` | Smoke widget test with fake data source. |
+
+## Generated or Local Files
+
+Do not commit:
+
+- `build/`
+- `.dart_tool/`
+- APKs
+- screenshots
+- local IDE caches
+- local environment files