mARTin-B78/My-Weekly-ToDo-List
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: create roadmap (4 phases)

Browse Source 
Phases:
1. Setup & Authentication: AUTH and UI requirements
2. Task Management and Weekly View: TASK and WEEK requirements
3. Calendar Integration: CAL requirements
4. Final Polish: UI enhancements and refinement

All v1 requirements mapped to phases.
This commit is contained in:
mARTin 2026-01-24 18:33:04 +01:00
parent 3a41bb2345
commit 0db2f48fd8
2 changed files with 75 additions and 117 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

155
.planning/ROADMAP.md
View File

@ -1,125 +1,80 @@
# Weekly ToDo List Roadmap # My Weekly To Do List - Roadmap
## Overview ## Overview
This roadmap delivers a weekly scheduler with calendar integration in five phases. It follows a goal-backward approach where each phase defines what must be TRUE for users when completion occurs. The phases are structured around key user workflows: viewing and managing tasks, enhancing user experience, integrating with external calendars, and enabling data management.
This roadmap delivers the My Weekly To Do List application in four phases, starting with core functionality and building toward a complete, polished experience. Each phase delivers a coherent set of capabilities that users can verify and use incrementally.
## Phases ## Phases
### Phase 1: Setup & Foundation ### Phase 1: Setup & Authentication
**Goal:** Project is initialized with core dependencies and basic weekly view functionality is established. **Goal:** Users can securely access the application and manage their account
**Plans:** 2 plans
**Plans:**
- [x] 01-01-PLAN.md — Setup project structure and core dependencies
- [x] 01-02-PLAN.md — Create foundational components and data persistence
**Requirements:** **Requirements:**
- CORE-01: User can view tasks and events in a weekly calendar view - AUTH-01: User can sign up with email and password
- CORE-02: User can add tasks to specific days within the weekly view - AUTH-02: User receives email verification after signup
- CORE-03: User can edit existing tasks (change title, date, description) - AUTH-03: User can reset password via email link
- CORE-04: User can delete tasks from the weekly view - AUTH-04: User session persists across browser refresh
- CORE-05: User can mark tasks as complete/incomplete - UI-01: Clean, minimal interface similar to TeuxDeux
- CORE-06: User can navigate between weeks using previous/next buttons - UI-02: Responsive design that works on desktop and tablet
- CORE-07: User can switch between day and week views - UI-03: Intuitive controls for task management
- CORE-08: User can drag and drop tasks between days to reorganize them
- CORE-09: User can persist tasks locally in the browser
**Success Criteria:** **Success Criteria:**
1. User can view a weekly calendar grid showing tasks organized by day 1. User can create an account with email/password
2. User can add new tasks by clicking on specific days in the weekly view 2. User receives and can verify email address after signup
3. User can edit task details including title, date, and description 3. User can reset password via email link
4. User can delete tasks from the weekly view 4. User stays logged in across browser sessions
5. User can mark tasks as complete or incomplete with visual indicators 5. Application interface loads and displays correctly on desktop and tablet devices
6. User can navigate between weeks using previous/next buttons 6. User can navigate core UI elements intuitively
7. User can switch between day and week views to see different perspectives
8. User can drag and drop tasks between days to reorganize them
9. User's tasks persist between browser sessions using local storage
### Phase 2: User Experience & Advanced Features ### Phase 2: Task Management and Weekly View
**Goal:** Provide an intuitive and polished user experience with advanced task management features. **Goal:** Users can create, manage, and visualize their tasks in a weekly calendar view
**Plans:** 2 plans
**Plans:**
- [x] 02-01-PLAN.md — Enhance User Experience with Advanced Features
- [x] 02-02-PLAN.md — Improve User Interface and Add Advanced Features
**Requirements:** **Requirements:**
- UX-01: Application has a clean, minimalist interface similar to TeuxDeux - TASK-01: User can create tasks with title and description
- UX-02: Application is responsive and works well on desktop and tablet - TASK-02: User can edit existing tasks
- UX-03: Tasks are visually distinct from calendar events - TASK-03: User can delete tasks
- UX-04: Intuitive workflow for adding and editing tasks - TASK-04: User can mark tasks as complete/incomplete
- UX-05: Clear visual indication of completed tasks - TASK-05: User can view tasks in a weekly grid view
- ADV-01: User can create recurring tasks (daily, weekly, monthly) - WEEK-01: User can navigate between weeks
- ADV-02: User can assign categories/tags to tasks - WEEK-02: User can view tasks and calendar events in a unified weekly view
- ADV-03: User can set reminders for specific tasks - WEEK-03: User can drag and drop tasks between days of the week
- ADV-04: User can prioritize tasks (high, medium, low) - WEEK-04: User can see time allocation clearly with visual indicators
- ADV-05: User can add descriptions and notes to tasks
**Success Criteria:** **Success Criteria:**
1. Application has a clean, minimalist interface that is easy to use 1. User can create new tasks with title and description
2. Application is responsive and works well on desktop and tablet devices 2. User can edit existing tasks with updated information
3. Tasks are clearly distinguishable from calendar events in the UI 3. User can delete tasks from their list
4. Adding and editing tasks follows an intuitive workflow with minimal steps 4. User can mark tasks as complete or incomplete
5. Completed tasks are visually marked in a clear way (e.g., strikethrough, different color) 5. User can view tasks organized in a weekly grid layout
6. User can create recurring tasks that repeat daily, weekly, or monthly 6. User can navigate between different weeks in the calendar
7. User can assign categories or tags to organize tasks 7. User can drag tasks between different days of the week
8. User can set reminders for specific tasks to be notified before due time 8. User can clearly see how time is allocated across days with visual cues
9. User can prioritize tasks using high, medium, or low priority levels
10. User can add detailed descriptions and notes to tasks
### Phase 3: Calendar Integration ### Phase 3: Calendar Integration
**Goal:** Enable connection to external calendar services and display calendar events alongside user tasks. **Goal:** Users can connect external calendar accounts and synchronize data
**Plans:** 3 plans
**Plans:**
- [ ] 03-01-PLAN.md — Implement calendar event integration for Google and Apple Calendar
- [ ] 03-02-PLAN.md — Implement calendar event filtering and detail viewing
- [ ] 03-03-PLAN.md — Implement visual styling for calendar events
**Requirements:** **Requirements:**
- CAL-01: User can connect their Google Calendar account to the application - CAL-01: User can connect their Google Calendar account
- CAL-02: User can connect their Apple Calendar account to the application - CAL-02: User can connect their Apple Calendar account
- CAL-03: Connected calendar events appear alongside user tasks in the weekly view - CAL-03: User can view calendar events alongside tasks in weekly view
- CAL-04: User can view details of calendar events in the weekly view - CAL-04: User can synchronize tasks and calendar events bidirectionally
- CAL-05: User can filter to show/hide calendar events in the view
**Success Criteria:** **Success Criteria:**
1. User can connect their Google Calendar account through a secure authorization flow 1. User can connect their Google Calendar account through OAuth
2. User can connect their Apple Calendar account through a secure authorization flow 2. User can connect their Apple Calendar account through OAuth
3. Events from connected calendars appear in the weekly view alongside user tasks 3. User can see calendar events displayed alongside tasks in the weekly view
4. User can view event details when selecting calendar events in the view 4. User's tasks and calendar events are synchronized bidirectionally between the app and connected calendars
5. User can toggle visibility of calendar events on/off in the weekly view 5. User can manage calendar connection settings from the application
### Phase 4: Calendar Management & Data Export ### Phase 4: Final Polish
**Goal:** Allow users to create, edit, and delete calendar events, plus enable data export/import capabilities. **Goal:** Enhanced user experience and refined functionality
**Requirements:** **Requirements:**
- CAL-06: User can create new calendar events directly from the application - (No specific requirements for this phase, though all previous requirements are completed)
- CAL-07: User can edit existing calendar events from the application
- CAL-08: User can delete calendar events from the application
- CAL-09: User can set reminders for calendar events
- DATA-01: User can export tasks to a CSV or JSON file
- DATA-02: User can import tasks from a CSV or JSON file
- DATA-03: User can backup their data manually
- DATA-04: User can restore their data from a backup
**Success Criteria:** **Success Criteria:**
1. User can create new calendar events directly from the application interface 1. All application features function consistently and reliably
2. User can edit existing calendar events with details such as title, date, and description 2. User interface is polished and responsive across all device sizes
3. User can delete calendar events from the application 3. Application performs well under typical usage scenarios
4. User can set reminders for calendar events 4. All user flows are intuitive and well-tested
5. User can export their tasks to CSV or JSON formats 5. Accessibility standards are met for core functionality
6. User can import tasks from CSV or JSON files
7. User can manually backup their data to an external location
8. User can restore their data from a previously created backup
## Progress
| Phase | Goal | Status |
|-------|------|--------|
| 1 | Setup & Foundation | Complete |
| 2 | User Experience & Advanced Features | Complete |
| 3 | Calendar Integration | Not Started |
| 4 | Calendar Management & Data Export | Not Started |

