How alimgiray/tasks works
Project Type and Purpose
• This is a Go‐based, command‐line TUI (text‐user interface) application for tracking tasks.
• It uses CharmBracelet’s BubbleTea library for its UI (under src/views).
• It persists data via a local database and applies migrations at startup.
Out the Key Packages (Top‐Level Components)
1) cmd
– Entry point (main.go)
– Responsible for wiring together subsystems and launching the TUI.
2) src/database
– database.go: DB connection & query helpers
– migration.go: runs migrations on startup
– project.go/task.go: CRUD operations
3) src/migrations
– Organized migration files (0000_…, 0001_…, etc.)
– Migration runner that applies schema changes
4) src/models
– Domain objects: Project, Task
– Pure data structures (no I/O)
5) src/views
– BubbleTea models, views, cursors, and layout components (dashboard, project panes, headers, footers)
– Handles user input, rendering, and state transitions
Relationships & Data Flows
• Startup sequence:
cmd/main.go → initialize database connection (src/database/database.go) → run migrations (src/database/migration.go + src/migrations) → load initial data (src/database/project.go, task.go) → initialize BubbleTea TUI (src/views)
• Runtime interaction:
User keystroke → BubbleTea event loop (views/cursor.go, views/dashboard.go…) → maps to command (e.g., create task) → call into database layer → update model → views re‐render
• Persistence layer:
src/database ←→ underlying SQL store (e.g., SQLite file)
Architectural Patterns & Principles
• Clear separation of concerns:
– Presentation (views)
– Domain (models)
– Persistence (database + migrations)
– Orchestration/entry (cmd)
• MVC‐like flow inside TUI:
– Model = domain objects + view state
– View = BubbleTea rendering components
– Controller = BubbleTea update functions reading input & invoking DB
• Migration‐based schema evolution
– [ ] Clear labels for all packages and runtime modules
– [ ] Annotation of key files or functions (e.g., main.go, migration runner)
– [ ] External library (BubbleTea) flagged