Files
mockupAWS/docs/architecture.md
Luca Sacchi Ricciardi 59e5cf48f0 feat: initial project setup with scenarios, database and web ui
Add complete mockupAWS platform for AWS cost estimation:
- FastAPI backend with scenario management
- PostgreSQL database schema for scenarios, metrics, logs
- AWS pricing table with real pricing data
- React frontend dashboard (planned)
- PII detection and token counting
- Report generation (PDF/CSV)
- Complete test suite with pytest
- Docker Compose setup
- Documentation: README, PRD, Architecture
- OpenCode configuration (.opencode/)
2026-04-07 12:52:18 +02:00

1.4 KiB

Architecture Decision Records

Registro delle decisioni architetturali e dei pattern di design utilizzati.

Formato

## [YYYY-MM-DD] - [Titolo Decisione]

### Contesto
[Background e motivazione]

### Decisione
[Cosa è stato deciso]

### Conseguenze
- Positivo: [Benefici]
- Negativo: [Trade-off]

### Alternative Considerate
- [Alternativa 1]: [Perché scartata]
- [Alternativa 2]: [Perché scartata]

Esempio Template

2026-04-05 - Uso di FastAPI come framework API

Contesto

Necessità di un framework web async per l'API REST con documentazione OpenAPI automatica.

Decisione

Adottare FastAPI come framework principale per:

  • Supporto nativo async/await
  • Validazione automatica con Pydantic
  • Documentazione OpenAPI/Swagger integrata
  • Performance elevate

Conseguenze

  • Positivo:

    • Sviluppo più rapido con type hints
    • Documentazione API sempre aggiornata
    • Validazione input automatica
    • Supporto nativo async per I/O bound operations
  • Negativo:

    • Curva di apprendimento per sviluppatori nuovi
    • Dipendenza da Pydantic v2

Alternative Considerate

  • Flask: Scartato per mancanza di supporto async nativo
  • Django REST Framework: Scartato per essere troppo pesante per API-only
  • Starlette: Scartato in favore di FastAPI che include più funzionalità out-of-box

Aggiungere nuove decisioni in ordine cronologico crescente