Projects App - Features & Capabilities Report

Template Version: 1.0.0 Generated: 2026-01-22 Package: @epicdm/flowstate-app-projects App ID: projects

Table of Contents

1. Overview
2. App Identity
3. Feature Categories
4. Capabilities
5. Data Models
6. User Workflows
7. Integration Points
8. Commands & Keybindings
9. Architecture Summary
10. Quality & Compliance

Overview

Purpose

The Projects App is the core project and task management application for FlowState. It provides comprehensive project lifecycle management, hierarchical task organization with milestones, time tracking, document management with approval workflows, team discussions, calendar scheduling, and personal productivity features through the My Day dashboard.

Target Users

Value Proposition

• Hierarchical Organization: Projects > Milestones > Tasks > Subtasks
• Comprehensive Time Tracking: Active timers, manual entries, statistics
• Document Workflow: Markdown documents with approval process
• Team Collaboration: Threaded discussions on any entity
• Personal Productivity: My Day dashboard for daily focus
• Flexible Scheduling: Calendar views with drag-drop rescheduling
• Reusable Templates: Save and create from project/task templates
• Recurring Tasks: Full recurrence support with RRULE

App Identity

Entry Points

Feature Categories

Category 1: Project Management

Core project lifecycle and organization

Feature: Project CRUD Operations

Description: Create, view, edit, and delete projects with comprehensive metadata, status tracking, and progress monitoring through milestones and tasks.

User Story: As a project manager, I want to manage projects so that I can organize and track work across my team.

Acceptance Criteria:

• [x] Create projects with title, description, metadata
• [x] View projects in list view with filtering
• [x] Edit project details
• [x] Delete/archive projects
• [x] Track completion percentage from tasks
• [x] Assign categories and tags

Implementation:

Routes:

• /projects - Project list
• /projects/:projectId - Project detail with tabs

Feature: Project Detail View

Description: Comprehensive project detail view with tabbed navigation for overview, milestones, tasks, calendar, documents, and discussions.

User Story: As a project manager, I want a comprehensive project view so that I can access all project information in one place.

Acceptance Criteria:

• [x] Header with project title, status, metadata
• [x] Statistics card showing progress metrics
• [x] Tabbed navigation (Overview, Milestones, Tasks, Calendar, Documents, Discussions)
• [x] Quick actions (edit, delete, complete)
• [x] Attributes section for categories/tags

Implementation:

Category 2: Milestone Management

Organize tasks into logical phases

Feature: Milestone CRUD Operations

Description: Create and manage milestones within projects to group related tasks and track phase completion.

User Story: As a project manager, I want to create milestones so that I can organize tasks into logical phases.

Acceptance Criteria:

• [x] Create milestones with title, description, due date
• [x] View milestones in list and detail views
• [x] Track completion percentage from tasks
• [x] Manage tasks at milestone level
• [x] Time tracking aggregation

Implementation:

Routes:

• /milestones - All milestones
• /milestones/:milestoneId - Milestone detail
• /projects/:projectId/milestones/:milestoneId - Nested milestone detail

Category 3: Task Management

Core task tracking with hierarchy and recurrence

Feature: Task CRUD Operations

Description: Full task lifecycle management with status tracking, priority levels, due dates, and hierarchical subtask support.

User Story: As a team member, I want to manage tasks so that I can track and complete my work.

Acceptance Criteria:

• [x] Create tasks with title, description, priority, due date
• [x] Track status (To Do, In Progress, Complete, On Hold, Blocked)
• [x] Support subtask hierarchy
• [x] Quick create modal for rapid entry
• [x] Status change with optional notes

Implementation:

Routes:

• /tasks - All tasks
• /tasks/:taskId - Task detail
• /tasks/:taskId/tasks/:subtaskId - Subtask detail

Feature: Subtasks

Description: Hierarchical task decomposition with parent-child relationships for breaking down complex tasks.

User Story: As a team member, I want to create subtasks so that I can break down complex work into smaller pieces.

Acceptance Criteria:

• [x] Create subtasks under parent tasks
• [x] View subtasks in parent task detail
• [x] Inline subtask editing
• [x] Subtask completion tracking
• [x] Navigation to subtask detail

Implementation:

Feature: Task Recurrence

Description: Create recurring tasks with full RRULE support including daily, weekly, monthly, yearly patterns with intervals and end dates.

User Story: As a team member, I want to create recurring tasks so that repetitive work is automatically scheduled.

Acceptance Criteria:

• [x] Define recurrence patterns (daily, weekly, monthly, yearly)
• [x] Set intervals and specific days
• [x] Set end date or occurrence count
• [x] Background generation of task instances
• [x] Pattern preview before creation

Implementation:

Category 4: Time Tracking

Comprehensive time tracking with timers and statistics

Feature: Active Timers

Description: Start, stop, and pause timers on tasks with real-time elapsed time display and header notification pills.

User Story: As a team member, I want to track time with timers so that I accurately log my work hours.

Acceptance Criteria:

• [x] Start/stop/pause timers on any task
• [x] Real-time elapsed time display
• [x] Active timer pills in header
• [x] Multiple concurrent timers support
• [x] Timer persists across page navigation

