How codechen-1/task-management-system works
This is a FastAPI/SQLite task-management application with browser and CLI clients. The main workflow is user registration/login, authenticated task capture and planning (Inbox, planned dates, top-three focus, checklists), organization/search, and calendar review; categories and preferences provide adjacent capabilities. The server mounts the static UI and registers API routers, while task routes own persistence and filtering. Some UI, settings, calendar, and CLI behavior is represented from the README and source index where implementation excerpts were not provided.
Main entry points: main.py FastAPI app · database.py SQLAlchemy session · tasks.py Tasks and planner · categories.py Categories
Components 20
User clients
- Web interface
static/js/app.js - CLI menus
cli/menus.py - CLI handlers
cli/handlers.py
API workflows
- FastAPI app
app/main.py - Authentication
app/routes/auth.py - Tasks and planner
app/routes/tasks.py - Categories
app/routes/categories.py - Calendar views
app/routes/calendar.py - User settings
app/routes/settings.py
Domain and validation
- Task validation
app/schemas/task.py - Category validation
app/schemas/category.py - Date handling
app/utils/dates.py
Persistence and security
- JWT and passwords
app/utils/security.py - SQLAlchemy session
app/database.py - User records
app/models/user.py - Task records
app/models/task.py - Category records
app/models/category.py - Settings records
app/models/settings.py - Planner upgrade
app/migrations.py
Other components
- User
Connections 36
- User → Web interface: uses
README.md - User → CLI menus: uses
README.md - Web interface → FastAPI app: calls API
README.md - CLI menus → CLI handlers: dispatches
cli/menus.py - CLI handlers → FastAPI app: sends requests
cli/handlers.py - FastAPI app → Authentication: registers router
app/main.py - FastAPI app → Tasks and planner: registers router
app/main.py - FastAPI app → Categories: registers router
app/main.py - FastAPI app → Calendar views: registers router
app/main.py - FastAPI app → User settings: registers router
app/main.py - FastAPI app → SQLAlchemy session: creates tables
app/main.py - FastAPI app → Planner upgrade: runs upgrade
app/main.py - Authentication → JWT and passwords: checks credentials
app/routes/auth.py - Authentication → User records: reads/writes
app/routes/auth.py - Authentication → Category records: creates defaults
app/routes/auth.py - Tasks and planner → Task validation: validates input
app/routes/tasks.py - Tasks and planner → JWT and passwords: authenticates
app/routes/tasks.py - Tasks and planner → SQLAlchemy session: queries and commits
app/routes/tasks.py - Tasks and planner → Task records: reads/writes
app/routes/tasks.py - Tasks and planner → Category records: checks ownership
app/routes/tasks.py - Categories → Tasks and planner: uses task helpers
app/routes/categories.py - Categories → Category validation: validates input
app/routes/categories.py - Categories → SQLAlchemy session: queries and commits
app/routes/categories.py - Categories → Category records: reads/writes
app/routes/categories.py - Calendar views → SQLAlchemy session: queries
app/routes/calendar.py - Calendar views → Task records: reads tasks
app/routes/calendar.py - Calendar views → Date handling: normalizes dates
app/routes/calendar.py - User settings → SQLAlchemy session: queries and commits
app/routes/settings.py - User settings → Settings records: reads/writes
app/routes/settings.py - Task validation → Date handling: normalizes deadlines
app/schemas/task.py - Task validation → Category validation: embeds category
app/schemas/task.py - SQLAlchemy session → User records: provides base
app/models/user.py - SQLAlchemy session → Task records: provides base
app/models/task.py - SQLAlchemy session → Category records: provides base
app/models/category.py - JWT and passwords → SQLAlchemy session: loads session
app/utils/security.py - JWT and passwords → User records: loads identity
app/utils/security.py