docs: create roadmap (6 phases)
Phases: 1. Foundation: data model, repository, project structure 2. Core CRUD: entries, quick capture, responsive UI (12 reqs) 3. Images: attachments, camera capture (4 reqs) 4. Tags & Organization: tagging, pin, due dates (7 reqs) 5. Search: full-text, filtering (4 reqs) 6. Deployment: Docker, volumes, config (4 reqs) All 31 v1 requirements mapped to phases.
This commit is contained in:
Thomas Richter
@@ -106,43 +106,43 @@ Which phases cover which requirements. Updated during roadmap creation.
|
||||
|
||||
| Requirement | Phase | Status |
|
||||
|-------------|-------|--------|
|
||||
| CORE-01 | TBD | Pending |
|
||||
| CORE-02 | TBD | Pending |
|
||||
| CORE-03 | TBD | Pending |
|
||||
| CORE-04 | TBD | Pending |
|
||||
| CORE-05 | TBD | Pending |
|
||||
| CORE-06 | TBD | Pending |
|
||||
| IMG-01 | TBD | Pending |
|
||||
| IMG-02 | TBD | Pending |
|
||||
| IMG-03 | TBD | Pending |
|
||||
| IMG-04 | TBD | Pending |
|
||||
| TAG-01 | TBD | Pending |
|
||||
| TAG-02 | TBD | Pending |
|
||||
| TAG-03 | TBD | Pending |
|
||||
| TAG-04 | TBD | Pending |
|
||||
| ORG-01 | TBD | Pending |
|
||||
| ORG-02 | TBD | Pending |
|
||||
| ORG-03 | TBD | Pending |
|
||||
| SRCH-01 | TBD | Pending |
|
||||
| SRCH-02 | TBD | Pending |
|
||||
| SRCH-03 | TBD | Pending |
|
||||
| SRCH-04 | TBD | Pending |
|
||||
| CAPT-01 | TBD | Pending |
|
||||
| CAPT-02 | TBD | Pending |
|
||||
| CAPT-03 | TBD | Pending |
|
||||
| UX-01 | TBD | Pending |
|
||||
| UX-02 | TBD | Pending |
|
||||
| UX-03 | TBD | Pending |
|
||||
| DEPLOY-01 | TBD | Pending |
|
||||
| DEPLOY-02 | TBD | Pending |
|
||||
| DEPLOY-03 | TBD | Pending |
|
||||
| DEPLOY-04 | TBD | Pending |
|
||||
| CORE-01 | Phase 2 | Pending |
|
||||
| CORE-02 | Phase 2 | Pending |
|
||||
| CORE-03 | Phase 2 | Pending |
|
||||
| CORE-04 | Phase 2 | Pending |
|
||||
| CORE-05 | Phase 2 | Pending |
|
||||
| CORE-06 | Phase 2 | Pending |
|
||||
| IMG-01 | Phase 3 | Pending |
|
||||
| IMG-02 | Phase 3 | Pending |
|
||||
| IMG-03 | Phase 3 | Pending |
|
||||
| IMG-04 | Phase 3 | Pending |
|
||||
| TAG-01 | Phase 4 | Pending |
|
||||
| TAG-02 | Phase 4 | Pending |
|
||||
| TAG-03 | Phase 4 | Pending |
|
||||
| TAG-04 | Phase 4 | Pending |
|
||||
| ORG-01 | Phase 4 | Pending |
|
||||
| ORG-02 | Phase 4 | Pending |
|
||||
| ORG-03 | Phase 4 | Pending |
|
||||
| SRCH-01 | Phase 5 | Pending |
|
||||
| SRCH-02 | Phase 5 | Pending |
|
||||
| SRCH-03 | Phase 5 | Pending |
|
||||
| SRCH-04 | Phase 5 | Pending |
|
||||
| CAPT-01 | Phase 2 | Pending |
|
||||
| CAPT-02 | Phase 2 | Pending |
|
||||
| CAPT-03 | Phase 2 | Pending |
|
||||
| UX-01 | Phase 2 | Pending |
|
||||
| UX-02 | Phase 2 | Pending |
|
||||
| UX-03 | Phase 2 | Pending |
|
||||
| DEPLOY-01 | Phase 6 | Pending |
|
||||
| DEPLOY-02 | Phase 6 | Pending |
|
||||
| DEPLOY-03 | Phase 6 | Pending |
|
||||
| DEPLOY-04 | Phase 6 | Pending |
|
||||
|
||||
**Coverage:**
|
||||
- v1 requirements: 31 total
|
||||
- Mapped to phases: 0
|
||||
- Unmapped: 31 (will be mapped during roadmap creation)
|
||||
- Mapped to phases: 31
|
||||
- Unmapped: 0
|
||||
|
||||
---
|
||||
*Requirements defined: 2026-01-29*
|
||||
*Last updated: 2026-01-29 after initial definition*
|
||||
*Last updated: 2026-01-29 after roadmap creation*
|
||||
|
||||
148
.planning/ROADMAP.md
Normal file
148
.planning/ROADMAP.md
Normal file
@@ -0,0 +1,148 @@
|
||||
# Roadmap: TaskPlanner
|
||||
|
||||
## Overview
|
||||
|
||||
TaskPlanner delivers personal task and notes management with image attachments, accessible from any device via web browser. The roadmap progresses from data foundation through core features (entries, images, tags, search) to containerized deployment, with each phase delivering complete, verifiable functionality that enables the next.
|
||||
|
||||
## Phases
|
||||
|
||||
**Phase Numbering:**
|
||||
- Integer phases (1, 2, 3): Planned milestone work
|
||||
- Decimal phases (2.1, 2.2): Urgent insertions (marked with INSERTED)
|
||||
|
||||
Decimal phases appear between their surrounding integers in numeric order.
|
||||
|
||||
- [ ] **Phase 1: Foundation** - Data model, repository layer, and project structure
|
||||
- [ ] **Phase 2: Core CRUD** - Entry management, quick capture, and responsive UI
|
||||
- [ ] **Phase 3: Images** - Image attachments with mobile camera support
|
||||
- [ ] **Phase 4: Tags & Organization** - Tagging system with pinning and due dates
|
||||
- [ ] **Phase 5: Search** - Full-text search and filtering
|
||||
- [ ] **Phase 6: Deployment** - Docker containerization and production configuration
|
||||
|
||||
## Phase Details
|
||||
|
||||
### Phase 1: Foundation
|
||||
**Goal**: Data persistence and project structure are ready for feature development
|
||||
**Depends on**: Nothing (first phase)
|
||||
**Requirements**: None (foundational — enables all other requirements)
|
||||
**Success Criteria** (what must be TRUE):
|
||||
1. SQLite database initializes with schema on first run
|
||||
2. Unified entries table supports both tasks and thoughts via type field
|
||||
3. Repository layer provides typed CRUD operations for entries
|
||||
4. Filesystem storage directory structure exists for future images
|
||||
5. Development server starts and serves a basic page
|
||||
**Plans**: TBD
|
||||
|
||||
Plans:
|
||||
- [ ] 01-01: TBD
|
||||
- [ ] 01-02: TBD
|
||||
- [ ] 01-03: TBD
|
||||
|
||||
### Phase 2: Core CRUD
|
||||
**Goal**: Users can create, manage, and view entries with a responsive, accessible UI
|
||||
**Depends on**: Phase 1
|
||||
**Requirements**: CORE-01, CORE-02, CORE-03, CORE-04, CORE-05, CORE-06, CAPT-01, CAPT-02, CAPT-03, UX-01, UX-02, UX-03
|
||||
**Success Criteria** (what must be TRUE):
|
||||
1. User can create a new entry specifying task or thought type
|
||||
2. User can edit entry title, content, and type
|
||||
3. User can delete an entry with confirmation
|
||||
4. User can mark a task as complete and see visual indicator
|
||||
5. User can add notes to an existing entry
|
||||
6. Quick capture input is visible on main view with one-click submission
|
||||
7. UI is usable on mobile devices with adequate touch targets
|
||||
8. Text is readable for older eyes (minimum 16px base font)
|
||||
**Plans**: TBD
|
||||
|
||||
Plans:
|
||||
- [ ] 02-01: TBD
|
||||
- [ ] 02-02: TBD
|
||||
- [ ] 02-03: TBD
|
||||
- [ ] 02-04: TBD
|
||||
|
||||
### Phase 3: Images
|
||||
**Goal**: Users can attach, view, and manage images on entries from any device
|
||||
**Depends on**: Phase 2
|
||||
**Requirements**: IMG-01, IMG-02, IMG-03, IMG-04
|
||||
**Success Criteria** (what must be TRUE):
|
||||
1. User can attach images via file upload on desktop
|
||||
2. User can attach images via camera capture on mobile
|
||||
3. User can view attached images inline with entry
|
||||
4. User can remove image attachments from an entry
|
||||
5. Images are stored on filesystem (not in database)
|
||||
**Plans**: TBD
|
||||
|
||||
Plans:
|
||||
- [ ] 03-01: TBD
|
||||
- [ ] 03-02: TBD
|
||||
- [ ] 03-03: TBD
|
||||
|
||||
### Phase 4: Tags & Organization
|
||||
**Goal**: Users can organize entries with tags and quick access features
|
||||
**Depends on**: Phase 2
|
||||
**Requirements**: TAG-01, TAG-02, TAG-03, TAG-04, ORG-01, ORG-02, ORG-03
|
||||
**Success Criteria** (what must be TRUE):
|
||||
1. User can add multiple tags to an entry
|
||||
2. User can remove tags from an entry
|
||||
3. Tag input shows autocomplete suggestions from existing tags
|
||||
4. Tags are case-insensitive ("work" matches "Work" and "WORK")
|
||||
5. User can pin/favorite an entry for quick access
|
||||
6. User can set a due date on a task
|
||||
7. Pinned entries appear in a dedicated section at top of list
|
||||
**Plans**: TBD
|
||||
|
||||
Plans:
|
||||
- [ ] 04-01: TBD
|
||||
- [ ] 04-02: TBD
|
||||
- [ ] 04-03: TBD
|
||||
|
||||
### Phase 5: Search
|
||||
**Goal**: Users can find entries through search and filtering
|
||||
**Depends on**: Phase 2, Phase 4 (tags for filtering)
|
||||
**Requirements**: SRCH-01, SRCH-02, SRCH-03, SRCH-04
|
||||
**Success Criteria** (what must be TRUE):
|
||||
1. User can search entries by text in title and content
|
||||
2. User can filter entries by tag (single or multiple)
|
||||
3. User can filter entries by date range
|
||||
4. User can filter to show only tasks or only thoughts
|
||||
5. Search results show relevant matches with highlighting
|
||||
**Plans**: TBD
|
||||
|
||||
Plans:
|
||||
- [ ] 05-01: TBD
|
||||
- [ ] 05-02: TBD
|
||||
- [ ] 05-03: TBD
|
||||
|
||||
### Phase 6: Deployment
|
||||
**Goal**: Application runs in Docker with persistent data and easy configuration
|
||||
**Depends on**: Phase 1-5 (all features complete)
|
||||
**Requirements**: DEPLOY-01, DEPLOY-02, DEPLOY-03, DEPLOY-04
|
||||
**Success Criteria** (what must be TRUE):
|
||||
1. Application runs in a Docker container
|
||||
2. Configuration is provided via environment variables
|
||||
3. Data persists across container restarts via named volumes
|
||||
4. Single docker-compose.yml starts the entire application
|
||||
5. Backup of data directory preserves all entries and images
|
||||
**Plans**: TBD
|
||||
|
||||
Plans:
|
||||
- [ ] 06-01: TBD
|
||||
- [ ] 06-02: TBD
|
||||
|
||||
## Progress
|
||||
|
||||
**Execution Order:**
|
||||
Phases execute in numeric order: 1 -> 2 -> 3 -> 4 -> 5 -> 6
|
||||
|
||||
| Phase | Plans Complete | Status | Completed |
|
||||
|-------|----------------|--------|-----------|
|
||||
| 1. Foundation | 0/3 | Not started | - |
|
||||
| 2. Core CRUD | 0/4 | Not started | - |
|
||||
| 3. Images | 0/3 | Not started | - |
|
||||
| 4. Tags & Organization | 0/3 | Not started | - |
|
||||
| 5. Search | 0/3 | Not started | - |
|
||||
| 6. Deployment | 0/2 | Not started | - |
|
||||
|
||||
---
|
||||
*Roadmap created: 2026-01-29*
|
||||
*Depth: standard (5-8 phases)*
|
||||
*Coverage: 31/31 v1 requirements mapped*
|
||||
62
.planning/STATE.md
Normal file
62
.planning/STATE.md
Normal file
@@ -0,0 +1,62 @@
|
||||
# Project State
|
||||
|
||||
## Project Reference
|
||||
|
||||
See: .planning/PROJECT.md (updated 2026-01-29)
|
||||
|
||||
**Core value:** Capture and find anything from any device — especially laptop. If cross-device capture with images doesn't work, nothing else matters.
|
||||
**Current focus:** Phase 1 - Foundation
|
||||
|
||||
## Current Position
|
||||
|
||||
Phase: 1 of 6 (Foundation)
|
||||
Plan: 0 of 3 in current phase
|
||||
Status: Ready to plan
|
||||
Last activity: 2026-01-29 — Roadmap created
|
||||
|
||||
Progress: [░░░░░░░░░░] 0%
|
||||
|
||||
## Performance Metrics
|
||||
|
||||
**Velocity:**
|
||||
- Total plans completed: 0
|
||||
- Average duration: -
|
||||
- Total execution time: 0 hours
|
||||
|
||||
**By Phase:**
|
||||
|
||||
| Phase | Plans | Total | Avg/Plan |
|
||||
|-------|-------|-------|----------|
|
||||
| - | - | - | - |
|
||||
|
||||
**Recent Trend:**
|
||||
- Last 5 plans: -
|
||||
- Trend: -
|
||||
|
||||
*Updated after each plan completion*
|
||||
|
||||
## Accumulated Context
|
||||
|
||||
### Decisions
|
||||
|
||||
Decisions are logged in PROJECT.md Key Decisions table.
|
||||
Recent decisions affecting current work:
|
||||
|
||||
- None yet (project just initialized)
|
||||
|
||||
### Pending Todos
|
||||
|
||||
None yet.
|
||||
|
||||
### Blockers/Concerns
|
||||
|
||||
None yet.
|
||||
|
||||
## Session Continuity
|
||||
|
||||
Last session: 2026-01-29
|
||||
Stopped at: Roadmap created, ready for Phase 1 planning
|
||||
Resume file: None
|
||||
|
||||
---
|
||||
*State initialized: 2026-01-29*
|
||||
Reference in New Issue
Block a user