Complete v0.5.0 implementation: Database (@db-engineer): - 3 migrations: users, api_keys, report_schedules tables - Foreign keys, indexes, constraints, enums Backend (@backend-dev): - JWT authentication service with bcrypt (cost=12) - Auth endpoints: /register, /login, /refresh, /me - API Keys service with hash storage and prefix validation - API Keys endpoints: CRUD + rotate - Security module with JWT HS256 Frontend (@frontend-dev): - Login/Register pages with validation - AuthContext with localStorage persistence - Protected routes implementation - API Keys management UI (create, revoke, rotate) - Header with user dropdown DevOps (@devops-engineer): - .env.example and .env.production.example - docker-compose.scheduler.yml - scripts/setup-secrets.sh - INFRASTRUCTURE_SETUP.md QA (@qa-engineer): - 85 E2E tests: auth.spec.ts, apikeys.spec.ts, scenarios.spec.ts, regression-v050.spec.ts - auth-helpers.ts with 20+ utility functions - Test plans and documentation Architecture (@spec-architect): - SECURITY.md with best practices - SECURITY-CHECKLIST.md pre-deployment - Updated architecture.md with auth flows - Updated README.md with v0.5.0 features Documentation: - Updated todo.md with v0.5.0 status - Added docs/README.md index - Complete setup instructions Dependencies added: - bcrypt, python-jose, passlib, email-validator Tested: JWT auth flow, API keys CRUD, protected routes, 85 E2E tests ready Closes: v0.5.0 milestone
mockupAWS Documentation
Versione: v0.5.0
Ultimo aggiornamento: 2026-04-07
📚 Indice Documentazione
Getting Started
- ../README.md - Panoramica progetto e quick start
- ../CHANGELOG.md - Storia versioni e cambiamenti
Architecture & Design
- ../export/architecture.md - Architettura sistema completa
- architecture.md - Schema architettura base
- ../export/kanban-v0.4.0.md - Task board v0.4.0
Security
- ../SECURITY.md - Security overview e best practices
- SECURITY-CHECKLIST.md - Pre-deployment checklist
Infrastructure
- INFRASTRUCTURE_SETUP.md - Setup email, cron, secrets
- ../docker-compose.yml - Docker orchestration
- ../docker-compose.scheduler.yml - Scheduler deployment
Development
- ../todo.md - Task list e prossimi passi
- bug_ledger.md - Bug tracking
- ../export/progress.md - Progress tracking
API Documentation
- Swagger UI: http://localhost:8000/docs (quando backend running)
- ../export/architecture.md - API specifications
Prompts & Planning
- ../prompt/prompt-v0.4.0-planning.md - Planning v0.4.0
- ../prompt/prompt-v0.4.0-kickoff.md - Kickoff v0.4.0
- ../prompt/prompt-v0.5.0-kickoff.md - Kickoff v0.5.0
🎯 Quick Reference
Setup Development
# 1. Clone
git clone <repository-url>
cd mockupAWS
# 2. Setup secrets
./scripts/setup-secrets.sh
# 3. Start database
docker-compose up -d postgres
# 4. Run migrations
uv run alembic upgrade head
# 5. Start backend
uv run uvicorn src.main:app --reload
# 6. Start frontend (altro terminale)
cd frontend && npm run dev
Testing
# Backend tests
cd /home/google/Sources/LucaSacchiNet/mockupAWS
pytest
# Frontend E2E tests
cd frontend
npm run test:e2e
# Specific test suites
npm run test:e2e -- auth.spec.ts
npm run test:e2e -- apikeys.spec.ts
API Endpoints
- Health:
GET /health - Auth:
POST /api/v1/auth/login,POST /api/v1/auth/register - API Keys:
GET /api/v1/api-keys,POST /api/v1/api-keys - Scenarios:
GET /api/v1/scenarios - Reports:
GET /api/v1/reports,POST /api/v1/scenarios/{id}/reports
📞 Supporto
- Issues: GitHub Issues
- Documentation: Questa directory
- API Docs: http://localhost:8000/docs
Per informazioni dettagliate su ogni componente, consultare i file linkati sopra.