cc60ba17ea
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
101 lines
2.7 KiB
Markdown
101 lines
2.7 KiB
Markdown
# mockupAWS Documentation
|
|
|
|
> **Versione:** v0.5.0
|
|
> **Ultimo aggiornamento:** 2026-04-07
|
|
|
|
---
|
|
|
|
## 📚 Indice Documentazione
|
|
|
|
### Getting Started
|
|
- [../README.md](../README.md) - Panoramica progetto e quick start
|
|
- [../CHANGELOG.md](../CHANGELOG.md) - Storia versioni e cambiamenti
|
|
|
|
### Architecture & Design
|
|
- [../export/architecture.md](../export/architecture.md) - Architettura sistema completa
|
|
- [architecture.md](./architecture.md) - Schema architettura base
|
|
- [../export/kanban-v0.4.0.md](../export/kanban-v0.4.0.md) - Task board v0.4.0
|
|
|
|
### Security
|
|
- [../SECURITY.md](../SECURITY.md) - Security overview e best practices
|
|
- [SECURITY-CHECKLIST.md](./SECURITY-CHECKLIST.md) - Pre-deployment checklist
|
|
|
|
### Infrastructure
|
|
- [INFRASTRUCTURE_SETUP.md](./INFRASTRUCTURE_SETUP.md) - Setup email, cron, secrets
|
|
- [../docker-compose.yml](../docker-compose.yml) - Docker orchestration
|
|
- [../docker-compose.scheduler.yml](../docker-compose.scheduler.yml) - Scheduler deployment
|
|
|
|
### Development
|
|
- [../todo.md](../todo.md) - Task list e prossimi passi
|
|
- [bug_ledger.md](./bug_ledger.md) - Bug tracking
|
|
- [../export/progress.md](../export/progress.md) - Progress tracking
|
|
|
|
### API Documentation
|
|
- **Swagger UI:** http://localhost:8000/docs (quando backend running)
|
|
- [../export/architecture.md](../export/architecture.md) - API specifications
|
|
|
|
### Prompts & Planning
|
|
- [../prompt/prompt-v0.4.0-planning.md](../prompt/prompt-v0.4.0-planning.md) - Planning v0.4.0
|
|
- [../prompt/prompt-v0.4.0-kickoff.md](../prompt/prompt-v0.4.0-kickoff.md) - Kickoff v0.4.0
|
|
- [../prompt/prompt-v0.5.0-kickoff.md](../prompt/prompt-v0.5.0-kickoff.md) - Kickoff v0.5.0
|
|
|
|
---
|
|
|
|
## 🎯 Quick Reference
|
|
|
|
### Setup Development
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# 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.*
|