docs(roadmap): annotate architecture checkpoints

This commit is contained in:
saravanakumardb1 2026-03-10 12:11:34 -07:00
parent 8580ad3fc6
commit a6f614f43a
3 changed files with 33 additions and 10 deletions

View File

@ -594,6 +594,9 @@ Make `shared/product.json` the real source of truth across all surfaces.
- auth storage prefixes are consistent
- telemetry/diagnostics identify the same product everywhere
### Checkpoint
- Completed in [`b73d5e9`](https://github.com/saravanakumardb1/learning_ai_notes/commit/b73d5e9)
## Phase B — Remove Placeholder Local Platform Wrappers
### Goal
@ -610,6 +613,9 @@ Delete local wrappers that do not add product-specific value.
- no no-op telemetry wrapper
- all remaining wrapper files have clear product-specific justification
### Checkpoint
- mobile placeholder-wrapper cleanup completed in [`86e2da8`](https://github.com/saravanakumardb1/learning_ai_notes/commit/86e2da8)
## Phase C — Real Backend Integration for Web and Mobile
### Goal
@ -627,6 +633,9 @@ Stop using local mock/fallback data as a primary runtime path.
- mobile note list/detail/workspaces use real APIs
- fallback data is no longer the normal runtime path
### Checkpoint
- mobile runtime-alignment slice completed in [`8580ad3`](https://github.com/saravanakumardb1/learning_ai_notes/commit/8580ad3)
## Phase D — Shared Platform Service Completion
### Goal

View File

@ -36,6 +36,9 @@ This roadmap tracks the execution work required to bring `learning_ai_notes` int
# Phase R0 — Identity and Boundary Lock
Checkpoint:
- Phase A completed in [`b73d5e9`](https://github.com/saravanakumardb1/learning_ai_notes/commit/b73d5e9)
- [x] Confirm `shared/product.json` is the canonical product identity source
- [x] Align web product identity defaults with `shared/product.json`
- [x] Align mobile product identity defaults with `shared/product.json`
@ -46,17 +49,23 @@ This roadmap tracks the execution work required to bring `learning_ai_notes` int
# Phase R1 — Placeholder and Duplication Cleanup
Checkpoint:
- Phase B mobile placeholder-wrapper cleanup in [`86e2da8`](https://github.com/saravanakumardb1/learning_ai_notes/commit/86e2da8)
- [ ] Inventory all repo-local platform/config/wrapper files
- [ ] Delete or replace wrapper files that are no-op or fake readiness scaffolds
- [x] Delete or replace wrapper files that are no-op or fake readiness scaffolds
- [ ] Remove duplicated raw product identity literals
- [ ] Remove long-term runtime dependence on route-level mock/fallback datasets
- [ ] Reduce duplicate DTO definitions where they describe the same backend object
# Phase R2 — Runtime Integration Alignment
Checkpoint:
- Mobile runtime alignment checkpoint in [`8580ad3`](https://github.com/saravanakumardb1/learning_ai_notes/commit/8580ad3)
- [ ] Web notes/workspaces/search/reviews use real product-backend clients
- [ ] Mobile notes/workspaces/detail flows use real product-backend clients
- [ ] Mobile editing persists to the backend instead of local-only state
- [x] Mobile notes/workspaces/detail flows use real product-backend clients
- [x] Mobile editing persists to the backend instead of local-only state
- [ ] Artifact flows use shared blob-backed integration
- [ ] Extraction-backed enrichment uses shared extraction service

View File

@ -38,17 +38,22 @@ Make the React Native / Expo MVP follow the ByteLyst reuse-first path more stric
# Phase M2 — Remove Placeholder Local Wrappers
- [ ] Delete or replace `mobile/src/lib/platform.ts`
- [ ] Delete or replace `mobile/src/lib/telemetry.ts`
- [ ] Audit other local helper files for no-op or placeholder behavior
Checkpoint:
- Placeholder wrapper cleanup completed in [`86e2da8`](https://github.com/saravanakumardb1/learning_ai_notes/commit/86e2da8)
- [x] Delete or replace `mobile/src/lib/platform.ts`
- [x] Delete or replace `mobile/src/lib/telemetry.ts`
- [x] Audit other local helper files for no-op or placeholder behavior
- [ ] Keep only thin product-specific composition helpers that add real value
# Phase M3 — Replace Fallback Runtime Paths
- [ ] Replace fallback notes as the primary runtime path
- [ ] Replace inline workspace returns with real API calls
- [ ] Persist note edits to the backend
- [ ] Align mobile note detail with real backend fields
Checkpoint:
- Mobile backend-backed runtime alignment completed in [`8580ad3`](https://github.com/saravanakumardb1/learning_ai_notes/commit/8580ad3)
- [x] Replace fallback notes as the primary runtime path
- [x] Replace inline workspace returns with real API calls
- [x] Persist note edits to the backend
- [x] Align mobile note detail with real backend fields
- [ ] Ensure approval/activity flows use real backend-backed data where intended
# Phase M4 — Shared Platform Completion