docs: add team kickoff prompt for Fase 1 development
This commit is contained in:
Luca Sacchi Ricciardi
347
prompt/prompt-kickoff-fase1.md
Normal file
347
prompt/prompt-kickoff-fase1.md
Normal file
@@ -0,0 +1,347 @@
|
||||
# 🚀 TEAM KICKOFF - mockupAWS Fase 1
|
||||
|
||||
## 📢 Comunicazione Ufficiale
|
||||
|
||||
**Data:** 2026-04-07
|
||||
**Fase:** 1 - Database & Backend Core
|
||||
**Status:** ✅ Architettura Completa - Pronti per Sviluppo
|
||||
|
||||
---
|
||||
|
||||
## ✅ Cosa è stato completato
|
||||
|
||||
L'agente **@spec-architect** ha completato l'analisi e le specifiche tecniche:
|
||||
|
||||
### Documentazione Pronta
|
||||
- ✅ **PRD v0.2.0** - Requisiti completi
|
||||
- ✅ **architecture.md** - Architettura dettagliata con:
|
||||
- Schema database completo (DDL SQL pronto)
|
||||
- API specifications (OpenAPI)
|
||||
- Diagrammi flusso dati
|
||||
- Piano sicurezza
|
||||
- ✅ **kanban.md** - 32 task breakdown, stimate, priorizzate
|
||||
- ✅ **progress.md** - Tracking inizializzato
|
||||
|
||||
### Team Configurato
|
||||
- ✅ 6 agenti specializzati configurati in `.opencode/agents/`
|
||||
- ✅ Ogni agente ha ruoli, responsabilità e constraints definiti
|
||||
|
||||
---
|
||||
|
||||
## 🎯 OBIETTIVO FASE 1
|
||||
|
||||
**Deadline:** End of Week 1
|
||||
**Goal:** Database PostgreSQL funzionante + API CRUD base
|
||||
|
||||
**Deliverables:**
|
||||
1. Database schema completo (5 tabelle)
|
||||
2. Alembic migrations funzionanti
|
||||
3. SQLAlchemy models + Pydantic schemas
|
||||
4. Repository layer
|
||||
5. Scenario CRUD API
|
||||
6. Test coverage > 60%
|
||||
|
||||
---
|
||||
|
||||
## 👥 ASSEGNAZIONI TASK
|
||||
|
||||
### @db-engineer - DATABASE (Priorità P1)
|
||||
|
||||
**Task immediate:**
|
||||
1. **DB-001** - Alembic Setup (Stima: S)
|
||||
- Installare alembic e asyncpg
|
||||
- Configurare per SQLAlchemy 2.0 async
|
||||
- Testare connessione
|
||||
|
||||
2. **DB-002** - Migration Scenarios Table (Stima: M)
|
||||
- Creare tabella scenarios con tutti i campi
|
||||
- Aggiungere indexes e constraints
|
||||
- Testare migrazione
|
||||
|
||||
3. **DB-003** - Migration Logs Table (Stima: M)
|
||||
- Creare tabella scenario_logs
|
||||
- Foreign key a scenarios
|
||||
|
||||
4. **DB-004** - Migration Metrics Table (Stima: M)
|
||||
- Creare tabella scenario_metrics
|
||||
|
||||
5. **DB-005** - Migration Pricing Table (Stima: M)
|
||||
- Creare tabella aws_pricing
|
||||
|
||||
6. **DB-006** - Migration Reports Table (Stima: S)
|
||||
- Creare tabella reports
|
||||
|
||||
7. **DB-007** - Seed AWS Pricing Data (Stima: M)
|
||||
- Popolare con prezzi reali AWS
|
||||
- SQS, Lambda, Bedrock per us-east-1
|
||||
|
||||
**📖 Riferimenti:**
|
||||
- Schema SQL: `export/architecture.md` sezione 3.2
|
||||
- Prezzi: `export/prd.md` sezione 4.3 (tabella prezzi)
|
||||
- Config agente: `.opencode/agents/db-engineer.md`
|
||||
|
||||
**⚠️ IMPORTANTE:**
|
||||
- Usare UUID come primary keys
|
||||
- Includere created_at/updated_at su tutte le tabelle
|
||||
- Creare indexes su colonne di query frequenti
|
||||
- Testare ogni migrazione con `alembic upgrade +1`
|
||||
|
||||
---
|
||||
|
||||
### @backend-dev - BACKEND CORE (Priorità P1)
|
||||
|
||||
**Task immediate:**
|
||||
1. **BE-001** - Database Connection (Stima: M)
|
||||
- Creare `backend/src/core/database.py`
|
||||
- Configurare async SQLAlchemy engine
|
||||
- Creare dependency `get_db()` per FastAPI
|
||||
|
||||
2. **BE-002** - SQLAlchemy Models (Stima: L)
|
||||
- Creare tutti i modelli in `backend/src/models/`
|
||||
- Base model, Scenario, ScenarioLog, ScenarioMetric, AwsPricing, Report
|
||||
- Definire relationships
|
||||
|
||||
3. **BE-003** - Pydantic Schemas (Stima: M)
|
||||
- Creare schemas in `backend/src/schemas/`
|
||||
- ScenarioCreate, ScenarioUpdate, ScenarioResponse, etc.
|
||||
|
||||
4. **BE-004** - Base Repository (Stima: M)
|
||||
- Creare `backend/src/repositories/base.py`
|
||||
- Implementare Generic Repository pattern
|
||||
- Metodi: get(), list(), create(), update(), delete()
|
||||
|
||||
5. **BE-005** - Scenario Repository (Stima: M)
|
||||
- Creare `backend/src/repositories/scenario_repo.py`
|
||||
- Metodi specifici per scenario
|
||||
|
||||
6. **BE-015** - API Dependencies (Stima: M)
|
||||
- Creare `backend/src/api/deps.py`
|
||||
- Configurare exception handlers
|
||||
- Definire custom exceptions
|
||||
|
||||
7. **BE-016** - Scenarios API (Stima: L)
|
||||
- Implementare CRUD endpoints
|
||||
- POST/GET/PUT/DELETE /api/v1/scenarios
|
||||
- Lifecycle endpoints (start, stop, archive)
|
||||
|
||||
**📖 Riferimenti:**
|
||||
- Architettura: `export/architecture.md` sezioni 4, 5, 7, 8
|
||||
- API Specs: `export/architecture.md` sezione 4
|
||||
- Codice esistente: `src/main.py`, `src/profiler.py`
|
||||
- Config agente: `.opencode/agents/backend-dev.md`
|
||||
|
||||
**⚠️ IMPORTANTE:**
|
||||
- Usare type hints ovunque
|
||||
- TDD: scrivere test prima o insieme al codice
|
||||
- Async/await per tutte le operazioni I/O
|
||||
- Repository pattern obbligatorio
|
||||
|
||||
---
|
||||
|
||||
### @frontend-dev - PREPARAZIONE (Priorità P2)
|
||||
|
||||
**Task preparazione:**
|
||||
1. Setup ambiente React:
|
||||
```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 clsx tailwind-merge
|
||||
npm install -D @types/node
|
||||
```
|
||||
|
||||
2. Installare shadcn/ui:
|
||||
```bash
|
||||
npx shadcn-ui@latest init
|
||||
```
|
||||
|
||||
3. Preparare mock data per sviluppo UI
|
||||
|
||||
**📖 Riferimenti:**
|
||||
- Stack: `export/architecture.md` sezione 7.2
|
||||
- Config agente: `.opencode/agents/frontend-dev.md`
|
||||
|
||||
**⚠️ NOTA:** Il frontend verrà sviluppato in Fase 2. Per ora preparare solo l'ambiente.
|
||||
|
||||
---
|
||||
|
||||
### @devops-engineer - DOCKER BASE (Priorità P2)
|
||||
|
||||
**Task preparazione:**
|
||||
1. Creare `docker-compose.yml` base:
|
||||
- Servizio PostgreSQL
|
||||
- Volume per persistenza
|
||||
- Health check
|
||||
|
||||
2. Preparare `backend/Dockerfile`:
|
||||
- Multi-stage build
|
||||
- Python 3.11-slim
|
||||
- Uvicorn entrypoint
|
||||
|
||||
3. Preparare `frontend/Dockerfile`:
|
||||
- Node 20-alpine
|
||||
- Nginx per serving
|
||||
|
||||
**📖 Riferimenti:**
|
||||
- Config agente: `.opencode/agents/devops-engineer.md`
|
||||
|
||||
---
|
||||
|
||||
### @qa-engineer - TEST PLAN (Priorità P2)
|
||||
|
||||
**Task preparazione:**
|
||||
1. Creare `docs/test_plan.md` con:
|
||||
- Unit test strategy
|
||||
- Integration test plan
|
||||
- E2E test scenarios
|
||||
|
||||
2. Preparare fixtures per pytest:
|
||||
- Database fixture con rollback
|
||||
- Mock data fixtures
|
||||
|
||||
**📖 Riferimenti:**
|
||||
- Config agente: `.opencode/agents/qa-engineer.md`
|
||||
|
||||
---
|
||||
|
||||
## 🔄 WORKFLOW GIORNALIERO
|
||||
|
||||
### Daily Routine
|
||||
1. **Mattina:** Leggere `export/progress.md` per stato attuale
|
||||
2. **Durante il giorno:** Aggiornare progresso su task assegnate
|
||||
3. **Fine giornata:** Aggiornare `export/progress.md` con:
|
||||
- Task completate
|
||||
- Blocchi riscontrati
|
||||
- Decisioni prese
|
||||
|
||||
### Comunicazione
|
||||
- **Domande tecniche:** Riferirsi a `export/architecture.md`
|
||||
- **Task details:** Riferirsi a `export/kanban.md`
|
||||
- **Blocchi:** Aggiungere a `export/kanban.md` sezione BLOCKED
|
||||
- **Decisioni:** Documentare in `export/progress.md`
|
||||
|
||||
### Git Workflow
|
||||
- **Branch:** `feature/DB-001-alembic-setup`
|
||||
- **Commits:** Conventional commits
|
||||
- `feat: add alembic configuration`
|
||||
- `feat: create scenarios table migration`
|
||||
- `test: add scenario repository tests`
|
||||
- **PR:** Una feature = una PR
|
||||
|
||||
---
|
||||
|
||||
## 📊 CRITERI DI SUCCESSO FASE 1
|
||||
|
||||
La Fase 1 è completata quando TUTTI questi criteri sono soddisfatti:
|
||||
|
||||
### Database ✅
|
||||
- [ ] Alembic configurato e funzionante
|
||||
- [ ] 5 tabelle create con migrazioni
|
||||
- [ ] Indexes creati
|
||||
- [ ] Seed dati pricing popolati
|
||||
- [ ] `alembic upgrade head` esegue senza errori
|
||||
|
||||
### Backend ✅
|
||||
- [ ] SQLAlchemy models completi
|
||||
- [ ] Pydantic schemas validati
|
||||
- [ ] Repository layer funzionante
|
||||
- [ ] API CRUD scenari testate
|
||||
- [ ] Gestione stati (draft→running→completed) funzionante
|
||||
|
||||
### Testing ✅
|
||||
- [ ] Unit tests per repositories
|
||||
- [ ] Integration tests per API
|
||||
- [ ] Test coverage > 60%
|
||||
- [ ] Tutti i test passanti
|
||||
|
||||
### Documentazione ✅
|
||||
- [ ] API documentate (OpenAPI visibile su /docs)
|
||||
- [ ] README aggiornato con istruzioni setup
|
||||
|
||||
---
|
||||
|
||||
## 🚨 COMANDI UTILI
|
||||
|
||||
### Database
|
||||
```bash
|
||||
# Setup database locale
|
||||
docker run -d --name mockupaws-postgres \
|
||||
-e POSTGRES_DB=mockupaws \
|
||||
-e POSTGRES_USER=app \
|
||||
-e POSTGRES_PASSWORD=changeme \
|
||||
-p 5432:5432 postgres:15-alpine
|
||||
|
||||
# Alembic commands
|
||||
cd /home/google/Sources/LucaSacchiNet/mockupAWS/backend
|
||||
uv run alembic revision --autogenerate -m "create scenarios table"
|
||||
uv run alembic upgrade head
|
||||
uv run alembic downgrade -1
|
||||
```
|
||||
|
||||
### Backend
|
||||
```bash
|
||||
# Setup
|
||||
cd /home/google/Sources/LucaSacchiNet/mockupAWS
|
||||
uv add sqlalchemy alembic asyncpg pydantic-settings
|
||||
|
||||
# Test
|
||||
uv run pytest -v
|
||||
uv run pytest --cov=src --cov-report=html
|
||||
|
||||
# Run
|
||||
uv run uvicorn src.main:app --reload
|
||||
```
|
||||
|
||||
### Frontend
|
||||
```bash
|
||||
cd /home/google/Sources/LucaSacchiNet/mockupAWS/frontend
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📞 SUPPORTO
|
||||
|
||||
### Domande?
|
||||
1. Leggere prima `export/architecture.md`
|
||||
2. Controllare `export/kanban.md` per dettagli task
|
||||
3. Riferirsi al proprio file config in `.opencode/agents/`
|
||||
|
||||
### Blocchi?
|
||||
- Aggiungere task a sezione BLOCKED in `kanban.md`
|
||||
- Documentare in `progress.md`
|
||||
- Chiedere supporto al team
|
||||
|
||||
---
|
||||
|
||||
## 🎬 AZIONE IMMEDIATA
|
||||
|
||||
**@db-engineer:** Inizia con **DB-001** - Alembic Setup
|
||||
|
||||
**@backend-dev:** Prepara ambiente, inizia con **BE-001** quando DB-001 è pronto
|
||||
|
||||
**@frontend-dev:** Setup ambiente React
|
||||
|
||||
**@devops-engineer:** Crea docker-compose.yml base
|
||||
|
||||
**@qa-engineer:** Crea test plan iniziale
|
||||
|
||||
**@spec-architect:** Monitoraggio progresso, supporto architetturale
|
||||
|
||||
---
|
||||
|
||||
**🚀 TEAM: SIATE PRONTI, SI PARTE!**
|
||||
|
||||
Iniziate con le task assegnate. Aggiornate `export/progress.md` frequentemente.
|
||||
|
||||
**Commit often, test always, communicate always!**
|
||||
|
||||
---
|
||||
|
||||
*Prompt creato da @spec-architect*
|
||||
*Data: 2026-04-07*
|
||||
*Versione: 1.0*
|
||||
Reference in New Issue
Block a user