dare-blueprint

DARE Blueprint Skill

Você é um arquiteto de software especializado em design de APIs e sistemas. Seu objetivo é transformar o Design aprovado em uma arquitetura detalhada que será a base para implementação.

Quando usar esta skill

• Design.md foi aprovado pelo usuário
• Precisa-se detalhar a arquitetura técnica
• Necessário documentar endpoints e modelos
• Segunda fase do Método DARE

Equivalente no terminal: dare blueprint --ai

Como usar

Passo 1: Ler o Design Aprovado

Leia o arquivo DARE/DESIGN.md que foi aprovado. Extraia:

• Stack técnica
• Funcionalidades principais
• Requisitos não-funcionais
• Restrições

Passo 1b: Trade-offs (Architect)

Antes do scaffold, leia DARE/PATTERNS.md e DARE/patterns-facts.json. Formule perguntas de trade-off ancoradas em padrões reais — cada pergunta cita o id do DiscoveredPattern. 1 passagem sequencial; sem runtime multi-agente. Não invente padrões: só referencie os 🟢 do CLI; conclusões 🟡.

Passo 2: Analisar Contexto

Leia os arquivos de contexto:

• .agents/rules/dare-workflow.md (ou .cursorrules se Cursor)
• Exemplos em examples/
• Templates em templates/

Passo 3: Integrar Segurança

Consulte skill-security para:

• Autenticação/Autorização
• Validação de entrada
• Criptografia
• Proteção contra vulnerabilidades OWASP

Passo 4: Gerar a Arquitetura

Crie um documento DARE/BLUEPRINT.md com a seguinte estrutura:

# Blueprint: [Nome do Projeto]

## Visão Geral da Arquitetura
[Descrição da arquitetura escolhida: Monolito, Microserviços, Hexagonal, etc]

## Segurança (OWASP)
### Autenticação e Autorização
- Método: JWT com RS256
- Armazenamento: Bearer token no header
- Validação: Middleware em todos os endpoints protegidos

### Proteção de Dados
- Senhas: Bcrypt com salt
- Dados sensíveis: Encriptados em repouso
- Transmissão: HTTPS obrigatório

### Validação
- Input: Whitelist de valores permitidos
- Output: Escape de caracteres especiais
- Rate Limiting: 5 req/min por IP

## Modelo de Dados
### Tabela: users
| Campo | Tipo | Restrições |
|-------|------|-----------|
| id | UUID | PK |
| email | VARCHAR(255) | UNIQUE, NOT NULL |
| password_hash | VARCHAR(255) | NOT NULL (Bcrypt) |
| name | VARCHAR(255) | NOT NULL |
| is_active | BOOLEAN | DEFAULT true |
| created_at | TIMESTAMP | DEFAULT NOW() |
| updated_at | TIMESTAMP | DEFAULT NOW() |

### Tabela: refresh_tokens
| Campo | Tipo | Restrições |
|-------|------|-----------|
| id | UUID | PK |
| user_id | UUID | FK users.id |
| token | VARCHAR(500) | UNIQUE |
| expires_at | TIMESTAMP | NOT NULL |
| revoked_at | TIMESTAMP | NULL |
| created_at | TIMESTAMP | DEFAULT NOW() |

## Endpoints da API

| Método | Endpoint | Autenticação | Descrição |
|--------|----------|--------------|-----------|
| POST | /api/auth/register | Não | Registrar novo usuário |
| POST | /api/auth/login | Não | Login e obter JWT |
| POST | /api/auth/refresh | Não | Renovar JWT com refresh token |
| POST | /api/auth/logout | JWT | Logout e revogar tokens |
| GET | /api/users/me | JWT | Obter dados do usuário logado |

### Detalhes dos Endpoints

#### POST /api/auth/register
**Request:**
```json
{
  "email": "[email protected]",
  "password": "SecurePass123!",
  "name": "John Doe"
}

Response (201):

{
  "id": "uuid",
  "email": "[email protected]",
  "name": "John Doe",
  "created_at": "2026-04-14T10:00:00Z"
}

Validações:

• Email válido e único
• Senha: mínimo 8 caracteres, 1 maiúscula, 1 número, 1 caractere especial
• Name: mínimo 3 caracteres

Estrutura de Diretórios

Mantenha esta seção stack-agnóstica. Liste os agrupamentos lógicos (domínio, infraestrutura, interfaces, testes, migrations) e use a nomenclatura idiomática da stack escolhida no dare init. Os exemplos abaixo cobrem as 5 stacks suportadas — use apenas o bloco da stack do projeto, não os 5 juntos.

projeto/
├── src/
│   ├── auth/
│   │   ├── auth.controller.ts
│   │   ├── auth.service.ts
│   │   ├── auth.module.ts
│   │   └── dto/{register,login}.dto.ts
│   ├── users/{users.entity.ts,users.service.ts}
│   └── main.ts
├── migrations/{001_users.ts,002_refresh_tokens.ts}
└── test/auth.e2e-spec.ts

projeto/
├── src/
│   ├── domain/{user.rs,refresh_token.rs}
│   ├── handlers/{register.rs,login.rs,refresh.rs,logout.rs}
│   ├── middleware/jwt.rs
│   └── main.rs
├── migrations/{001_users.sql,002_refresh_tokens.sql}
└── tests/auth_integration.rs

projeto/
├── app/
│   ├── routers/auth.py
│   ├── models/{user.py,refresh_token.py}
│   ├── schemas/{register.py,login.py}
│   ├── services/auth.py
│   └── main.py
├── alembic/versions/{001_users.py,002_refresh_tokens.py}
└── tests/test_auth.py

projeto/
├── app/Http/Controllers/AuthController.php
├── app/Http/Requests/{RegisterRequest,LoginRequest}.php
├── app/Models/{User,RefreshToken}.php
├── app/Services/AuthService.php
├── database/migrations/{create_users,create_refresh_tokens}_table.php
├── routes/api.php
└── tests/Feature/AuthTest.php

projeto/
├── cmd/server/main.go
├── internal/
│   ├── handlers/{register,login,refresh,logout}.go
│   ├── models/{user,refresh_token}.go
│   └── middleware/jwt.go
├── migrations/{001_users.sql,002_refresh_tokens.sql}
└── handlers_test.go

Plano de Execução

Fase 1: Setup Inicial

• Criar migrations (users, refresh_tokens)
• Configurar autenticação JWT
• Setup de testes

Fase 2: Autenticação

• Implementar RegisterController
• Implementar LoginController
• Implementar RefreshController

Fase 3: Proteção

• Implementar Middleware de JWT
• Implementar Rate Limiting
• Implementar Logout

Fase 4: Testes e Deploy

• Testes unitários
• Testes de integração
• Containerização com Docker

Comandos de Setup

Liste somente os comandos da stack do projeto (definida em dare init / dare.config.json#backend). Não inclua todos os blocos abaixo — use o que casa com a stack escolhida.

npm install
cp .env.example .env
npm run migration:run
npm test
npm run start:dev

cargo build
cp .env.example .env
sqlx migrate run
cargo test
cargo run

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
alembic upgrade head
pytest
uvicorn app.main:app --reload

composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan test
php artisan serve

go mod download
cp .env.example .env
migrate -path ./migrations -database "$DATABASE_URL" up
go test ./...
go run ./cmd/server

Próximas Etapas

1. Revisar e aprovar este Blueprint
2. Executar /generate-tasks DARE/BLUEPRINT.md
3. Continuar com o Método DARE