Implementation:

Feature: Time Entry Management

Description: Create, edit, and view manual time entries with start/end times, duration calculation, and entity association.

User Story: As a team member, I want to manually log time so that I can record work done outside of timer tracking.

Acceptance Criteria:

• [x] Create manual time entries
• [x] View time entries per task
• [x] Edit existing entries
• [x] Delete time entries
• [x] Duration auto-calculation

Implementation:

Feature: Time Tracking Statistics

Description: Aggregated time statistics with breakdowns by period, entity, user, and category.

User Story: As a project manager, I want to view time statistics so that I can understand where time is being spent.

Acceptance Criteria:

• [x] Time totals by task/milestone/project
• [x] Period-based aggregation (day/week/month)
• [x] Breakdown by category/user
• [x] Statistics widgets

Implementation:

Category 5: Document Management

Markdown documents with approval workflows

Feature: Document CRUD

Description: Create, edit, and manage markdown documents with rich editing, entity association, and type classification.

User Story: As a team member, I want to create documents so that I can capture and share project information.

Acceptance Criteria:

• [x] Create documents with markdown editor
• [x] Associate with project/milestone/task
• [x] Document type classification
• [x] File attachment support
• [x] Version tracking

Implementation:

Routes:

• /documents - Document list
• /documents/new - Create document
• /documents/:documentId - Document detail
• /documents/:documentId/edit - Edit document

Feature: Document Approval Workflow

Description: Formal approval workflow for documents with request, approve, reject, and revision request actions.

User Story: As a stakeholder, I want to approve documents so that I can ensure quality before documents are finalized.

Acceptance Criteria:

• [x] Request approval on documents
• [x] Approve/reject with comments
• [x] Request revision with feedback
• [x] Approval status badges
• [x] Approval history timeline

Implementation:

Category 6: Team Discussions

Threaded discussions on any entity

Feature: Discussion Threads

Description: Create threaded discussions on projects, milestones, and tasks with file attachments, editing, and nested replies.

User Story: As a team member, I want to discuss work items so that I can collaborate with my team.

Acceptance Criteria:

• [x] Create discussions on any entity
• [x] Reply to create threaded conversations
• [x] Edit/delete own discussions
• [x] File attachment support
• [x] Thread depth flattening for readability
• [x] Virtualized/paginated lists for performance

Implementation:

Category 7: Calendar & Scheduling

Visual scheduling with drag-drop support

Feature: Calendar View

Description: Calendar visualization of tasks, milestones, and time entries with day/week/month views and filtering.

User Story: As a project manager, I want a calendar view so that I can visualize project schedules.

Acceptance Criteria:

• [x] Day/week/month calendar views
• [x] Display tasks, milestones, time entries
• [x] Color coding by type/status
• [x] Event filtering
• [x] Calendar statistics

Implementation:

Feature: Drag-Drop Scheduling

Description: Drag-and-drop rescheduling of tasks directly on the calendar with conflict detection.

User Story: As a project manager, I want to drag tasks on the calendar so that I can quickly reschedule work.

Acceptance Criteria:

• [x] Drag tasks to new dates
• [x] Visual feedback during drag
• [x] Conflict detection warnings
• [x] Automatic data persistence

Implementation:

Category 8: My Day Dashboard

Personal productivity and focus

Feature: My Day Views

Description: Personal productivity dashboard showing today's tasks, upcoming deadlines, and time tracking across configurable scopes.

User Story: As an individual contributor, I want a My Day view so that I can focus on my personal tasks and schedule.

Acceptance Criteria:

• [x] Today view with current tasks
• [x] Week view with upcoming items
• [x] Month view for longer planning
• [x] Time tracked breakdown
• [x] Scope selection (workspace/org/all)

Implementation:

Routes:

• /my-day - My Day dashboard

Category 9: Templates

Reusable project/task templates

Feature: Template Management

Description: Save projects, milestones, and tasks as reusable templates with customization during creation.

User Story: As a project manager, I want to save templates so that I can quickly create similar projects.

Acceptance Criteria:

• [x] Save project/milestone/task as template
• [x] Browse template library
• [x] Create from template with customization
• [x] Edit template structure
• [x] Template categories

Implementation:

Routes:

• /templates - Template management

Category 10: Dashboard & Navigation

Central dashboard and app navigation

Feature: Project Dashboard

Description: Main dashboard with tabbed layout showing projects, milestones, tasks overview with quick access to key information.

User Story: As a user, I want a dashboard so that I can quickly see my work status and navigate to important items.

Acceptance Criteria:

• [x] Tabbed dashboard layout
• [x] Project overview section
• [x] Recent items display
• [x] Quick action buttons
• [x] Statistics summary

Implementation:

Routes:

• /dashboard - Main dashboard (default route)

Feature: Floating Action Button

Description: Context-aware floating action button for quick creation of projects, milestones, tasks, and time entries.

User Story: As a user, I want a quick action button so that I can rapidly create new items.

Acceptance Criteria:

