domverse
6421f83ca7
Full-stack flight price scanner built on fast-flights v3 (SOCS cookie bypass): Backend (FastAPI + SQLite): - REST API with rate limiting, Pydantic v2 validation, paginated responses - Scan pipeline: resolves airports, queries every day in the window, saves individual flights + aggregate route stats to SQLite - Background async scan processor with real-time progress tracking - Airport search endpoint backed by OpenFlights dataset - Daily scan window (all dates, not monthly samples) Frontend (React 19 + TypeScript + Tailwind CSS v4): - Dashboard with live scan status and recent scans - Create scan form: country mode or specific airports (searchable dropdown) - Scan detail page with expandable route rows showing individual flights (date, airline, departure, arrival, price) loaded on demand - AirportSearch component with debounced live search and multi-select Database: - scans → routes → flights schema with FK cascade and auto-update triggers - Migrations for schema evolution (relaxed country constraint) Tests: - 74 tests: unit + integration, isolated per-test SQLite DB - Confirmed flight fixtures in tests/confirmed_flights.json (50 real flights, BDS→FMM Ryanair + BDS→DUS Eurowings, scraped Feb 2026) - Integration tests parametrized from confirmed routes Docker: - Multi-stage builds, Compose orchestration, Nginx reverse proxy Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
354 lines
6.7 KiB
Markdown
354 lines
6.7 KiB
Markdown
# Flight Radar Web App - Docker Quick Start
|
|
|
|
**Get the entire application running in under 2 minutes!** 🚀
|
|
|
|
---
|
|
|
|
## One-Command Deployment
|
|
|
|
```bash
|
|
docker-compose up -d
|
|
```
|
|
|
|
**Access the application:**
|
|
- **Frontend:** http://localhost
|
|
- **Backend API:** http://localhost:8000
|
|
- **API Docs:** http://localhost:8000/docs
|
|
|
|
---
|
|
|
|
## What Gets Deployed?
|
|
|
|
### Backend (Python FastAPI)
|
|
- RESTful API server
|
|
- SQLite database with schema
|
|
- Airport data (auto-downloaded)
|
|
- Rate limiting & logging
|
|
- Health checks
|
|
|
|
### Frontend (React + Nginx)
|
|
- Production-optimized React build
|
|
- Nginx web server
|
|
- API proxy configuration
|
|
- Static asset caching
|
|
- Health checks
|
|
|
|
### Networking
|
|
- Internal bridge network
|
|
- Backend accessible at `backend:8000`
|
|
- Frontend proxies API requests
|
|
|
|
---
|
|
|
|
## Architecture
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────┐
|
|
│ Docker Host │
|
|
│ │
|
|
│ ┌──────────────────┐ ┌─────────────────┐ │
|
|
│ │ Frontend │ │ Backend │ │
|
|
│ │ (nginx:80) │◄────►│ (Python:8000) │ │
|
|
│ │ │ │ │ │
|
|
│ │ - React App │ │ - FastAPI │ │
|
|
│ │ - Static Files │ │ - SQLite DB │ │
|
|
│ │ - API Proxy │ │ - Rate Limit │ │
|
|
│ └──────────────────┘ └─────────────────┘ │
|
|
│ │ │ │
|
|
│ │ │ │
|
|
│ Port 80 Port 8000 │
|
|
└─────────┼─────────────────────────┼─────────────┘
|
|
│ │
|
|
└─────────────────────────┘
|
|
Host Machine Access
|
|
```
|
|
|
|
---
|
|
|
|
## Quick Commands
|
|
|
|
### Starting & Stopping
|
|
|
|
```bash
|
|
# Start (detached)
|
|
docker-compose up -d
|
|
|
|
# Start (with logs)
|
|
docker-compose up
|
|
|
|
# Stop
|
|
docker-compose down
|
|
|
|
# Restart
|
|
docker-compose restart
|
|
```
|
|
|
|
### Monitoring
|
|
|
|
```bash
|
|
# View logs
|
|
docker-compose logs -f
|
|
|
|
# Check status
|
|
docker-compose ps
|
|
|
|
# Resource usage
|
|
docker stats flight-radar-backend flight-radar-frontend
|
|
```
|
|
|
|
### Database
|
|
|
|
```bash
|
|
# Backup
|
|
docker cp flight-radar-backend:/app/cache.db ./backup.db
|
|
|
|
# Restore
|
|
docker cp ./backup.db flight-radar-backend:/app/cache.db
|
|
|
|
# Access database
|
|
docker-compose exec backend sqlite3 cache.db
|
|
```
|
|
|
|
### Rebuilding
|
|
|
|
```bash
|
|
# Rebuild after code changes
|
|
docker-compose up --build
|
|
|
|
# Force rebuild
|
|
docker-compose build --no-cache
|
|
```
|
|
|
|
---
|
|
|
|
## Ports
|
|
|
|
| Service | Internal | External | Purpose |
|
|
|---------|----------|----------|---------|
|
|
| Frontend | 80 | 80 | Web UI |
|
|
| Backend | 8000 | 8000 | API Server |
|
|
|
|
**Change ports in `.env`:**
|
|
```bash
|
|
FRONTEND_PORT=8080
|
|
BACKEND_PORT=8001
|
|
```
|
|
|
|
---
|
|
|
|
## Volumes
|
|
|
|
### Backend Data
|
|
- **Volume:** `backend-data`
|
|
- **Mount:** `/app/data`
|
|
- **Contents:** Database, cache files
|
|
- **Persistence:** Survives container restarts
|
|
|
|
### Database File
|
|
- **Mount:** `./cache.db:/app/cache.db`
|
|
- **Type:** Bind mount (optional)
|
|
- **Purpose:** Easy backup access
|
|
|
|
---
|
|
|
|
## Environment Variables
|
|
|
|
Create `.env` from template:
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
**Key Variables:**
|
|
```bash
|
|
# Backend
|
|
PORT=8000
|
|
ALLOWED_ORIGINS=http://localhost
|
|
|
|
# Rate Limits
|
|
RATE_LIMIT_SCANS=10
|
|
RATE_LIMIT_AIRPORTS=100
|
|
```
|
|
|
|
---
|
|
|
|
## Health Checks
|
|
|
|
Both services have automatic health checks:
|
|
|
|
```bash
|
|
# Backend
|
|
curl http://localhost:8000/health
|
|
|
|
# Frontend
|
|
curl http://localhost/
|
|
|
|
# Docker health status
|
|
docker ps
|
|
```
|
|
|
|
**Health indicators:**
|
|
- `healthy` - Service operational
|
|
- `starting` - Initialization in progress
|
|
- `unhealthy` - Service down
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### Container won't start
|
|
|
|
```bash
|
|
# Check logs
|
|
docker-compose logs [service-name]
|
|
|
|
# Common issues:
|
|
# - Port already in use: Change port in .env
|
|
# - Build failed: Run docker-compose build --no-cache
|
|
# - Permission denied: Check file permissions
|
|
```
|
|
|
|
### API not accessible from frontend
|
|
|
|
```bash
|
|
# Check nginx proxy config
|
|
docker-compose exec frontend cat /etc/nginx/conf.d/default.conf
|
|
|
|
# Test backend from frontend container
|
|
docker-compose exec frontend wget -qO- http://backend:8000/health
|
|
```
|
|
|
|
### Database issues
|
|
|
|
```bash
|
|
# Reset database
|
|
docker-compose down
|
|
docker volume rm flight-comparator_backend-data
|
|
docker-compose up -d
|
|
```
|
|
|
|
---
|
|
|
|
## Development Workflow
|
|
|
|
### Code Changes
|
|
|
|
**Backend changes:**
|
|
```bash
|
|
# Edit Python files
|
|
# Rebuild and restart
|
|
docker-compose up --build backend
|
|
```
|
|
|
|
**Frontend changes:**
|
|
```bash
|
|
# Edit React files
|
|
# Rebuild and restart
|
|
docker-compose up --build frontend
|
|
```
|
|
|
|
### Hot Reload (Development)
|
|
|
|
For development with hot reload, run services manually:
|
|
|
|
**Backend:**
|
|
```bash
|
|
python api_server.py
|
|
```
|
|
|
|
**Frontend:**
|
|
```bash
|
|
cd frontend
|
|
npm run dev
|
|
```
|
|
|
|
---
|
|
|
|
## Production Deployment
|
|
|
|
### Security Checklist
|
|
|
|
- [ ] Set `ALLOWED_ORIGINS` to production domain
|
|
- [ ] Use HTTPS (reverse proxy with SSL)
|
|
- [ ] Update rate limits for expected traffic
|
|
- [ ] Configure logging level to `INFO` or `WARNING`
|
|
- [ ] Set up automated backups
|
|
- [ ] Enable monitoring
|
|
- [ ] Review nginx security headers
|
|
|
|
### Performance Optimization
|
|
|
|
```yaml
|
|
# docker-compose.yml
|
|
services:
|
|
backend:
|
|
deploy:
|
|
resources:
|
|
limits:
|
|
cpus: '1'
|
|
memory: 1G
|
|
```
|
|
|
|
---
|
|
|
|
## Useful Docker Commands
|
|
|
|
```bash
|
|
# Remove everything (reset)
|
|
docker-compose down -v
|
|
|
|
# View logs since 1 hour ago
|
|
docker-compose logs --since 1h
|
|
|
|
# Execute command in backend
|
|
docker-compose exec backend python --version
|
|
|
|
# Shell access
|
|
docker-compose exec backend bash
|
|
docker-compose exec frontend sh
|
|
|
|
# Copy files from container
|
|
docker cp flight-radar-backend:/app/cache.db ./
|
|
|
|
# Network inspection
|
|
docker network inspect flight-comparator_flight-radar-network
|
|
```
|
|
|
|
---
|
|
|
|
## Files Created
|
|
|
|
- `Dockerfile.backend` - Backend container image
|
|
- `Dockerfile.frontend` - Frontend container image
|
|
- `docker-compose.yml` - Service orchestration
|
|
- `nginx.conf` - Nginx web server config
|
|
- `.env.example` - Environment template
|
|
- `.dockerignore` - Build optimization
|
|
|
|
---
|
|
|
|
## Resource Requirements
|
|
|
|
**Minimum:**
|
|
- CPU: 1 core
|
|
- RAM: 2GB
|
|
- Disk: 5GB
|
|
|
|
**Recommended:**
|
|
- CPU: 2 cores
|
|
- RAM: 4GB
|
|
- Disk: 10GB
|
|
|
|
---
|
|
|
|
## Next Steps
|
|
|
|
1. ✅ Start application: `docker-compose up -d`
|
|
2. ✅ Open browser: http://localhost
|
|
3. ✅ Create a scan
|
|
4. ✅ View results
|
|
5. ✅ Explore logs: http://localhost/logs
|
|
|
|
---
|
|
|
|
**Need help?** See [DEPLOYMENT.md](DEPLOYMENT.md) for detailed documentation.
|