메뉴
Cria uma especificação técnica de integração entre um módulo FastAPI do AgtecCore e o cliente Flutter Web. Usar quando o usuário pedir explicitamente para criar uma spec de integração Flutter web/mobile, spec flutter, integração flutter, flutter mobile, flutter web.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | spec-integracao-flutter |
| description | Cria uma especificação técnica de integração entre um módulo FastAPI do AgtecCore e o cliente Flutter Web. Usar quando o usuário pedir explicitamente para criar uma spec de integração Flutter web/mobile, spec flutter, integração flutter, flutter mobile, flutter web. |
Gerar specs de integração Flutter focadas no contrato HTTP consumido pelo cliente, sem expor detalhes internos desnecessários da implementação backend.
.ia/docs/templates/integracao-flutter.md.DD-MM-YYYY.Antes de gerar a spec:
<modulo>/routers.py, <modulo>/schemas.pycore/routers.py ou no agregador do módulocore/security.py e os Depends nos routers.ia/docs/guides/regra-endpoint-filiado-autenticado.md.ia/docs/specs/flutter/<dominio>-<descricao-curta>-flutter-spec-DD-MM-YYYY.mdrouters.py, schemas.py) ou detalhes de implementação. A spec é um contrato de integração, não um guia de implementação.Unifique o conteúdo do markdown abaixo com o template canônico .ia/docs/templates/integracao-flutter.md
## Autenticação
Descrever o mecanismo de autenticação:
- Header obrigatório: `Authorization: Bearer <token>`
- Token obtido via: `POST /api/v1/auth/login/`
- Endpoints que NÃO requerem autenticação (se houver): listar explicitamente
## Endpoints
### [VERBO] /api/v1/<modulo>/<path>/
**Descrição:** O que o endpoint faz.
**Autenticação:** ✅ Obrigatória / ❌ Não requerida
**Permissão:** `<modulo>.<acao>_<modelo>` (se aplicável)
#### Request
**Headers:**
\`\`\`
Authorization: Bearer <token>
Content-Type: application/json
\`\`\`
**Query params** (se aplicável):
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `page` | int | Não | Página (default: 1) |
**Payload (Body):**
\`\`\`json
{
"campo": "valor_exemplo"
}
\`\`\`
**Campos do payload:**
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `campo` | string | Sim | Descrição do campo |
#### Response
**Status:** `200 OK`
\`\`\`json
{
"id": "uuid-exemplo",
"campo": "valor",
"created_at": "2026-01-01T00:00:00Z"
}
\`\`\`
**Campos da resposta:**
| Campo | Tipo | Descrição |
|---|---|---|
| `id` | UUID | Identificador único |
**Erros possíveis:**
| Status | Descrição |
|---|---|
| `401` | Token ausente ou inválido |
| `403` | Sem permissão para a operação |
| `404` | Recurso não encontrado |
| `422` | Payload inválido (validação Pydantic) |
---
[repetir seção para cada endpoint, caso aplicável]
/api/v1//fetch-paginated/, /create/, /update/"2026-01-01T00:00:00Z""3fa85f64-5717-4562-b3fc-2c963f66afa6"limit, offset (verificar FilterPagination em core/schemas.py)deleted: bool — endpoints de listagem retornam apenas deleted=false por padrãoAuthorization header{
"count": 15,
"next": "https://11.11.0.112:8001/api/v1/agenda/evento/fetch-paginated/?offset=5&limit=5",
"previous": null,
"results": [
{
"id": "c3b484ce-738a-4c39-83ac-dbe9227b25fe",
...
},
{
"id": "4820b17b-f0d2-4e80-81f7-817029699241",
...
},
{
"id": "196dfda9-feda-45fa-b95f-d2b5aa4521e9",
...
},
{
"id": "79d46443-2add-409a-ab5a-9922949d99b6",
...
}
]
}
Adiciona suporte a embeddings vetoriais no módulo de IA do projeto usando pgvector. Use quando o usuário pedir para adicionar busca semântica, embeddings, vetorização de documentos, ou memória de longo prazo ao módulo de IA. Também ativa automaticamente quando o contexto menciona "embeddings", "busca semântica", "pgvector", "vetorização" ou arquivos no módulo de IA do projeto.
Adiciona um novo endpoint FastAPI ao projeto AgtecCore seguindo a arquitetura em camadas (router → use_case → crud). Use quando o usuário pedir para criar um endpoint, adicionar uma rota, implementar um CRUD, ou estender um módulo existente. Também ativa automaticamente quando o contexto menciona "novo endpoint", "nova rota", "criar endpoint" ou arquivos em módulos com routers.py.
Atualiza os artefatos de desenvolvimento assistido por IA do projeto AgtecCore (`.ia/` e `AGENTS.md`) quando há mudanças arquiteturais, novos módulos, novas restrições ou inconsistências detectadas. Use quando o usuário pedir para atualizar documentação IA, corrigir artefatos, ou após uma mudança arquitetural significativa. Também ativa automaticamente quando o contexto menciona "atualizar artefatos", "documentação IA", "artefatos desatualizados" ou arquivos em `.ia/`.
Criar uma branch de implementação a partir de uma task aprovada, usando o nome do arquivo da task como nome da branch e a branch atual como base. Opera apenas em Git e no arquivo da task. Usar quando a task estiver aprovada para implementação, quando for necessário abrir a branch da task ou quando a execução for sair da fase de análise para implementação.
Diagnostica e corrige bugs no projeto AgtecCore seguindo o protocolo anti-alucinação. Use quando o usuário reportar um erro, exceção, comportamento inesperado, ou falha em teste. Também ativa automaticamente quando o contexto menciona "bug", "erro", "exception", "falha", "não funciona" ou stack traces.
Escreve testes automatizados para o projeto AgtecCore usando pytest, pytest-asyncio e TestContainers. Use quando o usuário pedir para criar testes, aumentar cobertura, escrever test cases, ou validar uma implementação. Também ativa automaticamente quando o contexto menciona "escrever testes", "criar testes", "test coverage" ou arquivos em tests/.