How aelena/flowtrack works
FlowTrack is a project-triage tracker: users organize projects into areas, record tasks and notes, and compare task-derived completion with their own estimate against explicit abandonment criteria. The Svelte UI calls a FastAPI API backed by PostgreSQL; an MCP server lets agents inspect and update the same portfolio through REST. The graph includes documented file, configuration, backup, document-generation, and browser-clipper capabilities. Some feature implementations were not sampled, so their internal connections are omitted rather than inferred.
Main entry points: main.py HTTP API · database.py Database sessions · api.js Web API client · ProjectView.svelte Project workspace
Components 25
Web interface
- Home and settings
frontend/src/routes/+page.svelte - Project workspace
frontend/src/lib/components/ProjectView.svelte - Project navigation
frontend/src/lib/components/Sidebar.svelte - Commands and exports
frontend/src/lib/components/CommandBar.svelte - Task editor
frontend/src/lib/components/TaskList.svelte - Notes and writing
frontend/src/lib/components/NoteEditor.svelte - Write mode
frontend/src/lib/components/WriteMode.svelte - Web API client
frontend/src/lib/api.js
API and domain
- HTTP API
backend/app/main.py - Project lifecycle
backend/app/routers/projects.py - Areas
backend/app/routers/areas.py - Task operations
backend/app/routers/tasks.py - Notes
backend/app/routers/notes.py - Project files
backend/app/routers/files.py - Backup and restore
backend/app/routers/backup.py - Configuration
backend/app/routers/config.py - Project documents
backend/app/routers/documents.py - Browser clipper
backend/app/routers/extension.py
Persistence
- Domain records
backend/app/models.py - Database sessions
backend/app/database.py - PostgreSQL
Agent and integrations
- MCP tools and prompts
mcp-server/src/flowtrack_mcp/server.py - REST transport
mcp-server/src/flowtrack_mcp/client.py
Other components
- User
- Agent
Connections 41
- User → Home and settings: uses
README.md - Home and settings → Project navigation: shows navigation
frontend/src/routes/+page.svelte - Home and settings → Web API client: loads portfolio
frontend/src/routes/+page.svelte - User → Project workspace: opens project
README.md - Project workspace → Web API client: requests project data
frontend/src/lib/components/ProjectView.svelte - Project workspace → Task editor: renders tasks
frontend/src/lib/components/ProjectView.svelte - Project workspace → Notes and writing: renders notes
frontend/src/lib/components/ProjectView.svelte - Project workspace → Commands and exports: renders commands
frontend/src/lib/components/ProjectView.svelte - Project workspace → Write mode: renders writing
frontend/src/lib/components/ProjectView.svelte - Project navigation → Web API client: requests projects
frontend/src/lib/components/Sidebar.svelte - Task editor → Web API client: updates tasks
frontend/src/lib/components/TaskList.svelte - Notes and writing → Web API client: updates notes
frontend/src/lib/components/NoteEditor.svelte - Commands and exports → Web API client: requests exports
frontend/src/lib/components/CommandBar.svelte - Write mode → Notes and writing: supports writing
frontend/src/lib/components/ProjectView.svelte - Web API client → HTTP API: sends API requests
frontend/src/lib/api.js - HTTP API → Project lifecycle: registers routes
backend/app/main.py - HTTP API → Areas: registers routes
backend/app/main.py - HTTP API → Task operations: registers routes
backend/app/main.py - HTTP API → Notes: registers routes
backend/app/main.py - HTTP API → Project files: registers routes
backend/app/main.py - HTTP API → Backup and restore: registers routes
backend/app/main.py - HTTP API → Configuration: registers routes
backend/app/main.py - HTTP API → Project documents: registers routes
backend/app/main.py - HTTP API → Browser clipper: registers routes
backend/app/main.py - Project lifecycle → Database sessions: uses sessions
backend/app/routers/projects.py - Areas → Database sessions: uses sessions
backend/app/routers/areas.py - Task operations → Database sessions: uses sessions
backend/app/routers/tasks.py - Notes → Database sessions: uses sessions
backend/app/routers/notes.py - Project files → Database sessions: uses sessions
backend/app/routers/files.py - Backup and restore → Database sessions: uses sessions
backend/app/routers/backup.py - Configuration → Database sessions: uses settings
backend/app/routers/config.py - Project documents → Database sessions: reads records
backend/app/routers/documents.py - Browser clipper → Database sessions: uses sessions
backend/app/routers/extension.py - Database sessions → PostgreSQL: persists data
README.md - Project lifecycle → Domain records: queries projects
backend/app/routers/projects.py - Task operations → Domain records: creates tasks
backend/app/routers/tasks.py - Notes → Domain records: manages notes
backend/app/routers/notes.py - Project files → Domain records: manages file records
backend/app/routers/files.py - Agent → MCP tools and prompts: invokes tools
README.md - MCP tools and prompts → REST transport: calls transport
mcp-server/src/flowtrack_mcp/server.py - REST transport → HTTP API: calls REST API
README.md