Overview
The Aligner Tracker API is the backend service powering the Aligner Tracker mobile app. It enables dental aligner patients to track their treatment progress, upload progress photos, and receive timely reminders for aligner changes. This is the user-facing backend that integrates with Cognito for authentication and S3 for image storage.
Quick Facts
- Tech Stack: FastAPI, PostgreSQL, SQLAlchemy, Alembic, AWS (Cognito, S3, ECR)
- Python: 3.13+
- Package Manager: uv
- Repo:
Aligner-Tracker-Api
Key Capabilities
- User creation with automatic Cognito provisioning
- Aligner progress tracking with 10-day change cycles
- Progress photo uploads to S3 with pre-signed URLs
- Scheduled notifications for aligner changes
- Integration with Jarvis and HubSpot
Related Notes
Architecture
Purpose
The technical architecture of the Aligner Tracker API. Covers the request flow from mobile app to database, authentication model, AWS integrations, and deployment pipeline. Use this to understand how the system is structured and where components live.
Data Model
Purpose
The database schema and entity relationships for the Aligner Tracker API. Covers all tables, their fields, and how they relate to each other. Use this to understand the data structure before querying or extending the schema.
API Reference
Purpose
Complete API endpoint documentation for the Aligner Tracker API. Covers all routes, request/response formats, and authentication requirements. Use this as a quick reference when integrating with the API.
Business Logic
Purpose
The core business rules and workflows of the Aligner Tracker API. Covers user onboarding, the 10-day aligner cycle, notification scheduling, and how data flows through the system. Use this to understand the “why” behind the code before diving into implementation details.