37
.planning/STATE.md
View File

@ -3,28 +3,31 @@
## Project Reference ## Project Reference
**Core Value:** Provide users with a streamlined, unified view of their weekly tasks and calendar events that is faster and easier to use than traditional to-do list and calendar applications combined. **Core Value:** Provide users with a streamlined, unified view of their weekly tasks and calendar events that is faster and easier to use than traditional to-do list and calendar applications combined.
**Current Focus:** Building a web-based weekly scheduler with calendar integration **Current Focus:** Building a web-based weekly task management application with calendar integration
## Current Position ## Current Position
**Phase:** 2 **Phase:** Setup & Authentication (Phase 1)
**Plan:** 2 plans **Plan:** Begin with foundational setup and authentication
**Status:** Complete **Status:** Roadmap planned, awaiting execution
**Progress:** 25%
## Performance Metrics ## Performance Metrics
- Requirements coverage: 100% - [x] Requirements defined and categorized (18 total)
- Phases defined: 4 - [x] Roadmap structure finalized with 4 phases
- Dependencies identified: Yes - [x] 100% requirement coverage confirmed
- [ ] Implementation progress (will update during execution)
## Accumulated Context ## Accumulated Context
- Project is a weekly scheduler similar to TeuxDeux and Tweek.so - Core value proposition centered on unified weekly view of tasks and calendar events
- Target platform: Web-based application - Architecture research suggests React/Node.js/PostgreSQL stack with layered approach
- Timeline: MVP within 3 weeks - Key differentiator is combined task/calendar view with drag-and-drop functionality
- Budget: Free/open-source approach - MVP includes: weekly view, task CRUD, calendar integration, responsive UI
- Core functionality: Weekly view of tasks and calendar events - Out of scope: mobile app, team features, offline mode, complex reporting
- Advanced features: Recurring tasks, categories, reminders, theme customization
- Calendar integration: Google Calendar and Apple Calendar
- Data export/import: CSV and JSON formats
## Session Continuity ## Session Continuity
Phase 2 (User Experience & Advanced Features) has been completed with all plans executed. This is the initial planning phase. The roadmap has been established with four clear phases:
1. Setup & Authentication (UI, AUTH requirements)
2. Task Management and Weekly View (TASK, WEEK requirements)
3. Calendar Integration (CAL requirements)
4. Final Polish (UI enhancements and refinement)
Next steps are to begin planning Phase 1 implementation details.