How eusholli/ttv-ai-clipper works
Main Components
A. Client Layer:
• React Frontend (Vite-based)
• Key components: Authentication, Pricing, and User Profile modules
• Static assets served through Nginx
B. Server Layer:
• Nginx Reverse Proxy
• FastAPI Backend
• Authentication Service (evident from auth components)
C. External Services & Storage:
• PostgreSQL Database (indicated by *_psql.py files)
• R2 Storage (indicated by r2_manager.py)
• Google Services Integration (shown by google_found_psql.py)
• Video Processing Service (indicated by video_utils.py)
[Client Layer]
• ↕
[Reverse Proxy Layer]
• ↕
[Application Layer]
• ↕
[External Services Layer]
Component Relationships to Highlight
Frontend → Backend Interactions:
• API routes through Nginx reverse proxy
• Authentication flow
• Video processing requests
• Search functionality (from transcript_search.py)
Backend → External Services:
• Database connections
• R2 storage operations
• Video processing pipeline
• Google service integrations
Specific Implementation Details
[Nginx Container]
• Static file serving
• API request routing
• Port 80 exposure
[Frontend Container]
• React components
• Authentication UI
• Pricing interface
• User profile management
[Backend Container]
• FastAPI application
• Video processing logic
• Transcript search
• R2 storage management
• PostgreSQL interactions
Environment & Configuration
A section showing:
• Environment variables (.env files)
• Configuration files (logging.conf)
• Build/deployment scripts
Additional Elements
• Development tools (.devcontainer)
• CI/CD components (cloudbuild.yaml)
• Deployment configurations (render.yaml)
Technical Stack Callouts
Technologies:
• Vite/React (Frontend)
• FastAPI (Backend)
• PostgreSQL (Database)
• R2 (Storage)
• Docker (Containerization)
• Nginx (Reverse Proxy)
Remember to:
• Version information
• Security boundaries
• Scalable components
• Monitoring/logging points