How andy1924/carrick works
Carrick turns field reports into reviewed, auditable schedule-progress exports. Supervisors import a schedule and submit notes or documents; the API extracts events, proposes activity matches, and stages them for planner clarification or approval before export. Rule-based matching is built into the worker, with optional AI retrieval and reranking. The README also describes structured progress history and CSV-log workflows. The map reflects the sampled API, worker, and web code; unsampled capabilities are included only where documented, and their internal links are omitted where implementation evidence is unavailable.
Main entry points: app.py HTTP API · ai.py AI analysis · app.js Workspace UI · engine.py Rule matching
Components 15
Capture and interface
- Workspace UI
apps/web/app.js - Introduction preview
apps/web/landing.js
Progress workflow
- HTTP API
services/api/app.py - Schedule import
services/api/app.py - Report intake
services/api/app.py - Document text
services/worker/ingest.py - Event decisions
services/api/app.py - Progress export
services/api/app.py
Schedule analysis
- Schedule parser
services/worker/engine.py - Rule matching
services/worker/engine.py - AI analysis
services/worker/ai.py
Persistence and integrations
- SQLite state
services/api/app.py - OpenAI API
Other components
- Supervisor
- Planner
Connections 19
- Supervisor → Workspace UI: submits updates
README.md - Planner → Workspace UI: reviews events
README.md - Workspace UI → HTTP API: calls API
apps/web/app.js - Introduction preview → HTTP API: requests preview
apps/web/landing.js - HTTP API → Schedule import: routes imports
services/api/app.py - HTTP API → Report intake: routes reports
services/api/app.py - HTTP API → Event decisions: routes decisions
services/api/app.py - HTTP API → Progress export: routes exports
services/api/app.py - Report intake → Document text: extracts documents
services/api/app.py - Schedule import → Schedule parser: parses schedule
services/api/app.py - Report intake → Rule matching: matches events
services/api/app.py - Report intake → AI analysis: analyzes with AI
services/api/app.py - AI analysis → Rule matching: uses schedule context
services/worker/ai.py - AI analysis → OpenAI API: requests embeddings
services/worker/ai.py - AI analysis → OpenAI API: requests extraction
services/worker/ai.py - Schedule import → SQLite state: stores schedule
README.md - Report intake → SQLite state: stores reports
README.md - Event decisions → SQLite state: records decisions
README.md - Progress export → SQLite state: reads approved progress
README.md