# 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.*