xtablo-source/.planning/REQUIREMENTS.md
2026-05-18 16:04:22 +02:00

82 lines
3.2 KiB
Markdown

# Requirements: Xtablo — Go + HTMX Product
**Defined:** 2026-05-17
**Core Value:** A user can sign in and run the Tablos workflow — organize work, attach files, discuss, and plan scheduled events — without a JS framework or managed chat provider.
## v4.0 Requirements — Figma Design Parity
Requirements for v4.0. Each maps to roadmap phases.
### Navigation & Shell
- [ ] **NAV-01**: User sees a redesigned sidebar/nav bar matching Figma (brand section, icon nav items, tablo list section, user footer)
- [ ] **NAV-02**: User sees a per-page top header bar with page title and contextual action buttons matching Figma
### Tablo List
- [ ] **LIST-01**: Tablo project cards are revamped to match Figma with updated layout, typography, and progress bar wired to real task completion percentage
- [ ] **LIST-02**: User can toggle between card grid view and list view on the tablos page
- [ ] **LIST-03**: Tablos have an active/archived status field stored in DB, visible as a UI indicator on cards and list rows
### Tasks
- [x] **TASK-01**: Kanban board columns, task cards, and drag-and-drop are restyled to match Figma
- [ ] **TASK-02**: User can switch to a grid/table view of tasks within a tablo (new view — data model + UI)
- [ ] **TASK-03**: User can switch to a roadmap/timeline view of tasks within a tablo (new view — requires due date fields added to tasks schema)
### Calendar (Planning)
- [ ] **CAL-01**: User can view their planning in a month/week/day calendar grid, replacing the current flat agenda list
- [ ] **CAL-02**: Events render as colored blocks inside calendar cells (not just text list items)
- [ ] **CAL-03**: User can filter calendar events by tablo
### Tablo Detail
- [x] **DETAIL-01**: Tablo detail page (header, tasks section, etapes section, files table) is restyled to match Figma
## v5.0 Candidates (Deferred)
### Polish & Accessibility
- **RESP-01**: Responsive layout — sidebar collapses on small screens, kanban scrolls horizontally on mobile
- **DARK-01**: Dark mode — CSS token `prefers-color-scheme` counterparts or class-toggle variant
## Out of Scope
| Feature | Reason |
|---------|--------|
| Apple sign-in | Disabled in v2.0; remains out of scope |
| Stripe / billing | Deferred until product loop validated |
| Public booking widget | Deferred to a later milestone |
| Client portal | Deferred |
| Admin app | Deferred |
| Mobile / Expo app | Out of scope for this rewrite |
| Notes / rich documents | Not part of this milestone |
## Traceability
Which phases cover which requirements. Updated during roadmap creation.
| Requirement | Phase | Status |
|-------------|-------|--------|
| NAV-01 | Phase 18 | Pending |
| NAV-02 | Phase 18 | Pending |
| LIST-01 | Phase 19 | Pending |
| LIST-02 | Phase 19 | Pending |
| LIST-03 | Phase 19 | Pending |
| TASK-01 | Phase 20 | Complete |
| DETAIL-01 | Phase 20 | Complete |
| TASK-02 | Phase 21 | Pending |
| TASK-03 | Phase 21 | Pending |
| CAL-01 | Phase 22 | Pending |
| CAL-02 | Phase 22 | Pending |
| CAL-03 | Phase 22 | Pending |
**Coverage:**
- v4.0 requirements: 12 total
- Mapped to phases: 12
- Unmapped: 0 ✓
---
*Requirements defined: 2026-05-17*
*Last updated: 2026-05-17 after initial definition*