feat: add complete development team configuration
Add specialized agent configurations for mockupAWS development: - @spec-architect: Software architect and specification lead - @db-engineer: PostgreSQL schema and Alembic migrations - @backend-dev: FastAPI development and services - @frontend-dev: React dashboard and UI components - @devops-engineer: Docker and CI/CD setup - @qa-engineer: Testing strategy and E2E tests Update prompt-zero.md with complete team and project structure. Add prompt-team-standup.md for team kickoff and coordination. Each agent has detailed configuration with: - Role and responsibilities - Technical stack - Scope and constraints - Output requirements - Communication style
This commit is contained in:
Luca Sacchi Ricciardi
421
prompt/prompt-team-standup.md
Normal file
421
prompt/prompt-team-standup.md
Normal file
@@ -0,0 +1,421 @@
|
||||
# Prompt: Team Standup - mockupAWS Development Kickoff
|
||||
|
||||
## 🎯 Obiettivo
|
||||
|
||||
Ingaggiare il team di sviluppo per verificare lo stato attuale e procedere con l'implementazione della Fase 1 (Database + Backend API) del progetto mockupAWS.
|
||||
|
||||
---
|
||||
|
||||
## 📊 Stato Progetto
|
||||
|
||||
**Progetto:** mockupAWS - Backend Profiler & Cost Estimator
|
||||
**Versione Target:** v0.2.0
|
||||
**Data:** 2026-04-07
|
||||
**Stato:** 🔴 Pianificazione / Architettura iniziale
|
||||
|
||||
### Cosa è stato completato ✅
|
||||
|
||||
1. **Documentazione:**
|
||||
- ✅ PRD completo (v0.2.0) in `export/prd.md`
|
||||
- ✅ README aggiornato con architettura e istruzioni
|
||||
- ✅ Team configurato in `.opencode/agents/`
|
||||
|
||||
2. **Codice Base Iniziale:**
|
||||
- ✅ FastAPI base con endpoint `/ingest`, `/metrics`, `/reset`, `/flush`
|
||||
- ✅ Calcolo metriche: SQS blocks, token count (tiktoken), PII detection
|
||||
- ✅ Test suite pytest con 5 test passanti
|
||||
- ✅ Struttura progetto e configurazione uv/pyproject.toml
|
||||
|
||||
3. **Configurazione:**
|
||||
- ✅ Configurazione OpenCode (`.opencode/`)
|
||||
- ✅ Git repository con commit iniziale
|
||||
|
||||
### Cosa deve essere fatto 🔴
|
||||
|
||||
#### Priorità Alta (Fase 1 - v0.2.0)
|
||||
|
||||
- [ ] **Database PostgreSQL:**
|
||||
- Schema completo (scenarios, scenario_logs, scenario_metrics, aws_pricing, reports)
|
||||
- Alembic migrations setup
|
||||
- Migrazioni per tutte le tabelle
|
||||
- Seed dati prezzi AWS
|
||||
|
||||
- [ ] **Backend API:**
|
||||
- Integrazione SQLAlchemy 2.0 async
|
||||
- Model SQLAlchemy per tutte le tabelle
|
||||
- API CRUD scenari (/api/v1/scenarios/*)
|
||||
- Gestione stati scenario (draft→running→completed→archived)
|
||||
- Calcolo costi usando prezzi da database
|
||||
- Persistenza log e metriche
|
||||
|
||||
- [ ] **Testing:**
|
||||
- Integration tests per API scenari
|
||||
- Test coverage > 80%
|
||||
|
||||
#### Priorità Media (Fase 2 - v0.3.0)
|
||||
|
||||
- [ ] Frontend React con dashboard
|
||||
- [ ] Docker Compose setup
|
||||
|
||||
---
|
||||
|
||||
## 👥 Team Assegnato
|
||||
|
||||
| Agente | Ruolo | Priorità Task |
|
||||
|--------|-------|---------------|
|
||||
| `@spec-architect` | Software Architect | Completare architecture.md, kanban.md, coordinamento |
|
||||
| `@db-engineer` | Database Engineer | Schema DB, Alembic migrations, seed dati |
|
||||
| `@backend-dev` | Backend Developer | API CRUD, integrazione DB, services |
|
||||
| `@frontend-dev` | Frontend Developer | In attesa Fase 2 (preparare mock data) |
|
||||
| `@devops-engineer` | DevOps Engineer | In attesa (preparare Docker base) |
|
||||
| `@qa-engineer` | QA Engineer | Review requisiti, preparare test plan |
|
||||
|
||||
---
|
||||
|
||||
## 🎬 Azioni Immediate
|
||||
|
||||
### Per @spec-architect
|
||||
|
||||
**Task:** Completare specifiche tecniche
|
||||
|
||||
1. **Leggere attentamente:**
|
||||
- `/home/google/Sources/LucaSacchiNet/mockupAWS/export/prd.md` (tutto)
|
||||
- `/home/google/Sources/LucaSacchiNet/mockupAWS/src/main.py` (codice esistente)
|
||||
- `/home/google/Sources/LucaSacchiNet/mockupAWS/src/profiler.py`
|
||||
|
||||
2. **Aggiornare** `/home/google/Sources/LucaSacchiNet/mockupAWS/export/architecture.md`:
|
||||
```markdown
|
||||
# Da aggiungere:
|
||||
- Sezione Database: schema dettagliato con tipi SQL
|
||||
- Sezione API: endpoint completi con request/response
|
||||
- Sezione Sicurezza: JWT, API keys, rate limiting
|
||||
- Sezione Deployment: Docker strategy
|
||||
```
|
||||
|
||||
3. **Creare** `/home/google/Sources/LucaSacchiNet/mockupAWS/export/kanban.md`:
|
||||
```markdown
|
||||
# Struttura richiesta:
|
||||
## 🔴 TODO (Fase 1 - Database & Backend)
|
||||
### DB-001: Setup Alembic
|
||||
- [ ] Configurazione async
|
||||
- [ ] Test connessione
|
||||
|
||||
### DB-002: Migrazione Scenarios
|
||||
- [ ] Tabella scenarios
|
||||
- [ ] Indici
|
||||
|
||||
### API-001: CRUD Scenari
|
||||
- [ ] POST /api/v1/scenarios
|
||||
- [ ] GET /api/v1/scenarios
|
||||
- ...
|
||||
```
|
||||
|
||||
4. **Aggiornare** `/home/google/Sources/LucaSacchiNet/mockupAWS/export/progress.md`:
|
||||
- Stato attuale: "🔴 Fase 1 - Database setup"
|
||||
- Percentuale: 10%
|
||||
- Task in corso: Architettura
|
||||
|
||||
### Per @db-engineer
|
||||
|
||||
**Task:** Progettare e implementare database
|
||||
|
||||
1. **Progettare schema completo**:
|
||||
```sql
|
||||
-- scenarios
|
||||
id: UUID PK
|
||||
name: VARCHAR(255)
|
||||
description: TEXT
|
||||
tags: JSONB
|
||||
status: ENUM('draft', 'running', 'completed', 'archived')
|
||||
region: VARCHAR(50)
|
||||
created_at: TIMESTAMP
|
||||
updated_at: TIMESTAMP
|
||||
total_cost_estimate: DECIMAL(10,4)
|
||||
|
||||
-- scenario_logs
|
||||
id: UUID PK
|
||||
scenario_id: UUID FK
|
||||
received_at: TIMESTAMP
|
||||
message_hash: VARCHAR(64) -- SHA256
|
||||
message_preview: VARCHAR(500)
|
||||
source: VARCHAR(100)
|
||||
size_bytes: INTEGER
|
||||
has_pii: BOOLEAN
|
||||
token_count: INTEGER
|
||||
sqs_blocks: INTEGER
|
||||
|
||||
-- scenario_metrics
|
||||
id: UUID PK
|
||||
scenario_id: UUID FK
|
||||
timestamp: TIMESTAMP
|
||||
metric_type: VARCHAR(50)
|
||||
metric_name: VARCHAR(100)
|
||||
value: DECIMAL(15,4)
|
||||
unit: VARCHAR(20)
|
||||
metadata: JSONB
|
||||
|
||||
-- aws_pricing
|
||||
id: UUID PK
|
||||
service: VARCHAR(50)
|
||||
region: VARCHAR(50)
|
||||
tier: VARCHAR(50)
|
||||
price_per_unit: DECIMAL(10,8)
|
||||
unit: VARCHAR(20)
|
||||
effective_from: DATE
|
||||
effective_to: DATE
|
||||
is_active: BOOLEAN
|
||||
|
||||
-- reports
|
||||
id: UUID PK
|
||||
scenario_id: UUID FK
|
||||
format: ENUM('pdf', 'csv')
|
||||
file_path: VARCHAR(500)
|
||||
generated_at: TIMESTAMP
|
||||
metadata: JSONB
|
||||
```
|
||||
|
||||
2. **Setup Alembic**:
|
||||
```bash
|
||||
cd /home/google/Sources/LucaSacchiNet/mockupAWS
|
||||
uv add alembic asyncpg
|
||||
uv run alembic init alembic
|
||||
# Configurare per async
|
||||
```
|
||||
|
||||
3. **Creare migrazioni**:
|
||||
- `alembic/versions/001_create_scenarios_table.py`
|
||||
- `alembic/versions/002_create_scenario_logs_table.py`
|
||||
- `alembic/versions/003_create_scenario_metrics_table.py`
|
||||
- `alembic/versions/004_create_aws_pricing_table.py`
|
||||
- `alembic/versions/005_create_reports_table.py`
|
||||
- `alembic/versions/006_seed_aws_pricing_data.py`
|
||||
|
||||
4. **Documentare** in `docs/database_schema.md`:
|
||||
- Schema ER
|
||||
- Indici
|
||||
- Query principali
|
||||
|
||||
### Per @backend-dev
|
||||
|
||||
**Task:** Preparare integrazione database
|
||||
|
||||
1. **Analizzare** codice esistente:
|
||||
- Come funziona `/ingest` attualmente (in-memory)
|
||||
- Come adattarlo per usare database
|
||||
|
||||
2. **Preparare** struttura nuova:
|
||||
```
|
||||
backend/src/
|
||||
├── models/
|
||||
│ ├── __init__.py
|
||||
│ ├── scenario.py # SQLAlchemy model
|
||||
│ ├── scenario_log.py
|
||||
│ ├── scenario_metric.py
|
||||
│ └── aws_pricing.py
|
||||
├── schemas/
|
||||
│ ├── __init__.py
|
||||
│ ├── scenario.py # Pydantic schemas
|
||||
│ └── ...
|
||||
├── api/
|
||||
│ ├── __init__.py
|
||||
│ ├── v1/
|
||||
│ │ ├── __init__.py
|
||||
│ │ ├── scenarios.py # CRUD endpoints
|
||||
│ │ ├── ingest.py # Updated /ingest
|
||||
│ │ └── pricing.py
|
||||
│ └── deps.py # Dependencies (DB session)
|
||||
├── services/
|
||||
│ ├── __init__.py
|
||||
│ ├── scenario_service.py
|
||||
│ ├── cost_calculator.py
|
||||
│ └── ingest_processor.py
|
||||
└── core/
|
||||
├── config.py # Settings (DB URL, etc.)
|
||||
└── database.py # DB connection/session
|
||||
```
|
||||
|
||||
3. **Aspettare** completamento schema DB prima di iniziare implementazione
|
||||
|
||||
### Per @qa-engineer
|
||||
|
||||
**Task:** Preparare test strategy
|
||||
|
||||
1. **Creare** `docs/test_plan.md`:
|
||||
```markdown
|
||||
# Test Plan mockupAWS v0.2.0
|
||||
|
||||
## Unit Tests
|
||||
- [ ] ScenarioService.create()
|
||||
- [ ] ScenarioService.update_status()
|
||||
- [ ] CostCalculator.calculate_sqs_cost()
|
||||
- [ ] CostCalculator.calculate_lambda_cost()
|
||||
- [ ] IngestProcessor.process_log()
|
||||
|
||||
## Integration Tests
|
||||
- [ ] POST /api/v1/scenarios - Crea scenario
|
||||
- [ ] GET /api/v1/scenarios - Lista scenari
|
||||
- [ ] POST /ingest with X-Scenario-ID - Ingest log
|
||||
- [ ] GET /api/v1/scenarios/{id}/metrics - Get metrics
|
||||
- [ ] State transitions: draft→running→completed
|
||||
|
||||
## E2E Tests (preparazione)
|
||||
- [ ] Flow completo: Crea → Ingest 10 log → Verifica metriche
|
||||
- [ ] Confronto costi: scenario A vs scenario B
|
||||
```
|
||||
|
||||
2. **Review** requisiti PRD per completezza test coverage
|
||||
|
||||
### Per @frontend-dev (preparazione)
|
||||
|
||||
**Task:** Preparare ambiente e mock data
|
||||
|
||||
1. **Setup** struttura frontend:
|
||||
```bash
|
||||
mkdir -p /home/google/Sources/LucaSacchiNet/mockupAWS/frontend
|
||||
cd /home/google/Sources/LucaSacchiNet/mockupAWS/frontend
|
||||
npm create vite@latest . -- --template react-ts
|
||||
npm install
|
||||
npm install tailwindcss postcss autoprefixer
|
||||
npx tailwindcss init -p
|
||||
npm install @tanstack/react-query axios recharts lucide-react
|
||||
npm install -D @types/node
|
||||
```
|
||||
|
||||
2. **Preparare** mock data per sviluppo UI:
|
||||
```typescript
|
||||
// mock/scenarios.ts
|
||||
export const mockScenarios = [
|
||||
{
|
||||
id: "uuid-1",
|
||||
name: "Produzione Q2",
|
||||
status: "running",
|
||||
total_cost_estimate: 125.50,
|
||||
total_requests: 15000,
|
||||
created_at: "2026-04-01T10:00:00Z"
|
||||
},
|
||||
// ...
|
||||
];
|
||||
```
|
||||
|
||||
3. **Attendere** completamento API backend
|
||||
|
||||
### Per @devops-engineer (preparazione)
|
||||
|
||||
**Task:** Preparare Docker base
|
||||
|
||||
1. **Creare** `docker-compose.yml` base:
|
||||
```yaml
|
||||
version: '3.8'
|
||||
services:
|
||||
postgres:
|
||||
image: postgres:15-alpine
|
||||
environment:
|
||||
POSTGRES_DB: mockupaws
|
||||
POSTGRES_USER: app
|
||||
POSTGRES_PASSWORD: changeme
|
||||
volumes:
|
||||
- postgres_data:/var/lib/postgresql/data
|
||||
ports:
|
||||
- "5432:5432"
|
||||
|
||||
# backend e frontend da aggiungere dopo
|
||||
|
||||
volumes:
|
||||
postgres_data:
|
||||
```
|
||||
|
||||
2. **Preparare** `backend/Dockerfile`:
|
||||
```dockerfile
|
||||
FROM python:3.11-slim
|
||||
WORKDIR /app
|
||||
COPY pyproject.toml .
|
||||
RUN pip install uv && uv pip install -r pyproject.toml
|
||||
COPY . .
|
||||
CMD ["uv", "run", "uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "8000"]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 Checklist Team
|
||||
|
||||
### @spec-architect
|
||||
- [ ] Leggere PRD completo
|
||||
- [ ] Aggiornare architecture.md con dettagli DB e API
|
||||
- [ ] Creare kanban.md con task Fase 1
|
||||
- [ ] Aggiornare progress.md
|
||||
|
||||
### @db-engineer
|
||||
- [ ] Progettare schema completo
|
||||
- [ ] Setup Alembic
|
||||
- [ ] Creare migrazioni
|
||||
- [ ] Documentare schema
|
||||
|
||||
### @backend-dev
|
||||
- [ ] Analizzare codice esistente
|
||||
- [ ] Preparare struttura nuova
|
||||
- [ ] In attesa schema DB
|
||||
|
||||
### @qa-engineer
|
||||
- [ ] Creare test_plan.md
|
||||
- [ ] Review requisiti
|
||||
|
||||
### @frontend-dev
|
||||
- [ ] Setup ambiente React
|
||||
- [ ] Preparare mock data
|
||||
|
||||
### @devops-engineer
|
||||
- [ ] Creare docker-compose.yml base
|
||||
- [ ] Preparare Dockerfile backend
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Success Criteria
|
||||
|
||||
La Fase 1 è completata quando:
|
||||
|
||||
- [ ] Database PostgreSQL funzionante con tutte le tabelle
|
||||
- [ ] Migrazioni Alembic funzionanti (upgrade/downgrade)
|
||||
- [ ] API CRUD scenari complete e testate
|
||||
- [ ] Endpoint `/ingest` aggiornato per persistere log
|
||||
- [ ] Calcolo costi usando prezzi da database
|
||||
- [ ] Test coverage > 80%
|
||||
- [ ] Documentazione tecnica aggiornata
|
||||
|
||||
---
|
||||
|
||||
## ⏰ Timeline Suggerita
|
||||
|
||||
| Settimana | Focus | Deliverable |
|
||||
|-----------|-------|-------------|
|
||||
| Week 1 | Architettura + DB | Schema DB, migrazioni, architettura approvata |
|
||||
| Week 2 | Backend API | CRUD scenari, persistenza, calcolo costi |
|
||||
| Week 3 | Testing + Refinement | Test >80%, bug fixing, ottimizzazioni |
|
||||
| Week 4 | Frontend base | Dashboard lista scenari, form creazione |
|
||||
|
||||
---
|
||||
|
||||
## 📞 Comunicazione
|
||||
|
||||
- **Daily standup:** Aggiornare `export/progress.md`
|
||||
- **Domande tecniche:** Documentare in `docs/architecture.md`
|
||||
- **Blocchi:** Aggiungere a `export/kanban.md` colonna BLOCKED
|
||||
- **Decisioni:** Sempre in Conventional Commits
|
||||
|
||||
---
|
||||
|
||||
**Prompt creato:** 2026-04-07
|
||||
**Team Lead:** @spec-architect
|
||||
**Stato:** Pronto per esecuzione
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Prossima Azione Concreta
|
||||
|
||||
**Tutti gli agenti coinvolti:** Leggete questo prompt e la vostra configurazione in `.opencode/agents/`, poi procedete con i task assegnati.
|
||||
|
||||
**Priorità immediata:**
|
||||
1. @spec-architect completa architecture.md
|
||||
2. @db-engineer inizia schema DB
|
||||
3. @backend-dev prepara struttura
|
||||
|
||||
Iniziate ora! 💪
|
||||
@@ -1,141 +1,216 @@
|
||||
# Prompt Zero: [NOME_PROGETTO] - Project Kickoff
|
||||
# Prompt Zero: mockupAWS - Project Kickoff
|
||||
|
||||
## 🎯 Missione
|
||||
|
||||
Sviluppare **[NOME_PROGETTO]**, [descrizione breve del progetto - da personalizzare].
|
||||
Sviluppare **mockupAWS**, un ambiente di simulazione locale per profilare traffico log e calcolare i driver di costo AWS (SQS, Lambda, Bedrock/LLM) prima del deploy in produzione.
|
||||
|
||||
**Repository:** `[ROOT_PROGETTO]`
|
||||
**PRD:** `[ROOT_PROGETTO]/export/prd.md`
|
||||
**Repository:** `/home/google/Sources/LucaSacchiNet/mockupAWS`
|
||||
**PRD:** `/home/google/Sources/LucaSacchiNet/mockupAWS/export/prd.md`
|
||||
|
||||
---
|
||||
|
||||
## 📊 Stato Attuale
|
||||
|
||||
- ✅ **PRD Completo**: Requisiti funzionali e non funzionali definiti
|
||||
- ✅ **Team Configurato**: Agenti specializzati pronti
|
||||
- ❌ **Nessun Codice**: Progetto da zero
|
||||
- ❌ **Nessuna Specifica Tecnica**: Da creare
|
||||
- ✅ **PRD Completo**: Requisiti funzionali e non funzionali definiti (v0.2.0)
|
||||
- ✅ **Team Configurato**: 6 agenti specializzati pronti
|
||||
- ⚠️ **Codice Base Parziale**: API base implementata (v0.1), manca database e persistenza
|
||||
- ❌ **Database**: Schema da creare (PostgreSQL)
|
||||
- ❌ **Frontend**: Dashboard React da implementare
|
||||
- ❌ **Docker**: Configurazione da creare
|
||||
|
||||
### Cosa è già fatto:
|
||||
- FastAPI base con endpoint `/ingest`, `/metrics`, `/reset`, `/flush`
|
||||
- Calcolo metriche: SQS blocks, token count (tiktoken), PII detection
|
||||
- Test suite pytest (5 test passanti)
|
||||
- Documentazione: README, PRD, architettura
|
||||
- Struttura progetto e configurazione uv
|
||||
|
||||
### Cosa manca (Priorità):
|
||||
1. Database PostgreSQL con tabelle scenarios, logs, metrics, pricing
|
||||
2. Alembic migrations
|
||||
3. API CRUD scenari complete
|
||||
4. Calcolo costi con prezzi AWS reali
|
||||
5. Frontend React con dashboard
|
||||
6. Docker Compose setup
|
||||
|
||||
---
|
||||
|
||||
## 👥 Team di Sviluppo
|
||||
|
||||
| Agente | Ruolo | File Config |
|
||||
|--------|-------|-------------|
|
||||
| `@spec-architect` | Definisce specifiche e architettura | `.opencode/agents/spec-architect.md` |
|
||||
| `@tdd-developer` | Implementazione TDD | `.opencode/agents/tdd-developer.md` |
|
||||
| `@git-manager` | Gestione commit Git | `.opencode/agents/git-manager.md` |
|
||||
| Agente | Ruolo | Config | Responsabilità |
|
||||
|--------|-------|--------|----------------|
|
||||
| `@spec-architect` | Software Architect | `.opencode/agents/spec-architect.md` | Specifiche tecniche, architettura, coordinamento |
|
||||
| `@db-engineer` | Database Engineer | `.opencode/agents/db-engineer.md` | Schema DB, Alembic migrations, queries |
|
||||
| `@backend-dev` | Backend Developer | `.opencode/agents/backend-dev.md` | FastAPI endpoints, services, tests |
|
||||
| `@frontend-dev` | Frontend Developer | `.opencode/agents/frontend-dev.md` | React dashboard, UI components |
|
||||
| `@devops-engineer` | DevOps Engineer | `.opencode/agents/devops-engineer.md` | Docker, CI/CD, deployment |
|
||||
| `@qa-engineer` | QA Engineer | `.opencode/agents/qa-engineer.md` | Testing strategy, E2E tests |
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Workflow Obbligatorio
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ FASE 1: SPECIFICA │
|
||||
│ @spec-architect │
|
||||
│ └── Legge PRD → Crea architecture.md, kanban.md │
|
||||
│ │
|
||||
│ ↓ │
|
||||
│ │
|
||||
│ FASE 2: IMPLEMENTAZIONE │
|
||||
│ @tdd-developer │
|
||||
│ └── RED → GREEN → REFACTOR per ogni task │
|
||||
│ │
|
||||
│ ↓ │
|
||||
│ │
|
||||
│ FASE 3: COMMIT │
|
||||
│ @git-manager │
|
||||
│ └── Commit atomico + Conventional Commits │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ FASE 1: ARCHITETTURA & DATABASE │
|
||||
│ @spec-architect + @db-engineer │
|
||||
│ └── Finalizza architecture.md + Crea schema DB + Migrations │
|
||||
│ │
|
||||
│ ↓ │
|
||||
│ │
|
||||
│ FASE 2: BACKEND API │
|
||||
│ @backend-dev + @db-engineer │
|
||||
│ └── Implementa API CRUD scenari + Persistenza metriche │
|
||||
│ │
|
||||
│ ↓ │
|
||||
│ │
|
||||
│ FASE 3: FRONTEND │
|
||||
│ @frontend-dev │
|
||||
│ └── Dashboard React + Forms + Visualizzazione dati │
|
||||
│ │
|
||||
│ ↓ │
|
||||
│ │
|
||||
│ FASE 4: DEVOPS & QA │
|
||||
│ @devops-engineer + @qa-engineer │
|
||||
│ └── Docker Compose + CI/CD + Testing E2E │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Task Iniziale: Fase 1 - Specifica
|
||||
## 🚀 Task Iniziale: Fase 1 - Architettura e Database
|
||||
|
||||
**AGENTE:** `@spec-architect`
|
||||
**AGENTE:** `@spec-architect` + `@db-engineer`
|
||||
|
||||
**OBIETTIVO:** Analizzare il PRD e creare le specifiche tecniche dettagliate.
|
||||
**OBIETTIVO:** Completare le specifiche tecniche e creare il database schema.
|
||||
|
||||
### Azioni Richieste
|
||||
|
||||
1. **Leggere** `[ROOT_PROGETTO]/export/prd.md`
|
||||
#### 1. @spec-architect - Analisi e Specifiche
|
||||
|
||||
2. **Creare** la struttura di output:
|
||||
```
|
||||
[ROOT_PROGETTO]/export/
|
||||
├── prd.md # Requisiti prodotti (estratto/dettaglio)
|
||||
├── architecture.md # Architettura sistema
|
||||
├── kanban.md # Task breakdown
|
||||
└── progress.md # Tracciamento progresso
|
||||
```
|
||||
1. **Leggere** `/home/google/Sources/LucaSacchiNet/mockupAWS/export/prd.md`
|
||||
|
||||
3. **Produrre** `architecture.md` con:
|
||||
- Stack tecnologico dettagliato
|
||||
- Struttura cartelle progetto
|
||||
- Diagrammi flusso dati
|
||||
- Schema database completo (DDL)
|
||||
- Interfacce API (OpenAPI specs)
|
||||
- Sicurezza (cifratura, autenticazione)
|
||||
2. **Analizzare** il codice esistente in `/home/google/Sources/LucaSacchiNet/mockupAWS/src/`
|
||||
|
||||
4. **Produrre** `kanban.md` con:
|
||||
- Task breakdown per Fase 1 (MVP)
|
||||
- Stima complessità
|
||||
3. **Aggiornare** `/home/google/Sources/LucaSacchiNet/mockupAWS/export/architecture.md` con:
|
||||
- Stack tecnologico dettagliato (conferma FastAPI + PostgreSQL + React)
|
||||
- Struttura cartelle progetto finale
|
||||
- Diagrammi flusso dati (Mermaid o ASCII)
|
||||
- API specifications complete (OpenAPI specs)
|
||||
- Piano di sicurezza (JWT, API keys)
|
||||
|
||||
4. **Creare** `/home/google/Sources/LucaSacchiNet/mockupAWS/export/kanban.md` con:
|
||||
- Task breakdown per Fase 1 (Database + Backend API)
|
||||
- Task breakdown per Fase 2 (Frontend)
|
||||
- Stima complessità (XS/S/M/L)
|
||||
- Dipendenze tra task
|
||||
- Regola "little often": task < 2 ore
|
||||
|
||||
5. **Inizializzare** `progress.md` con:
|
||||
- Feature corrente: "Fase 1 - MVP"
|
||||
5. **Inizializzare** `/home/google/Sources/LucaSacchiNet/mockupAWS/export/progress.md` con:
|
||||
- Feature corrente: "Fase 1 - Database e Backend API"
|
||||
- Stato: "🔴 Pianificazione"
|
||||
- Percentuale: 0%
|
||||
- Percentuale: 10%
|
||||
|
||||
### Criteri di Accettazione
|
||||
#### 2. @db-engineer - Schema Database
|
||||
|
||||
- [ ] Architecture.md completo con tutte le sezioni
|
||||
- [ ] Kanban.md con task pronti per @tdd-developer
|
||||
- [ ] Progress.md inizializzato
|
||||
- [ ] Tutti i path usano `[ROOT_PROGETTO]/`
|
||||
1. **Progettare** schema PostgreSQL completo:
|
||||
```sql
|
||||
-- Tabelle richieste:
|
||||
- scenarios (metadata scenario)
|
||||
- scenario_logs (log ricevuti con hash)
|
||||
- scenario_metrics (metriche aggregate)
|
||||
- aws_pricing (prezzi AWS per regione)
|
||||
- reports (report generati)
|
||||
```
|
||||
|
||||
2. **Creare** Alembic setup:
|
||||
- `alembic init alembic`
|
||||
- Configurare `alembic.ini`
|
||||
- Creare `migrations/env.py` con async support
|
||||
|
||||
3. **Creare** migrazioni iniziali:
|
||||
- `001_create_scenarios_table.py`
|
||||
- `002_create_scenario_logs_table.py`
|
||||
- `003_create_scenario_metrics_table.py`
|
||||
- `004_create_aws_pricing_table.py`
|
||||
- `005_create_reports_table.py`
|
||||
- `006_seed_aws_pricing_data.py`
|
||||
|
||||
4. **Documentare** in `docs/database_schema.md`:
|
||||
- Schema ER completo
|
||||
- Indici creati
|
||||
- Constraints e foreign keys
|
||||
|
||||
### Criteri di Accettazione Fase 1
|
||||
|
||||
- [ ] `architecture.md` completo con tutte le sezioni
|
||||
- [ ] `kanban.md` con task pronti per sviluppo
|
||||
- [ ] `progress.md` inizializzato con stato attuale
|
||||
- [ ] Schema database progettato e documentato
|
||||
- [ ] Migrazioni Alembic create e testate
|
||||
- [ ] Tabelle create correttamente in PostgreSQL
|
||||
|
||||
---
|
||||
|
||||
## 📋 Requisiti Chiave (Dal PRD)
|
||||
|
||||
### Funzionalità MVP (Fase 1)
|
||||
### Priorità Alta (MVP v0.2.0)
|
||||
|
||||
[DA PERSONALIZZARE - Inserire le funzionalità principali del progetto]
|
||||
1. **Database & Persistenza**
|
||||
- PostgreSQL con tabelle scenarios, logs, metrics, pricing
|
||||
- Alembic migrations
|
||||
- Seed dati prezzi AWS reali
|
||||
|
||||
1. **[Feature 1]**
|
||||
- [Dettaglio 1]
|
||||
- [Dettaglio 2]
|
||||
2. **API Scenari**
|
||||
- CRUD completo: GET/POST/PUT/DELETE /api/v1/scenarios
|
||||
- Gestione stati: draft → running → completed → archived
|
||||
- Associazione log a scenario via X-Scenario-ID header
|
||||
|
||||
2. **[Feature 2]**
|
||||
- [Dettaglio 1]
|
||||
- [Dettaglio 2]
|
||||
3. **Calcolo Costi**
|
||||
- Formula SQS: blocks × price_per_million / 1000000
|
||||
- Formula Lambda: invocations × price + gb_seconds × price
|
||||
- Formula Bedrock: tokens × price_per_1k / 1000
|
||||
- Prezzi per regione (us-east-1, eu-west-1)
|
||||
|
||||
### Stack Tecnologico (Esempio)
|
||||
4. **Testing**
|
||||
- Test coverage > 80%
|
||||
- Unit tests per services
|
||||
- Integration tests per API
|
||||
|
||||
- **Backend:** [Linguaggio/Framework]
|
||||
- **Database:** [Tipo database]
|
||||
- **Frontend:** [Tecnologia frontend]
|
||||
- **Auth:** [Metodo autenticazione]
|
||||
- **Task Background:** [Scheduler]
|
||||
### Priorità Media (v0.3.0)
|
||||
|
||||
5. **Dashboard Web**
|
||||
- React + TypeScript + Tailwind
|
||||
- Lista scenari con filtri
|
||||
- Form creazione scenario
|
||||
- Vista dettaglio con metriche
|
||||
|
||||
6. **Report**
|
||||
- Export CSV
|
||||
- Visualizzazione grafici
|
||||
|
||||
### Priorità Bassa (v0.4.0)
|
||||
|
||||
7. **Report PDF**
|
||||
8. **Confronto scenari**
|
||||
9. **Autenticazione**
|
||||
|
||||
---
|
||||
|
||||
## 🛡️ Vincoli e Best Practices
|
||||
|
||||
### Sicurezza (Critico)
|
||||
- [Requisito sicurezza 1]
|
||||
- [Requisito sicurezza 2]
|
||||
- SQL injection prevention
|
||||
- XSS prevention
|
||||
- SQL injection prevention (SQLAlchemy ORM)
|
||||
- XSS prevention (React escaping)
|
||||
- CSRF protection
|
||||
- Rate limiting
|
||||
- Rate limiting (slowapi)
|
||||
- Hashing messaggi per privacy
|
||||
- No PII in logs persistenti
|
||||
|
||||
### Qualità
|
||||
- Test coverage ≥ 90%
|
||||
- TDD obbligatorio
|
||||
- Test coverage ≥ 80%
|
||||
- TDD obbligatorio per backend
|
||||
- Type hints obbligatori (Python + TypeScript)
|
||||
- Conventional commits
|
||||
- Commit atomici
|
||||
|
||||
@@ -143,38 +218,62 @@ Sviluppare **[NOME_PROGETTO]**, [descrizione breve del progetto - da personalizz
|
||||
- Task "little often" (< 2 ore)
|
||||
- Documentazione in `/export/`
|
||||
- Bug complessi in `/docs/bug_ledger.md`
|
||||
- PR con code review
|
||||
|
||||
---
|
||||
|
||||
## 📁 Struttura Progetto Attesa
|
||||
## 📁 Struttura Progetto Finale
|
||||
|
||||
```
|
||||
[ROOT_PROGETTO]/
|
||||
├── prd.md # Product Requirements
|
||||
/home/google/Sources/LucaSacchiNet/mockupAWS/
|
||||
├── export/ # Output spec-driven
|
||||
│ ├── prd.md # Product Requirements
|
||||
│ ├── architecture.md # Architettura sistema
|
||||
│ ├── kanban.md # Task breakdown
|
||||
│ └── progress.md # Tracciamento progresso
|
||||
├── docs/
|
||||
│ ├── architecture.md # ADR (Architecture Decision Records)
|
||||
│ ├── bug_ledger.md # Bug tracking
|
||||
│ └── database_schema.md # Schema DB documentazione
|
||||
├── prompt/
|
||||
│ └── prompt-zero.md # Questo file
|
||||
├── .opencode/
|
||||
│ ├── agents/ # Configurazioni agenti
|
||||
│ └── skills/ # Skill condivise
|
||||
├── export/ # Output spec-driven (da creare)
|
||||
│ ├── prd.md
|
||||
│ ├── architecture.md
|
||||
│ ├── kanban.md
|
||||
│ └── progress.md
|
||||
├── docs/ # Documentazione (da creare)
|
||||
│ ├── bug_ledger.md
|
||||
│ └── architecture.md
|
||||
├── src/ # Codice sorgente (da creare)
|
||||
│ └── [nome_package]/
|
||||
│ ├── __init__.py
|
||||
│ ├── main.py
|
||||
│ ├── config.py
|
||||
│ └── ...
|
||||
├── tests/ # Test suite (da creare)
|
||||
│ ├── unit/
|
||||
│ ├── integration/
|
||||
│ └── conftest.py
|
||||
├── requirements.txt / package.json
|
||||
│ └── agents/ # Configurazioni agenti
|
||||
│ ├── spec-architect.md
|
||||
│ ├── backend-dev.md
|
||||
│ ├── db-engineer.md
|
||||
│ ├── frontend-dev.md
|
||||
│ ├── devops-engineer.md
|
||||
│ └── qa-engineer.md
|
||||
├── backend/ # FastAPI application
|
||||
│ ├── src/
|
||||
│ │ ├── __init__.py
|
||||
│ │ ├── main.py # Entry point
|
||||
│ │ ├── config.py # Configuration
|
||||
│ │ ├── models/ # SQLAlchemy models
|
||||
│ │ ├── schemas/ # Pydantic schemas
|
||||
│ │ ├── api/ # API endpoints
|
||||
│ │ ├── services/ # Business logic
|
||||
│ │ └── core/ # Utils, auth, etc.
|
||||
│ ├── tests/
|
||||
│ │ ├── unit/
|
||||
│ │ ├── integration/
|
||||
│ │ └── conftest.py
|
||||
│ ├── alembic/ # Database migrations
|
||||
│ ├── Dockerfile
|
||||
│ └── pyproject.toml
|
||||
├── frontend/ # React application
|
||||
│ ├── src/
|
||||
│ │ ├── components/ # React components
|
||||
│ │ ├── pages/ # Page components
|
||||
│ │ ├── hooks/ # Custom hooks
|
||||
│ │ ├── services/ # API clients
|
||||
│ │ └── types/ # TypeScript types
|
||||
│ ├── public/
|
||||
│ ├── Dockerfile
|
||||
│ └── package.json
|
||||
├── docker-compose.yml # Full stack orchestration
|
||||
├── nginx.conf # Reverse proxy config
|
||||
└── README.md
|
||||
```
|
||||
|
||||
@@ -182,43 +281,55 @@ Sviluppare **[NOME_PROGETTO]**, [descrizione breve del progetto - da personalizz
|
||||
|
||||
## ✅ Checklist Pre-Sviluppo
|
||||
|
||||
- [ ] @spec-architect ha letto questo prompt
|
||||
- [ ] Cartella `export/` creata
|
||||
- [ ] `architecture.md` creato con schema DB
|
||||
- [ ] `kanban.md` creato con task Fase 1
|
||||
- [ ] `progress.md` inizializzato
|
||||
- [ ] @spec-architect ha letto questo prompt e il PRD
|
||||
- [ ] @db-engineer ha revisionato il PRD sezione database
|
||||
- [ ] Team allineato sulle priorita (MVP v0.2.0)
|
||||
- [ ] Architettura approvata
|
||||
- [ ] Schema database pronto
|
||||
|
||||
---
|
||||
|
||||
## 🎬 Prossima Azione
|
||||
|
||||
**@spec-architect**: Inizia analizzando il PRD in `export/prd.md` e crea le specifiche tecniche in `export/`.
|
||||
**@spec-architect**: Inizia analizzando il PRD e il codice esistente, poi aggiorna `architecture.md` e `kanban.md`.
|
||||
|
||||
**NON iniziare l'implementazione** finché le specifiche non sono approvate.
|
||||
**@db-engineer**: Inizia progettando lo schema database e le migrazioni Alembic.
|
||||
|
||||
**NON iniziare l'implementazione del codice di business logic** finché architettura e schema DB non sono completati e revisionati.
|
||||
|
||||
---
|
||||
|
||||
## 📞 Note per il Team
|
||||
|
||||
- **Domande sul PRD?** Leggi prima `export/prd.md` completamente
|
||||
- **Codice esistente?** Esamina `/home/google/Sources/LucaSacchiNet/mockupAWS/src/` prima di iniziare
|
||||
- **Ambiguità?** Chiedi prima di procedere
|
||||
- **Vincoli tecnici?** Documentali in `architecture.md`
|
||||
- **Task troppo grandi?** Spezza in task più piccoli
|
||||
- **Task troppo grandi?** Spezza in task più piccoli seguendo "little often"
|
||||
|
||||
---
|
||||
|
||||
**Data Creazione:** YYYY-MM-DD
|
||||
**Versione:** 1.0
|
||||
**Stato:** Pronto per kickoff
|
||||
**Data Creazione:** 2026-04-07
|
||||
**Versione:** 2.0
|
||||
**Stato:** Pronto per kickoff - Fase 1: Architettura e Database
|
||||
|
||||
---
|
||||
|
||||
## 📝 Note per l'Utente
|
||||
## 📝 Note sullo Stato Attuale
|
||||
|
||||
Questo è un template. Per usarlo:
|
||||
Il progetto ha già una base solida con:
|
||||
- API FastAPI funzionante con metriche base
|
||||
- Test suite completa (pytest)
|
||||
- Documentazione PRD dettagliata
|
||||
|
||||
1. **Sostituisci** `[NOME_PROGETTO]` con il nome reale
|
||||
2. **Descrivi** il progetto nella sezione Missione
|
||||
3. **Personalizza** la sezione "Requisiti Chiave" con i tuoi requisiti
|
||||
4. **Aggiorna** lo stack tecnologico
|
||||
5. **Definisci** gli scope dei commit pertinenti al tuo progetto
|
||||
Il team deve ora:
|
||||
1. Completare l'architettura tecnica
|
||||
2. Implementare il database layer
|
||||
3. Evolvere l'API esistente per supportare scenari
|
||||
4. Costruire il frontend
|
||||
5. Containerizzare tutto
|
||||
|
||||
Il lavoro può procedere in parallelo dopo la fase di architettura:
|
||||
- Backend e DB possono procedere insieme
|
||||
- Frontend può iniziare con mock data
|
||||
- DevOps può preparare l'infrastruttura
|
||||
|
||||
Reference in New Issue
Block a user