docs: complete architecture specifications and project planning
Add comprehensive technical specifications for mockupAWS v0.2.0: - export/architecture.md: Complete system architecture with: * Layered architecture diagram (Client → API → Service → Repository → DB) * Full database schema with DDL SQL (5 tables, indexes, constraints) * API specifications (OpenAPI format) for all endpoints * Security architecture (auth, PII detection, rate limiting) * Data flow diagrams (ingestion, cost calculation, state machine) * Technology stack details (backend, frontend, infrastructure) * Project structure for backend and frontend * 4 Architecture Decision Records (DEC-001 to DEC-004) - export/kanban.md: Task breakdown with 32 tasks organized in: * Database setup (DB-001 to DB-007) * Backend models/schemas (BE-001 to BE-003) * Backend repositories (BE-004 to BE-008) * Backend services (BE-009 to BE-014) * Backend API (BE-015 to BE-020) * Testing (QA-001 to QA-003) - export/progress.md: Project tracking initialized with: * Current status: 0% complete, Fase 1 setup * Sprint planning and metrics * Resource links and team assignments All specifications follow 'Little Often' principle with tasks < 2 hours.
This commit is contained in:
Luca Sacchi Ricciardi
File diff suppressed because it is too large
Load Diff
730
export/kanban.md
730
export/kanban.md
@@ -1,116 +1,724 @@
|
||||
# Kanban Board (Export)
|
||||
# Kanban - mockupAWS
|
||||
|
||||
> Scomposizione del progetto in task minimi e verificabili.
|
||||
|
||||
## Istruzioni
|
||||
|
||||
Questo file deve essere creato/aggiornato dall'agente `@spec-architect` durante la fase di analisi.
|
||||
|
||||
## Principio "Little Often"
|
||||
|
||||
- Task il più piccoli possibile
|
||||
- Ogni task verificabile in <2 ore
|
||||
- Progresso incrementale
|
||||
- Dipendenze chiare
|
||||
> **Progetto:** mockupAWS - Backend Profiler & Cost Estimator
|
||||
> **Versione Target:** v0.2.0
|
||||
> **Data:** 2026-04-07
|
||||
> **Principio:** Little Often - Task < 2 ore
|
||||
|
||||
---
|
||||
|
||||
## Stati
|
||||
## Legenda
|
||||
|
||||
- 🔴 **TODO** - Da fare
|
||||
- 🟡 **IN PROGRESS** - In corso
|
||||
- 🟢 **DONE** - Completato
|
||||
- ⚪ **BLOCKED** - Bloccato (vedi dipendenze)
|
||||
- ⚪ **BLOCKED** - Bloccato
|
||||
|
||||
**Stime:** XS (15-30min) | S (30-60min) | M (1-2h) | L (2-4h) | XL (>4h, da spezzare)
|
||||
|
||||
---
|
||||
|
||||
## Template
|
||||
## 🔴 TODO - Fase 1: Database & Backend Core
|
||||
|
||||
```markdown
|
||||
# Kanban - [Nome Progetto]
|
||||
### Database Setup (DB-001 → DB-006)
|
||||
|
||||
## Colonna: 🔴 TODO
|
||||
#### DB-001: Alembic Setup
|
||||
**Assegnato:** @db-engineer
|
||||
**Priorità:** Alta
|
||||
**Stima:** S
|
||||
|
||||
**Descrizione:**
|
||||
Configurare Alembic per migrazioni database async.
|
||||
|
||||
### Task-001: [Titolo task]
|
||||
**Descrizione:** [Breve descrizione]
|
||||
**Criteri Done:**
|
||||
- [ ] Criterio 1
|
||||
- [ ] Criterio 2
|
||||
**Dipendenze:** Nessuna / Task-XXX
|
||||
**Stima:** XS(1h) / S(2h) / M(4h) / L(8h)
|
||||
**Assegnato:** @agent
|
||||
- [ ] Installare alembic e asyncpg
|
||||
- [ ] Inizializzare `alembic init`
|
||||
- [ ] Configurare `alembic.ini` con async URL
|
||||
- [ ] Configurare `alembic/env.py` per SQLAlchemy 2.0 async
|
||||
- [ ] Testare `alembic current` (connessione OK)
|
||||
|
||||
**Files:**
|
||||
- `backend/alembic.ini`
|
||||
- `backend/alembic/env.py`
|
||||
|
||||
---
|
||||
|
||||
## Colonna: 🟡 IN PROGRESS
|
||||
#### DB-002: Migration - Scenarios Table
|
||||
**Assegnato:** @db-engineer
|
||||
**Priorità:** Alta
|
||||
**Stima:** M
|
||||
**Dipende da:** DB-001
|
||||
|
||||
### Task-XXX: [Titolo]
|
||||
**Iniziato:** YYYY-MM-DD
|
||||
**Assegnato:** @agent
|
||||
**Descrizione:**
|
||||
Creare migrazione per tabella scenarios con tutti i campi e constraints.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare migration `001_create_scenarios_table.py`
|
||||
- [ ] Definire tutti i campi (id, name, description, tags, status, region, timestamps, totals)
|
||||
- [ ] Aggiungere constraints (CHK, FK)
|
||||
- [ ] Aggiungere indexes (status, region, created_at, tags)
|
||||
- [ ] Creare trigger updated_at
|
||||
- [ ] Testare `alembic upgrade head`
|
||||
|
||||
**SQL Reference:** Vedere `export/architecture.md` sezione 3.2
|
||||
|
||||
---
|
||||
|
||||
## Colonna: 🟢 DONE
|
||||
#### DB-003: Migration - Scenario Logs Table
|
||||
**Assegnato:** @db-engineer
|
||||
**Priorità:** Alta
|
||||
**Stima:** M
|
||||
**Dipende da:** DB-002
|
||||
|
||||
### Task-XXX: [Titolo]
|
||||
**Completato:** YYYY-MM-DD
|
||||
**Commit:** `feat: ...`
|
||||
**Descrizione:**
|
||||
Creare migrazione per tabella scenario_logs.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare migration `002_create_scenario_logs_table.py`
|
||||
- [ ] Definire campi (id, scenario_id, timestamps, hash, preview, etc.)
|
||||
- [ ] Aggiungere FK a scenarios con ON DELETE CASCADE
|
||||
- [ ] Aggiungere indexes (scenario_id, received_at, hash, has_pii)
|
||||
- [ ] Testare relazione con scenarios
|
||||
|
||||
---
|
||||
|
||||
## Colonna: ⚪ BLOCKED
|
||||
#### DB-004: Migration - Scenario Metrics Table
|
||||
**Assegnato:** @db-engineer
|
||||
**Priorità:** Alta
|
||||
**Stima:** M
|
||||
**Dipende da:** DB-002
|
||||
|
||||
### Task-XXX: [Titolo]
|
||||
**Bloccato da:** Task-YYY
|
||||
**Motivo:** [Spiegazione]
|
||||
**Descrizione:**
|
||||
Creare migrazione per tabella scenario_metrics (time-series).
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare migration `003_create_scenario_metrics_table.py`
|
||||
- [ ] Definire campi per metriche time-series
|
||||
- [ ] Aggiungere indexes (scenario_id, timestamp, metric_type)
|
||||
- [ ] Testare query aggregazione
|
||||
|
||||
---
|
||||
|
||||
#### DB-005: Migration - AWS Pricing Table
|
||||
**Assegnato:** @db-engineer
|
||||
**Priorità:** Alta
|
||||
**Stima:** M
|
||||
**Dipende da:** DB-002
|
||||
|
||||
**Descrizione:**
|
||||
Creare migrazione per tabella aws_pricing con storico prezzi.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare migration `004_create_aws_pricing_table.py`
|
||||
- [ ] Definire campi (service, region, tier, price, unit, dates)
|
||||
- [ ] Aggiungere constraints (price > 0, valid dates)
|
||||
- [ ] Aggiungere unique constraint parziale per active prices
|
||||
- [ ] Testare query get_active_pricing
|
||||
|
||||
---
|
||||
|
||||
#### DB-006: Migration - Reports Table
|
||||
**Assegnato:** @db-engineer
|
||||
**Priorità:** Media
|
||||
**Stima:** S
|
||||
**Dipende da:** DB-002
|
||||
|
||||
**Descrizione:**
|
||||
Creare migrazione per tabella reports.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare migration `005_create_reports_table.py`
|
||||
- [ ] Definire campi (format, file_path, metadata)
|
||||
- [ ] Aggiungere indexes
|
||||
|
||||
---
|
||||
|
||||
#### DB-007: Seed AWS Pricing Data
|
||||
**Assegnato:** @db-engineer
|
||||
**Priorità:** Alta
|
||||
**Stima:** M
|
||||
**Dipende da:** DB-005
|
||||
|
||||
**Descrizione:**
|
||||
Popolare tabella aws_pricing con dati reali.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare migration `006_seed_aws_pricing.py` (opzionale: file separato)
|
||||
- [ ] Inserire prezzi per us-east-1:
|
||||
- SQS: $0.40 per milione richieste
|
||||
- Lambda Request: $0.20 per milione
|
||||
- Lambda Compute: $0.0000166667 per GB-second
|
||||
- Bedrock Claude Input: $0.003 per 1K tokens
|
||||
- Bedrock Claude Output: $0.015 per 1K tokens
|
||||
- [ ] Inserire prezzi per eu-west-1 (simili)
|
||||
- [ ] Verificare dati inseriti
|
||||
|
||||
**Dati:** Vedere `export/prd.md` sezione 4.3
|
||||
|
||||
---
|
||||
|
||||
### Backend - Database Layer (BE-001 → BE-005)
|
||||
|
||||
#### BE-001: Database Connection & Session Management
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** M
|
||||
**Dipende da:** DB-001
|
||||
|
||||
**Descrizione:**
|
||||
Configurare SQLAlchemy 2.0 async con gestione sessioni.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/core/database.py`
|
||||
- [ ] Configurare `create_async_engine` con pool
|
||||
- [ ] Creare `AsyncSessionLocal` factory
|
||||
- [ ] Creare `get_db()` dependency per FastAPI
|
||||
- [ ] Testare connessione in test
|
||||
|
||||
**Codice Target:**
|
||||
```python
|
||||
# core/database.py
|
||||
from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession
|
||||
from sqlalchemy.orm import sessionmaker
|
||||
|
||||
engine = create_async_engine(DATABASE_URL, echo=True, future=True)
|
||||
AsyncSessionLocal = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)
|
||||
|
||||
async def get_db():
|
||||
async with AsyncSessionLocal() as session:
|
||||
yield session
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Esempio Board
|
||||
#### BE-002: SQLAlchemy Models
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** L
|
||||
**Dipende da:** BE-001
|
||||
|
||||
# Kanban - [NOME_PROGETTO]
|
||||
**Descrizione:**
|
||||
Creare tutti i modelli SQLAlchemy corrispondenti alle tabelle.
|
||||
|
||||
## 🔴 TODO
|
||||
|
||||
### TASK-001: Setup progetto base
|
||||
**Descrizione:** Inizializzare struttura progetto Python con uv
|
||||
**Criteri Done:**
|
||||
- [ ] pyproject.toml configurato
|
||||
- [ ] Struttura cartelle src/
|
||||
- [ ] Pre-commit hooks installati
|
||||
**Dipendenze:** Nessuna
|
||||
**Stima:** XS
|
||||
**Assegnato:** @tdd-developer
|
||||
- [ ] Creare `backend/src/models/base.py` (Base, TimestampMixin)
|
||||
- [ ] Creare `scenario.py` (Scenario model)
|
||||
- [ ] Creare `scenario_log.py` (ScenarioLog model)
|
||||
- [ ] Creare `scenario_metric.py` (ScenarioMetric model)
|
||||
- [ ] Creare `aws_pricing.py` (AwsPricing model)
|
||||
- [ ] Creare `report.py` (Report model)
|
||||
- [ ] Definire tutte le relationships
|
||||
- [ ] Testare models (creazione istanze)
|
||||
|
||||
**Files:**
|
||||
- `backend/src/models/__init__.py`
|
||||
- `backend/src/models/base.py`
|
||||
- `backend/src/models/scenario.py`
|
||||
- `backend/src/models/scenario_log.py`
|
||||
- `backend/src/models/scenario_metric.py`
|
||||
- `backend/src/models/aws_pricing.py`
|
||||
- `backend/src/models/report.py`
|
||||
|
||||
---
|
||||
|
||||
#### BE-003: Pydantic Schemas
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** M
|
||||
**Dipende da:** BE-002
|
||||
|
||||
**Descrizione:**
|
||||
Creare Pydantic schemas per request/response validation.
|
||||
|
||||
### TASK-002: Implementare NotebookService.create()
|
||||
**Descrizione:** Servizio per creazione notebook con validazione
|
||||
**Criteri Done:**
|
||||
- [ ] Test unitari passanti
|
||||
- [ ] Validazione titolo
|
||||
- [ ] Integrazione notebooklm-py
|
||||
**Dipendenze:** TASK-001
|
||||
- [ ] Creare `backend/src/schemas/scenario.py`
|
||||
- ScenarioCreate, ScenarioUpdate, ScenarioResponse, ScenarioList
|
||||
- [ ] Creare `backend/src/schemas/log.py`
|
||||
- LogIngest, LogResponse
|
||||
- [ ] Creare `backend/src/schemas/metric.py`
|
||||
- MetricSummary, CostBreakdown
|
||||
- [ ] Creare `backend/src/schemas/pricing.py`
|
||||
- PricingResponse, PricingUpdate
|
||||
- [ ] Creare `backend/src/schemas/report.py`
|
||||
- ReportRequest, ReportResponse
|
||||
- [ ] Validators per campi (name not empty, valid region, etc.)
|
||||
|
||||
---
|
||||
|
||||
### Backend - Repository Layer (BE-004 → BE-008)
|
||||
|
||||
#### BE-004: Base Repository
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** M
|
||||
**Dipende da:** BE-002
|
||||
|
||||
**Descrizione:**
|
||||
Implementare Base Repository con operazioni CRUD generiche.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/repositories/base.py`
|
||||
- [ ] Implementare `BaseRepository` class (Generic[T])
|
||||
- [ ] Metodi: get(), list(), create(), update(), delete(), count()
|
||||
- [ ] Supporto per filters e pagination
|
||||
- [ ] Type hints completi
|
||||
|
||||
**Codice Target:**
|
||||
```python
|
||||
class BaseRepository(Generic[T]):
|
||||
def __init__(self, model: Type[T]):
|
||||
self.model = model
|
||||
|
||||
async def get(self, db: AsyncSession, id: UUID) -> T | None:
|
||||
result = await db.execute(select(self.model).where(self.model.id == id))
|
||||
return result.scalar_one_or_none()
|
||||
|
||||
async def list(self, db: AsyncSession, skip: int = 0, limit: int = 100, **filters) -> list[T]:
|
||||
query = select(self.model)
|
||||
for key, value in filters.items():
|
||||
query = query.where(getattr(self.model, key) == value)
|
||||
query = query.offset(skip).limit(limit)
|
||||
result = await db.execute(query)
|
||||
return result.scalars().all()
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### BE-005: Scenario Repository
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** M
|
||||
**Dipende da:** BE-004
|
||||
|
||||
**Descrizione:**
|
||||
Implementare ScenarioRepository con metodi specifici.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/repositories/scenario_repo.py`
|
||||
- [ ] Estendere BaseRepository
|
||||
- [ ] Metodi specifici:
|
||||
- `get_by_name()`
|
||||
- `list_by_status()`
|
||||
- `list_by_region()`
|
||||
- `update_status()`
|
||||
- `increment_total_requests()`
|
||||
- `update_total_cost()`
|
||||
- [ ] Testare tutti i metodi
|
||||
|
||||
---
|
||||
|
||||
#### BE-006: Log Repository
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** S
|
||||
**Assegnato:** @tdd-developer
|
||||
**Dipende da:** BE-004
|
||||
|
||||
**Descrizione:**
|
||||
Implementare LogRepository.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/repositories/log_repo.py`
|
||||
- [ ] Metodi specifici:
|
||||
- `get_by_hash()` - per deduplicazione
|
||||
- `list_by_scenario()`
|
||||
- `count_by_scenario()`
|
||||
- `count_pii_by_scenario()`
|
||||
|
||||
---
|
||||
|
||||
#### BE-007: Metric Repository
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Media
|
||||
**Stima:** S
|
||||
**Dipende da:** BE-004
|
||||
|
||||
**Descrizione:**
|
||||
Implementare MetricRepository.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/repositories/metric_repo.py`
|
||||
- [ ] Metodi specifici:
|
||||
- `get_aggregated_by_scenario()`
|
||||
- `list_by_type()`
|
||||
- `get_cost_breakdown()`
|
||||
|
||||
---
|
||||
|
||||
#### BE-008: Pricing Repository
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** S
|
||||
**Dipende da:** BE-004
|
||||
|
||||
**Descrizione:**
|
||||
Implementare PricingRepository.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/repositories/pricing_repo.py`
|
||||
- [ ] Metodi specifici:
|
||||
- `get_active_by_service_region()` - CRITICO per calcolo costi
|
||||
- `list_active()`
|
||||
|
||||
---
|
||||
|
||||
### Backend - Service Layer (BE-009 → BE-014)
|
||||
|
||||
#### BE-009: Cost Calculator Service
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** M
|
||||
**Dipende da:** BE-008
|
||||
|
||||
**Descrizione:**
|
||||
Implementare servizio calcolo costi usando prezzi da database.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/services/cost_calculator.py`
|
||||
- [ ] Metodi:
|
||||
- `calculate_sqs_cost(blocks, region)`
|
||||
- `calculate_lambda_cost(invocations, gb_seconds, region)`
|
||||
- `calculate_bedrock_cost(input_tokens, output_tokens, region)`
|
||||
- `calculate_total_cost(log_entry, region)`
|
||||
- [ ] Query pricing repository per prezzi attivi
|
||||
- [ ] Formule corrette (vedi architecture.md)
|
||||
- [ ] Unit tests con mock pricing
|
||||
|
||||
---
|
||||
|
||||
#### BE-010: Scenario Service
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** L
|
||||
**Dipende da:** BE-005
|
||||
|
||||
**Descrizione:**
|
||||
Implementare ScenarioService con business logic.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/services/scenario_service.py`
|
||||
- [ ] Metodi CRUD:
|
||||
- `create_scenario(data)`
|
||||
- `get_scenario(id)`
|
||||
- `list_scenarios(filters, pagination)`
|
||||
- `update_scenario(id, data)`
|
||||
- `delete_scenario(id)`
|
||||
- [ ] Metodi lifecycle:
|
||||
- `start_scenario(id)` - draft → running
|
||||
- `stop_scenario(id)` - running → completed
|
||||
- `archive_scenario(id)` - completed → archived
|
||||
- [ ] Validazioni (name unique, valid transitions)
|
||||
- [ ] Unit tests
|
||||
|
||||
---
|
||||
|
||||
#### BE-011: Ingest Service
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** L
|
||||
**Dipende da:** BE-006, BE-009
|
||||
|
||||
**Descrizione:**
|
||||
Implementare IngestService per elaborazione log.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/services/ingest_service.py`
|
||||
- [ ] Metodi:
|
||||
- `ingest_log(scenario_id, log_data)` - MAIN METHOD
|
||||
- `validate_scenario(scenario_id)` - check status == running
|
||||
- `process_log(log_data)` - calcola metriche
|
||||
- `persist_log(scenario_id, processed_log)` - salva su DB
|
||||
- `update_scenario_metrics(scenario_id, metrics)`
|
||||
- [ ] Integrare PII detection
|
||||
- [ ] Integrare token counting
|
||||
- [ ] Integrare SQS block calculation
|
||||
- [ ] Integrare cost calculator
|
||||
- [ ] Transaction management (DB commit)
|
||||
|
||||
---
|
||||
|
||||
#### BE-012: PII Detector Service
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Media
|
||||
**Stima:** S
|
||||
**Dipende da:** None
|
||||
|
||||
**Descrizione:**
|
||||
Implementare servizio rilevamento PII (estrazione da main.py attuale).
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/services/pii_detector.py`
|
||||
- [ ] Pattern regex per:
|
||||
- Email
|
||||
- SSN (opzionale)
|
||||
- Credit card (opzionale)
|
||||
- Phone (opzionale)
|
||||
- [ ] Metodo `detect(message) -> dict`
|
||||
- [ ] Unit tests con vari input
|
||||
|
||||
---
|
||||
|
||||
#### BE-013: Report Service (Base)
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Media
|
||||
**Stima:** M
|
||||
**Dipende da:** BE-007
|
||||
|
||||
**Descrizione:**
|
||||
Implementare ReportService per generazione CSV.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/services/report_service.py`
|
||||
- [ ] Metodi:
|
||||
- `generate_csv(scenario_id)` - CSV export
|
||||
- `compile_metrics(scenario_id)` - aggrega dati
|
||||
- [ ] CSV format con headers
|
||||
- [ ] Unit tests
|
||||
|
||||
---
|
||||
|
||||
#### BE-014: Tokenizer Service (Refactor)
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Bassa
|
||||
**Stima:** XS
|
||||
**Dipende da:** None
|
||||
|
||||
**Descrizione:**
|
||||
Refactor profilera esistente in servizio.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/services/tokenizer_service.py`
|
||||
- [ ] Spostare logica da `src/profiler.py`
|
||||
- [ ] Mantenere encoding cl100k_base
|
||||
|
||||
---
|
||||
|
||||
### Backend - API Layer (BE-015 → BE-020)
|
||||
|
||||
#### BE-015: API Dependencies & Error Handling
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** M
|
||||
**Dipende da:** None
|
||||
|
||||
**Descrizione:**
|
||||
Configurare FastAPI dependencies e exception handlers.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/api/deps.py`
|
||||
- `get_db()` - DB session
|
||||
- `get_current_scenario()` - scenario validation
|
||||
- [ ] Creare `backend/src/core/exceptions.py`
|
||||
- AppException base
|
||||
- NotFoundException
|
||||
- ValidationException
|
||||
- ConflictException
|
||||
- [ ] Creare exception handlers in `main.py`
|
||||
- [ ] Global error response format
|
||||
|
||||
---
|
||||
|
||||
#### BE-016: Scenarios API Endpoints
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** L
|
||||
**Dipende da:** BE-010, BE-015
|
||||
|
||||
**Descrizione:**
|
||||
Implementare tutti gli endpoint CRUD per scenari.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/api/v1/scenarios.py`
|
||||
- [ ] Endpoints:
|
||||
- `POST /api/v1/scenarios` - Create
|
||||
- `GET /api/v1/scenarios` - List (con pagination, filters)
|
||||
- `GET /api/v1/scenarios/{id}` - Get detail
|
||||
- `PUT /api/v1/scenarios/{id}` - Update
|
||||
- `DELETE /api/v1/scenarios/{id}` - Delete
|
||||
- `POST /api/v1/scenarios/{id}/start` - Start
|
||||
- `POST /api/v1/scenarios/{id}/stop` - Stop
|
||||
- `POST /api/v1/scenarios/{id}/archive` - Archive
|
||||
- [ ] Integrare schemas per request/response
|
||||
- [ ] Integration tests
|
||||
|
||||
---
|
||||
|
||||
#### BE-017: Ingest API Endpoint (Refactor)
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** M
|
||||
**Dipende da:** BE-011, BE-016
|
||||
|
||||
**Descrizione:**
|
||||
Aggiornare endpoint `/ingest` esistente per usare database.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Refactor `backend/src/api/v1/ingest.py`
|
||||
- [ ] Aggiungere header `X-Scenario-ID` required
|
||||
- [ ] Validare scenario esiste e status == running
|
||||
- [ ] Usare IngestService per elaborazione
|
||||
- [ ] Rimuovere stato in-memory (mantenere solo per cache)
|
||||
- [ ] Response 202 Accepted con log_id
|
||||
- [ ] Integration tests
|
||||
|
||||
---
|
||||
|
||||
#### BE-018: Metrics API Endpoint
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** M
|
||||
**Dipende da:** BE-017
|
||||
|
||||
**Descrizione:**
|
||||
Implementare endpoint metrics per scenari.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/api/v1/metrics.py`
|
||||
- [ ] Endpoints:
|
||||
- `GET /api/v1/scenarios/{id}/metrics` - Summary metrics
|
||||
- `GET /api/v1/scenarios/{id}/metrics/costs` - Cost breakdown
|
||||
- `GET /api/v1/scenarios/{id}/metrics/timeseries` - Time series
|
||||
- [ ] Aggregare dati da scenario_logs e scenario_metrics
|
||||
- [ ] Integration tests
|
||||
|
||||
---
|
||||
|
||||
#### BE-019: Pricing API Endpoints (Admin)
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Media
|
||||
**Stima:** S
|
||||
**Dipende da:** BE-016
|
||||
|
||||
**Descrizione:**
|
||||
Implementare endpoint per gestione prezzi.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/api/v1/pricing.py`
|
||||
- [ ] Endpoints:
|
||||
- `GET /api/v1/pricing` - List
|
||||
- `POST /api/v1/pricing` - Create (admin)
|
||||
- `PUT /api/v1/pricing/{id}` - Update (admin)
|
||||
- [ ] Integration tests
|
||||
|
||||
---
|
||||
|
||||
#### BE-020: Reports API Endpoint
|
||||
**Assegnato:** @backend-dev
|
||||
**Priorità:** Media
|
||||
**Stima:** S
|
||||
**Dipende da:** BE-013
|
||||
|
||||
**Descrizione:**
|
||||
Implementare endpoint report generation.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] Creare `backend/src/api/v1/reports.py`
|
||||
- [ ] Endpoints:
|
||||
- `POST /api/v1/scenarios/{id}/reports` - Generate
|
||||
- `GET /api/v1/reports/{id}/download` - Download
|
||||
- [ ] Supporto format CSV (PDF future)
|
||||
- [ ] Integration tests
|
||||
|
||||
---
|
||||
|
||||
### Testing (QA-001 → QA-005)
|
||||
|
||||
#### QA-001: Unit Tests - Services
|
||||
**Assegnato:** @qa-engineer + @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** L
|
||||
**Dipende da:** BE-009, BE-010, BE-011
|
||||
|
||||
**Descrizione:**
|
||||
Scrivere unit tests per tutti i services.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] `tests/unit/test_cost_calculator.py`
|
||||
- [ ] `tests/unit/test_scenario_service.py`
|
||||
- [ ] `tests/unit/test_ingest_service.py`
|
||||
- [ ] `tests/unit/test_pii_detector.py`
|
||||
- [ ] Mock repositories per isolamento
|
||||
- [ ] Coverage > 80% per service
|
||||
|
||||
---
|
||||
|
||||
#### QA-002: Integration Tests - API
|
||||
**Assegnato:** @qa-engineer + @backend-dev
|
||||
**Priorità:** Alta
|
||||
**Stima:** L
|
||||
**Dipende da:** BE-016, BE-017, BE-018
|
||||
|
||||
**Descrizione:**
|
||||
Scrivere integration tests per API endpoints.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] `tests/integration/test_api_scenarios.py`
|
||||
- [ ] `tests/integration/test_api_ingest.py`
|
||||
- [ ] `tests/integration/test_api_metrics.py`
|
||||
- [ ] Test database con rollback per test
|
||||
- [ ] Test fixtures per dati
|
||||
|
||||
---
|
||||
|
||||
#### QA-003: E2E Test - Full Flow
|
||||
**Assegnato:** @qa-engineer
|
||||
**Priorità:** Media
|
||||
**Stima:** M
|
||||
**Dipende da:** QA-002
|
||||
|
||||
**Descrizione:**
|
||||
Test end-to-end del flusso completo.
|
||||
|
||||
**Criteri Done:**
|
||||
- [ ] `tests/e2e/test_full_flow.py`
|
||||
- [ ] Flow: Create → Start → Ingest 10 logs → Get Metrics → Stop
|
||||
- [ ] Verifica costi calcolati correttamente
|
||||
|
||||
---
|
||||
|
||||
## 🟡 IN PROGRESS
|
||||
|
||||
*Vuoto*
|
||||
*Vuoto - In attesa inizio Fase 1*
|
||||
|
||||
---
|
||||
|
||||
## 🟢 DONE
|
||||
|
||||
*Vuoto*
|
||||
*Vuoto - Progetto appena iniziato*
|
||||
|
||||
---
|
||||
|
||||
## ⚪ BLOCKED
|
||||
|
||||
*Vuoto*
|
||||
*Vuoto - Nessun blocco attuale*
|
||||
|
||||
---
|
||||
|
||||
*Questo file verrà popolato durante la fase di specifica*
|
||||
## 📊 Summary
|
||||
|
||||
| Fase | Task Totali | Completati | In Progress | Todo |
|
||||
|------|-------------|------------|-------------|------|
|
||||
| Fase 1 - Database | 7 | 0 | 0 | 7 |
|
||||
| Fase 1 - Backend DB | 5 | 0 | 0 | 5 |
|
||||
| Fase 1 - Backend Repo | 5 | 0 | 0 | 5 |
|
||||
| Fase 1 - Backend Service | 6 | 0 | 0 | 6 |
|
||||
| Fase 1 - Backend API | 6 | 0 | 0 | 6 |
|
||||
| Fase 1 - Testing | 3 | 0 | 0 | 3 |
|
||||
| **TOTALE** | **32** | **0** | **0** | **32** |
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Priorità per Sprint 1 (Week 1)
|
||||
|
||||
**Goal:** Database pronto e API base funzionanti
|
||||
|
||||
1. DB-001 → DB-003 (Database setup e prime 2 tabelle)
|
||||
2. BE-001 → BE-003 (Connessione e models)
|
||||
3. BE-004 → BE-005 (Base repo e scenario repo)
|
||||
4. BE-009 (Cost calculator - critico)
|
||||
5. BE-015 → BE-016 (API base e scenarios CRUD)
|
||||
|
||||
---
|
||||
|
||||
*Documento creato da @spec-architect*
|
||||
*Versione: 1.0*
|
||||
*Data: 2026-04-07*
|
||||
|
||||
@@ -1,48 +1,64 @@
|
||||
# Progress Tracking - [NOME_PROGETTO]
|
||||
# Progress Tracking - mockupAWS
|
||||
|
||||
> Tracciamento progresso sviluppo in tempo reale.
|
||||
> **Progetto:** mockupAWS - Backend Profiler & Cost Estimator
|
||||
> **Versione Target:** v0.2.0
|
||||
> **Data Inizio:** 2026-04-07
|
||||
> **Data Ultimo Aggiornamento:** 2026-04-07
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Sprint/Feature Corrente
|
||||
|
||||
**Feature:** `[Nome feature in sviluppo]`
|
||||
**Iniziata:** `YYYY-MM-DD`
|
||||
**Stato:** 🔴 Pianificazione / 🟡 In sviluppo / 🟢 Completata
|
||||
**Assegnato:** `@agent`
|
||||
**Feature:** Fase 1 - Database e Backend API Core
|
||||
**Iniziata:** 2026-04-07
|
||||
**Stato:** 🔴 Pianificazione / Setup
|
||||
**Assegnato:** @spec-architect (coordinamento), @db-engineer, @backend-dev
|
||||
|
||||
---
|
||||
|
||||
## 📊 Progresso Complessivo
|
||||
|
||||
| Area | Progresso | Stato |
|
||||
|------|-----------|-------|
|
||||
| API Core | 0/10 task | 🔴 Non iniziato |
|
||||
| Webhook System | 0/5 task | 🔴 Non iniziato |
|
||||
| AI Skill | 0/3 task | 🔴 Non iniziato |
|
||||
| Testing | 0/8 task | 🔴 Non iniziato |
|
||||
| Documentazione | 0/4 task | 🔴 Non iniziato |
|
||||
|
||||
**Completamento Totale:** 0%
|
||||
| Area | Task Totali | Completati | Progresso | Stato |
|
||||
|------|-------------|------------|-----------|-------|
|
||||
| Database (Migrazioni) | 7 | 0 | 0% | 🔴 Non iniziato |
|
||||
| Backend - Models/Schemas | 5 | 0 | 0% | 🔴 Non iniziato |
|
||||
| Backend - Repository | 5 | 0 | 0% | 🔴 Non iniziato |
|
||||
| Backend - Services | 6 | 0 | 0% | 🔴 Non iniziato |
|
||||
| Backend - API | 6 | 0 | 0% | 🔴 Non iniziato |
|
||||
| Testing | 3 | 0 | 0% | 🔴 Non iniziato |
|
||||
| Frontend | 0 | 0 | 0% | ⚪ Fase 2 |
|
||||
| DevOps | 0 | 0 | 0% | ⚪ Fase 3 |
|
||||
| **Completamento Totale** | **32** | **0** | **0%** | 🔴 **Setup** |
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Attività in Corso
|
||||
|
||||
### Task Corrente: `[ID-XXX] - Titolo`
|
||||
### Task Corrente: Architettura e Specifiche
|
||||
|
||||
| Campo | Valore |
|
||||
|-------|--------|
|
||||
| **ID** | TASK-XXX |
|
||||
| **Descrizione** | [Breve descrizione] |
|
||||
| **Iniziata** | YYYY-MM-DD HH:MM |
|
||||
| **Assegnato** | @agent |
|
||||
| **ID** | SPEC-001 |
|
||||
| **Descrizione** | Creare architecture.md completo con schema DB, API specs, sicurezza |
|
||||
| **Iniziata** | 2026-04-07 12:00 |
|
||||
| **Assegnato** | @spec-architect |
|
||||
| **Stato** | 🟡 In progress |
|
||||
| **Bloccata da** | Nessuna / TASK-YYY |
|
||||
| **Note** | [Eventuali ostacoli, decisioni] |
|
||||
| **Bloccata da** | Nessuna |
|
||||
| **Note** | Completato architecture.md, in corso kanban.md e progress.md |
|
||||
|
||||
**Passi completati:**
|
||||
- [x] Passo 1
|
||||
- [ ] Passo 2
|
||||
- [ ] Passo 3
|
||||
- [x] Analisi PRD completo
|
||||
- [x] Analisi codice esistente (main.py, profiler.py)
|
||||
- [x] Creazione architecture.md con:
|
||||
- [x] Stack tecnologico dettagliato
|
||||
- [x] Schema database completo (DDL SQL)
|
||||
- [x] API specifications (OpenAPI)
|
||||
- [x] Architettura a layer
|
||||
- [x] Diagrammi flusso dati
|
||||
- [x] Piano sicurezza
|
||||
- [x] Struttura progetto finale
|
||||
- [x] Creazione kanban.md con task breakdown
|
||||
- [x] Creazione progress.md (questo file)
|
||||
|
||||
---
|
||||
|
||||
@@ -50,16 +66,22 @@
|
||||
|
||||
| ID | Task | Completata | Commit | Assegnato |
|
||||
|----|------|------------|--------|-----------|
|
||||
| | | | | |
|
||||
| - | Nessuna task completata oggi - Setup iniziale | - | - | - |
|
||||
|
||||
---
|
||||
|
||||
## 📅 Prossime Task
|
||||
## 📅 Prossime Task (Priorità P1)
|
||||
|
||||
| Priority | ID | Task | Stima | Dipendenze |
|
||||
|----------|----|------|-------|------------|
|
||||
| P1 | | | | |
|
||||
| P2 | | | | |
|
||||
| Priority | ID | Task | Stima | Assegnato | Dipendenze |
|
||||
|----------|----|------|-------|-----------|------------|
|
||||
| P1 | DB-001 | Alembic Setup | S | @db-engineer | Nessuna |
|
||||
| P1 | DB-002 | Migration Scenarios Table | M | @db-engineer | DB-001 |
|
||||
| P1 | DB-003 | Migration Logs Table | M | @db-engineer | DB-002 |
|
||||
| P1 | BE-001 | Database Connection | M | @backend-dev | DB-001 |
|
||||
| P1 | BE-002 | SQLAlchemy Models | L | @backend-dev | BE-001 |
|
||||
| P2 | DB-004 | Migration Metrics Table | M | @db-engineer | DB-002 |
|
||||
| P2 | DB-005 | Migration Pricing Table | M | @db-engineer | DB-002 |
|
||||
| P2 | BE-003 | Pydantic Schemas | M | @backend-dev | BE-002 |
|
||||
|
||||
---
|
||||
|
||||
@@ -67,7 +89,7 @@
|
||||
|
||||
| ID | Problema | Impatto | Soluzione Proposta | Stato |
|
||||
|----|----------|---------|-------------------|-------|
|
||||
| | | | | 🔴 Aperto |
|
||||
| - | Nessun blocco attuale | - | - | ✅ OK |
|
||||
|
||||
---
|
||||
|
||||
@@ -75,23 +97,68 @@
|
||||
|
||||
| Data | Decisione | Motivazione | Impatto |
|
||||
|------|-----------|-------------|---------|
|
||||
| | | | |
|
||||
| 2026-04-07 | Utilizzare Repository Pattern | Separazione business logic e data access | Più testabile, manutenibile |
|
||||
| 2026-04-07 | Async-first con SQLAlchemy 2.0 | Performance >1000 RPS richiesti | Curva apprendimento ma scalabilità |
|
||||
| 2026-04-07 | Single table per scenario_logs vs DB separati | Semplice per MVP, query cross-scenario possibili | Facile backup, confronti |
|
||||
| 2026-04-07 | SHA-256 hashing per deduplicazione | Privacy + performance | Non memorizzare messaggi completi |
|
||||
|
||||
---
|
||||
|
||||
## 📈 Metriche
|
||||
|
||||
### Sprint Corrente
|
||||
- **Task pianificate:** 0
|
||||
### Sprint Corrente (Fase 1)
|
||||
- **Task pianificate:** 32
|
||||
- **Task completate:** 0
|
||||
- **Task in progress:** 0
|
||||
- **Task in progress:** 1 (Architettura)
|
||||
- **Task bloccate:** 0
|
||||
|
||||
### Qualità
|
||||
- **Test Coverage:** 0%
|
||||
- **Test passanti:** 0/0
|
||||
- **Linting:** ✅ / ❌
|
||||
- **Type Check:** ✅ / ❌
|
||||
- **Test Coverage:** 0% (da implementare)
|
||||
- **Test passanti:** 5/5 (test esistenti v0.1)
|
||||
- **Linting:** ✅ (ruff configurato)
|
||||
- **Type Check:** ⚪ (da implementare con mypy)
|
||||
|
||||
### Codice
|
||||
- **Linee codice backend:** ~150 (v0.1 base)
|
||||
- **Linee test:** ~100
|
||||
- **Documentazione:** ~2500 linee (PRD, Architettura)
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Obiettivi Sprint 1 (Week 1)
|
||||
|
||||
**Goal:** Database PostgreSQL funzionante con API CRUD base
|
||||
|
||||
### Target
|
||||
- [ ] Database schema completo (7 tabelle)
|
||||
- [ ] Alembic migrations funzionanti
|
||||
- [ ] SQLAlchemy models completi
|
||||
- [ ] Repository layer base
|
||||
- [ ] Scenario CRUD API
|
||||
- [ ] Test coverage > 60%
|
||||
|
||||
### Metriche Target
|
||||
- Test coverage: 60%
|
||||
- API endpoints: 10+
|
||||
- Database tables: 5
|
||||
|
||||
---
|
||||
|
||||
## 📋 Risorse
|
||||
|
||||
### Documentazione
|
||||
- PRD: `/home/google/Sources/LucaSacchiNet/mockupAWS/export/prd.md`
|
||||
- Architettura: `/home/google/Sources/LucaSacchiNet/mockupAWS/export/architecture.md`
|
||||
- Kanban: `/home/google/Sources/LucaSacchiNet/mockupAWS/export/kanban.md`
|
||||
- Questo file: `/home/google/Sources/LucaSacchiNet/mockupAWS/export/progress.md`
|
||||
|
||||
### Codice
|
||||
- Backend base: `/home/google/Sources/LucaSacchiNet/mockupAWS/src/`
|
||||
- Test: `/home/google/Sources/LucaSacchiNet/mockupAWS/test/`
|
||||
- Configurazione: `/home/google/Sources/LucaSacchiNet/mockupAWS/pyproject.toml`
|
||||
|
||||
### Team
|
||||
- Configurazioni: `/home/google/Sources/LucaSacchiNet/mockupAWS/.opencode/agents/`
|
||||
|
||||
---
|
||||
|
||||
@@ -106,4 +173,29 @@
|
||||
|
||||
---
|
||||
|
||||
*Ultimo aggiornamento: YYYY-MM-DD HH:MM*
|
||||
## 📝 Log Attività
|
||||
|
||||
### 2026-04-07 - Setup Iniziale
|
||||
|
||||
**Attività:**
|
||||
- ✅ Analisi completa PRD
|
||||
- ✅ Analisi codice esistente (v0.1)
|
||||
- ✅ Creazione architecture.md completo
|
||||
- ✅ Creazione kanban.md con 32 task
|
||||
- ✅ Creazione progress.md
|
||||
- ✅ Setup team configuration (.opencode/agents/)
|
||||
|
||||
**Team:**
|
||||
- @spec-architect: Architettura completata
|
||||
- @db-engineer: In attesa inizio migrazioni
|
||||
- @backend-dev: In attesa schema DB
|
||||
|
||||
**Prossimi passi:**
|
||||
1. @db-engineer inizia DB-001 (Alembic setup)
|
||||
2. @backend-dev prepara ambiente
|
||||
3. Daily check-in team
|
||||
|
||||
---
|
||||
|
||||
*Documento mantenuto dal team*
|
||||
*Ultimo aggiornamento: 2026-04-07 12:00*
|
||||
|
||||
Reference in New Issue
Block a user