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

3.2 KiB

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

  • 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

  • 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