docs(data): document MongoDB non-sync boundary
This commit is contained in:
parent
b0e790f8a6
commit
c0b06b0caa
5 changed files with 37 additions and 9 deletions
|
|
@ -1,6 +1,6 @@
|
||||||
# V1 Block 09 — Persistence Preparation
|
# V1 Block 09 — Persistence Preparation
|
||||||
|
|
||||||
Status: In progress — Chunks 9.1, 9.2, and 9.3 complete
|
Status: Complete
|
||||||
|
|
||||||
Purpose: Prepare the domain layer for future MongoDB-backed persistence without adding a MongoDB driver, network behavior, sync behavior, or database runtime dependency too early.
|
Purpose: Prepare the domain layer for future MongoDB-backed persistence without adding a MongoDB driver, network behavior, sync behavior, or database runtime dependency too early.
|
||||||
|
|
||||||
|
|
@ -170,6 +170,12 @@ Acceptance criteria:
|
||||||
- Docs distinguish MongoDB persistence preparation from actual sync or database adapter implementation.
|
- Docs distinguish MongoDB persistence preparation from actual sync or database adapter implementation.
|
||||||
- Wishlist/future notes contain sync as a later feature, not a V1 requirement.
|
- Wishlist/future notes contain sync as a later feature, not a V1 requirement.
|
||||||
|
|
||||||
|
Completed:
|
||||||
|
|
||||||
|
- Updated root README to state MongoDB is the committed persistence target while V1 remains adapter-free and runtime-database-free.
|
||||||
|
- Updated architecture notes to distinguish MongoDB preparation from MongoDB adapter implementation, sync, accounts, Atlas setup, local server requirements, and background services.
|
||||||
|
- Documented sync and actual MongoDB runtime setup as future work, not V1 requirements.
|
||||||
|
|
||||||
Commit suggestion:
|
Commit suggestion:
|
||||||
|
|
||||||
```text
|
```text
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
# V1 Block 09 — Persistence Preparation
|
# V1 Block 09 — Persistence Preparation
|
||||||
|
|
||||||
Status: In progress — Chunks 9.1, 9.2, and 9.3 complete
|
Status: Complete
|
||||||
|
|
||||||
Purpose: Prepare the domain layer for future MongoDB-backed persistence without adding a MongoDB driver, network behavior, sync behavior, or database runtime dependency too early.
|
Purpose: Prepare the domain layer for future MongoDB-backed persistence without adding a MongoDB driver, network behavior, sync behavior, or database runtime dependency too early.
|
||||||
|
|
||||||
|
|
@ -170,6 +170,12 @@ Acceptance criteria:
|
||||||
- Docs distinguish MongoDB persistence preparation from actual sync or database adapter implementation.
|
- Docs distinguish MongoDB persistence preparation from actual sync or database adapter implementation.
|
||||||
- Wishlist/future notes contain sync as a later feature, not a V1 requirement.
|
- Wishlist/future notes contain sync as a later feature, not a V1 requirement.
|
||||||
|
|
||||||
|
Completed:
|
||||||
|
|
||||||
|
- Updated root README to state MongoDB is the committed persistence target while V1 remains adapter-free and runtime-database-free.
|
||||||
|
- Updated architecture notes to distinguish MongoDB preparation from MongoDB adapter implementation, sync, accounts, Atlas setup, local server requirements, and background services.
|
||||||
|
- Documented sync and actual MongoDB runtime setup as future work, not V1 requirements.
|
||||||
|
|
||||||
Commit suggestion:
|
Commit suggestion:
|
||||||
|
|
||||||
```text
|
```text
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
# Current Software Plan
|
# Current Software Plan
|
||||||
|
|
||||||
Execute active V1 block documents in numeric order. Blocks 01-08 are completed
|
Execute active V1 block documents in numeric order. Blocks 01-09 are completed
|
||||||
and archived; the next active block is Block 09.
|
and archived; the next active block is Block 10.
|
||||||
|
|
||||||
## Execution rules
|
## Execution rules
|
||||||
|
|
||||||
|
|
@ -34,5 +34,5 @@ Do not infer a new level name.
|
||||||
6. `V1_BLOCK_06_Task_Actions_State_Transitions_UPDATED.md` — archived
|
6. `V1_BLOCK_06_Task_Actions_State_Transitions_UPDATED.md` — archived
|
||||||
7. `V1_BLOCK_07_Child_Tasks.md` — archived
|
7. `V1_BLOCK_07_Child_Tasks.md` — archived
|
||||||
8. `V1_BLOCK_08_Today_Timeline_State.md` — archived
|
8. `V1_BLOCK_08_Today_Timeline_State.md` — archived
|
||||||
9. `V1_BLOCK_09_Persistence_Preparation.md`
|
9. `V1_BLOCK_09_Persistence_Preparation.md` — archived
|
||||||
10. `V1_BLOCK_10_Testing_Documentation_Handoff.md`
|
10. `V1_BLOCK_10_Testing_Documentation_Handoff.md`
|
||||||
|
|
|
||||||
|
|
@ -57,5 +57,16 @@ remain persistence-independent and testable without a running database. Reposito
|
||||||
interfaces should be designed so a later MongoDB adapter can persist document-shaped
|
interfaces should be designed so a later MongoDB adapter can persist document-shaped
|
||||||
models without importing MongoDB APIs into scheduling logic.
|
models without importing MongoDB APIs into scheduling logic.
|
||||||
|
|
||||||
|
Current V1 persistence preparation includes pure Dart repository interfaces,
|
||||||
|
in-memory fakes for tests, UTC DateTime conventions, stable enum names, and
|
||||||
|
MongoDB-friendly document-shaped map helpers. It does not include a MongoDB
|
||||||
|
driver, adapter implementation, connection string, Atlas/cloud setup, local
|
||||||
|
MongoDB server requirement, user accounts, network sync, background sync, or
|
||||||
|
mobile background reconciliation.
|
||||||
|
|
||||||
|
Sync remains future work and should only be added if an active plan explicitly
|
||||||
|
asks for it. The core should continue to operate in-memory for tests and local
|
||||||
|
domain behavior until a later MongoDB adapter plan is approved.
|
||||||
|
|
||||||
Do not add alternative database assumptions to this project unless
|
Do not add alternative database assumptions to this project unless
|
||||||
the product owner explicitly changes the persistence decision.
|
the product owner explicitly changes the persistence decision.
|
||||||
|
|
|
||||||
13
README.md
13
README.md
|
|
@ -8,8 +8,12 @@ The repository intentionally starts with a **pure Dart scheduling core** before
|
||||||
|
|
||||||
- V1/MVP: Today view, backlog/wishlist, quick capture, flexible task pushing, recurring hidden locked blocks, task-state transitions, and a testable scheduling core.
|
- V1/MVP: Today view, backlog/wishlist, quick capture, flexible task pushing, recurring hidden locked blocks, task-state transitions, and a testable scheduling core.
|
||||||
- V2.0: Week/month views, reports, overwhelm shield, drag-and-drop, task history panels.
|
- V2.0: Week/month views, reports, overwhelm shield, drag-and-drop, task history panels.
|
||||||
- Persistence direction: MongoDB is the committed database target, but the current core remains database-independent until the active plan adds a MongoDB adapter.
|
- Persistence direction: MongoDB is the committed database target. Current V1
|
||||||
- Wishlist/future: Dependencies, context tags, advanced sync, long-running task behavior decisions.
|
work prepares repository interfaces and document-shaped mappings only; it does
|
||||||
|
not add a MongoDB adapter, connection string, Atlas setup, local server
|
||||||
|
requirement, accounts, sync, or background service.
|
||||||
|
- Wishlist/future: Dependencies, context tags, advanced sync, actual MongoDB
|
||||||
|
adapter/runtime setup, long-running task behavior decisions.
|
||||||
|
|
||||||
## Repository layout
|
## Repository layout
|
||||||
|
|
||||||
|
|
@ -40,8 +44,9 @@ The repository intentionally starts with a **pure Dart scheduling core** before
|
||||||
|
|
||||||
Install a Dart SDK that satisfies `pubspec.yaml` first. This starter is a pure
|
Install a Dart SDK that satisfies `pubspec.yaml` first. This starter is a pure
|
||||||
Dart package, so Flutter is not required for the current core/test loop. MongoDB
|
Dart package, so Flutter is not required for the current core/test loop. MongoDB
|
||||||
is the planned persistence target, but no database service is required for the
|
is the planned persistence target, but no MongoDB service, Atlas account,
|
||||||
current in-memory domain/test loop.
|
connection string, network access, or sync/background process is required for
|
||||||
|
the current in-memory domain/test loop.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
dart pub get
|
dart pub get
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue