How kanukuntla-r/career-card-capture works
Career Card Capture is a browser-based workflow for turning handwritten career-service cards into reviewed records: an operator captures an image, the API normalizes it and requests OCR, the operator edits and approves the draft, and PostgreSQL stores the authoritative record. Approved data can sync to Google Sheets or export as CSV. The README documents the end-to-end architecture; source excerpts support card processing, session persistence, OCR, and sheet synchronization. Other route internals and some UI wiring were not sampled, so those links are shown only where documented.
Main entry points: cards.py Card workflow · career-card-app.tsx Operator app · api.ts API client · sessions.py Session routes
Components 23
Capture and review
- Operator app
apps/web/components/career-card-app.tsx - Camera capture
apps/web/components/camera-panel.tsx - Card review
apps/web/components/card-history.tsx - Event setup
apps/web/components/new-event-form.tsx - Sync controls
apps/web/components/google-sheets-panel.tsx - API client
apps/web/lib/api.ts
API workflows
- Event routes
apps/api/app/api/routes/events.py - Session routes
apps/api/app/api/routes/sessions.py - Card workflow
apps/api/app/api/routes/cards.py - Sync routes
apps/api/app/api/routes/sync.py
Image and OCR
- Image normalization
apps/api/app/services/vision.py - OCR provider selection
apps/api/app/services/ocr/factory.py - Hunyuan OCR
apps/api/app/services/ocr/hunyuan.py - Mock OCR
apps/api/app/services/ocr/mock.py - Response classification
apps/api/app/services/ocr/classification.py
Records and persistence
- Domain records
apps/api/app/models/entities.py - PostgreSQL
apps/api/app/core/database.py
Export and sync
- Sheets sync service
apps/api/app/services/sheets/sync.py - Google Sheets gateway
apps/api/app/services/sheets/google.py - CSV export
apps/api/app/api/routes/cards.py
Other components
- Operator
- Local OCR server
- Google Sheets
Connections 27
- Operator → Operator app: uses
README.md - Operator app → Camera capture: captures with
README.md - Operator app → Event setup: sets up events
- Operator app → Card review: reviews drafts
README.md - Operator app → Sync controls: manages sync
- Operator app → API client: requests data
- API client → Event routes: calls API
README.md - API client → Session routes: calls API
README.md - API client → Card workflow: calls API
README.md - API client → Sync routes: calls API
README.md - Card workflow → Image normalization: normalizes image
apps/api/app/api/routes/cards.py - Card workflow → OCR provider selection: requests OCR
apps/api/app/api/routes/cards.py - OCR provider selection → Hunyuan OCR: selects provider
apps/api/app/services/ocr/factory.py - OCR provider selection → Mock OCR: selects provider
apps/api/app/services/ocr/factory.py - Hunyuan OCR → Response classification: classifies text
apps/api/app/services/ocr/hunyuan.py - Mock OCR → Response classification: classifies text
apps/api/app/services/ocr/mock.py - Hunyuan OCR → Local OCR server: sends image
apps/api/app/services/ocr/hunyuan.py - Card workflow → Domain records: reads and updates
apps/api/app/api/routes/cards.py - Session routes → Domain records: reads and updates
apps/api/app/api/routes/sessions.py - Card workflow → PostgreSQL: persists records
README.md - Session routes → PostgreSQL: queries and commits
apps/api/app/api/routes/sessions.py - Event routes → PostgreSQL: persists events
- Card workflow → Sheets sync service: queues approved cards
apps/api/app/api/routes/cards.py - Sync routes → Sheets sync service: runs sync
apps/api/app/api/routes/sync.py - Sheets sync service → Google Sheets gateway: updates rows
apps/api/app/services/sheets/sync.py - Google Sheets gateway → Google Sheets: reads and writes
README.md - Card workflow → CSV export: exports records
README.md