How annaangel040/breadcrumbs- works
Breadcrumbs is a mental-health check-in and clinical triage product with a patient-facing sanctuary and a therapist workspace. The main workflow runs from patient voice or text reflection through API ingestion, local transcription and stress/safety analysis, then structured persistence. Patient views keep clinical scores hidden; clinician-facing analytics add time-decay, stressor threads, trends, severity, and reports. Matching and account/therapist workflows are additional product branches. README documents several capabilities whose source was not sampled, so those components are included only where the tree supports their paths; uncertain wiring is omitted.
Main entry points: main.py FastAPI Routes · pipeline.py Entry Pipeline · api.js API Client · App.jsx Check-in App
Components 25
Patient Experience
- Check-in App
frontend/src/App.jsx - Account Access
frontend/src/components/AuthModal.jsx - Patient Views
frontend/src/components/WelcomePage.jsx - Care Finder
frontend/src/components/FindCarePage.jsx - Therapist Portal
frontend/src/components/TherapistPortalModal.jsx - Report Viewer
frontend/src/components/ReportModal.jsx
API and Ingestion
- API Client
frontend/src/services/api.js - FastAPI Routes
backend/app/main.py - Entry Pipeline
backend/app/pipeline.py
Reflection Analysis
- Voice Transcription
backend/app/transcription.py - Stress Classifier
backend/app/model_client.py - Topic Categorization
backend/app/categorize.py - Crisis Detection
backend/app/risk_keywords.py - Intensity Fusion
backend/app/sentiment_intensity.py
Clinical Workspace
- Clinical Reports
backend/app/report.py - Stressor Threads
backend/app/threading_logic.py - Semantic Similarity
backend/app/stressor_similarity.py - Trend Analysis
backend/app/trends.py - Severity Triage
backend/app/severity.py - Therapist Matching
backend/app/matching.py - Crisis Resources
Accounts and Records
- SQLite Records
backend/app/database.py - Account and Care Records
backend/app/database.py
Other components
- Patient
- Therapist
Connections 32
- Patient → Check-in App: reflects
- Check-in App → API Client: submits check-in
- Check-in App → API Client: checks status
- API Client → FastAPI Routes: calls endpoints
- FastAPI Routes → Entry Pipeline: processes entry
- Entry Pipeline → Voice Transcription: transcribes audio
- Entry Pipeline → Stress Classifier: scores text
- Entry Pipeline → Topic Categorization: categorizes text
- Entry Pipeline → Crisis Detection: checks risk
- Entry Pipeline → Intensity Fusion: optionally fuses
- Entry Pipeline → SQLite Records: inserts metrics
- FastAPI Routes → SQLite Records: reads and updates
- FastAPI Routes → Account and Care Records: manages accounts
- Account Access → API Client: signs in
- Check-in App → Patient Views: shows wellness
- Patient Views → API Client: requests overview
- FastAPI Routes → Clinical Reports: builds views
- Clinical Reports → SQLite Records: reads entries
- FastAPI Routes → Stressor Threads: builds threads
- Stressor Threads → Trend Analysis: analyzes thread
- Stressor Threads → Severity Triage: assigns triage
- Stressor Threads → Semantic Similarity: optionally clusters
- FastAPI Routes → Trend Analysis: computes trend
- FastAPI Routes → Severity Triage: computes severity
- FastAPI Routes → Therapist Matching: matches practitioners
- Therapist Matching → Account and Care Records: uses care profiles
- Therapist → Therapist Portal: reviews caseload
- Therapist Portal → API Client: requests clinical data
- Report Viewer → API Client: requests report
- Care Finder → API Client: requests matches
- FastAPI Routes → Crisis Resources: returns crisis resources
- Patient Views → Crisis Resources: surfaces safety options