• [x] Floating action button display
• [x] Context-aware action options
• [x] Expandable menu
• [x] Keyboard shortcut support

Implementation:

Capabilities

Core Capabilities

Technical Capabilities

Integration Capabilities

Data Models

Collections Used

Entity Relationships

Project
    |
    +-- Milestones (hasMany)
    |       |
    |       +-- Tasks (hasMany)
    |       |       |
    |       |       +-- Subtasks (hasMany via parentTaskId)
    |       |       |
    |       |       +-- TimeEntries (hasMany)
    |       |       |
    |       |       +-- Documents (hasMany)
    |       |       |
    |       |       +-- Discussions (hasMany)
    |       |
    |       +-- Documents (hasMany)
    |       |
    |       +-- Discussions (hasMany)
    |
    +-- Tasks (hasMany, direct)
    |
    +-- Documents (hasMany)
    |
    +-- Discussions (hasMany)
    |
    +-- Attributes (manyToMany)

Document
    |
    +-- Approvals (hasMany)

Task
    |
    +-- RecurrencePattern (hasOne, embedded)

Key Data Flows

User Action --> Component --> Hook --> RxDB Collection --> UI Update
                                  |
                                  +--> Service (complex logic)
                                  |
                                  +--> Replication --> Server

User Workflows

Workflow 1: Project Creation

Create and set up a new project

Trigger: Click "New Project" or use FAB

Steps:

Success Outcome: Project with milestones and tasks ready for work Failure Handling: Validation errors shown, form state preserved

Workflow 2: Task Completion

Complete a task with time logging

Trigger: Navigate to task, click complete

Steps:

Success Outcome: Task marked complete with time logged Failure Handling: Status change can be reverted

Workflow 3: Document Approval

Create and approve a document

Trigger: Create document from Documents tab

Steps:

Success Outcome: Document approved and finalized Failure Handling: Revision requested with feedback

Workflow 4: Time Tracking

Track time on a task

Trigger: Open task detail or header timer

Steps:

Success Outcome: Time accurately logged Failure Handling: Timer persists across navigation

Workflow 5: My Day Planning

Plan daily work

Trigger: Navigate to My Day

Steps:

Success Outcome: Daily work visible and manageable Failure Handling: Scope preference saved to localStorage

State Transitions

Task Status States

┌─────────┐   ┌─────────────┐   ┌──────────┐
│ To Do   │──▶│ In Progress │──▶│ Complete │
└─────────┘   └─────────────┘   └──────────┘
      │              │
      ▼              ▼
┌─────────┐   ┌─────────────┐
│ On Hold │◀──│   Blocked   │
└─────────┘   └─────────────┘

Document Approval States

┌─────────┐   ┌─────────────┐   ┌──────────┐
│  Draft  │──▶│   Pending   │──▶│ Approved │
└─────────┘   └─────────────┘   └──────────┘
                     │
                     ▼
              ┌─────────────┐
              │  Revision   │──▶ Draft
              │  Requested  │
              └─────────────┘
                     │
                     ▼
              ┌─────────────┐
              │  Rejected   │
              └─────────────┘

Integration Points

Internal Integrations

External Integrations

MCP Integration

Commands & Keybindings

Registered Commands

Keybindings

Menu Contributions

Architecture Summary

Directory Structure

src/
├── components/          # UI components (200+ files)
│   ├── calendar/       # Calendar components (10 files)
│   ├── card/           # Card components
│   ├── charts/         # Chart components
│   ├── common/         # Shared components
│   ├── dashboard/      # Dashboard components
│   ├── dataDisplay/    # Data display components
│   ├── discussions/    # Discussion components (13 files)
│   ├── documents/      # Document components (15 files)
│   ├── filters/        # Filter components
│   ├── form/           # Form components
│   ├── header/         # Header components
│   ├── image/          # Image components
│   ├── lists/          # List components
│   ├── milestones/     # Milestone components (6 files)
│   ├── myday/          # My Day components (6 files)
│   ├── projects/       # Project components (8 files)
│   ├── shared/         # Shared components
│   ├── tasks/          # Task components (11 files)
│   ├── templates/      # Template components (6 files)
│   └── timeTracking/   # Time tracking components
├── hooks/              # Custom React hooks (23 hooks)
├── services/           # Business logic services (9 services)
├── pages/              # Page components (15+ routes)
├── types/              # TypeScript definitions (13 files)
├── utils/              # Utility functions (20+ files)
├── store/              # Zustand stores
├── db/                 # Database configuration
└── styles/             # CSS and styling

Key Architectural Patterns

Services Overview

Hooks Overview

Quality & Compliance

Test Coverage

Accessibility

Security Considerations

FlowState Alignment

Spec-Driven Development

This app follows the FlowState Standard for spec-driven development:

• Requirements: .flowstate/specs/{{feature-name}}/requirements.md
• Design: .flowstate/specs/{{feature-name}}/design.md
• Wireframes: .flowstate/specs/{{feature-name}}/wireframes.html
• Tasks: .flowstate/specs/{{feature-name}}/tasks.md

Quality Gates

Appendix

Related Documentation

Version History