How marcizos/taskflow-pro works
TaskFlow Pro is a dependency-aware Kanban planner. Users create and edit tasks, manage prerequisites, move cards across gated workflow columns, and inspect schedules and critical paths; the backend validates graph changes, propagates schedule shifts, derives readiness, and persists the board. A separate AI workflow proposes evidence-checked dependencies for human review. The graph preserves documented capabilities even where implementation excerpts are incomplete; dashed links mark optional integrations. Evidence is limited to the supplied excerpts, source index, and README.
Main entry points: App.tsx Application shell · board.py Board operations · hooks.ts Query and mutations · ai.py Suggestion validation and decisions
Components 22
Web application
- Application shell
frontend/src/App.tsx - Kanban board
frontend/src/components/BoardView.tsx - Dependency graph view
frontend/src/components/GraphView.tsx - Task editing
frontend/src/components/TaskDrawer.tsx - Task creation
frontend/src/components/NewTaskDialog.tsx - Suggestion review
frontend/src/components/SuggestionsPanel.tsx - Query and mutations
frontend/src/hooks.ts - User notifications
frontend/src/components/Toasts.tsx - API client
frontend/src/api.ts
Planning services
- Board operations
backend/app/services/board.py - Dependency and schedule engine
backend/app/engine/graph.py - Demo board seeding
backend/app/seed.py
AI suggestions
- Suggestion validation and decisions
backend/app/services/ai.py - Hosted LLM providers
- Offline keyword model
backend/app/services/ai.py
Runtime and storage
- HTTP API
backend/app/api.py - Task and dependency records
backend/app/models.py - Persistent database
- Database sessions and locking
backend/app/db.py - Runtime configuration
backend/app/config.py - Application startup
backend/app/main.py
Other components
- Planner
Connections 30
- Planner → Application shell: uses
README.md - Application shell → Kanban board: renders
frontend/src/App.tsx - Application shell → Dependency graph view: renders
frontend/src/App.tsx - Application shell → Task editing: opens
frontend/src/App.tsx - Application shell → Task creation: opens
frontend/src/App.tsx - Application shell → Suggestion review: opens
frontend/src/App.tsx - Application shell → Query and mutations: loads board
frontend/src/App.tsx - Kanban board → Query and mutations: mutates through
frontend/src/components/BoardView.tsx - Task editing → Query and mutations: mutates through
frontend/src/components/TaskDrawer.tsx - Task creation → Query and mutations: mutates through
frontend/src/components/NewTaskDialog.tsx - Suggestion review → API client: requests
frontend/src/components/SuggestionsPanel.tsx - Query and mutations → API client: requests
frontend/src/hooks.ts - Query and mutations → User notifications: reports results
frontend/src/hooks.ts - API client → HTTP API: sends HTTP requests
README.md - HTTP API → Board operations: dispatches board actions
backend/app/api.py - HTTP API → Suggestion validation and decisions: dispatches AI actions
backend/app/api.py - Board operations → Dependency and schedule engine: validates and schedules
backend/app/services/board.py - Board operations → Task and dependency records: loads and saves
backend/app/services/board.py - Board operations → Database sessions and locking: locks writes
backend/app/services/board.py - Database sessions and locking → Runtime configuration: reads settings
backend/app/db.py - Database sessions and locking → Persistent database: reads and writes
backend/app/db.py - Task and dependency records → Database sessions and locking: uses ORM base
backend/app/models.py - Application startup → HTTP API: registers routes
backend/app/main.py - Application startup → Demo board seeding: initializes demo
backend/app/main.py - Application startup → Board operations: loads board
backend/app/main.py - HTTP API → Demo board seeding: resets demo
backend/app/api.py - Suggestion validation and decisions → Dependency and schedule engine: dry-run validates
backend/app/services/ai.py - Suggestion validation and decisions → Board operations: accepts dependency
backend/app/services/ai.py - Suggestion validation and decisions → Hosted LLM providers: requests proposals
backend/app/services/ai.py - Suggestion validation and decisions → Offline keyword model: uses fallback
README.md