# Fashion360 — Pacote 10: Fase 3 — API REST e Servidor de Aplicação

> **Arquivo:** `docs/pacotes/10-pacote-fase3-api-rest-e-servidor-de-aplicacao.md`
> **Projeto:** Fashion360
> **Fase:** Fase 3 — Integração central e servidor de aplicação
> **Tipo:** Pacote real de trabalho
> **Módulos centrais:** M21, M01, M04
> **Objetivo:** estruturar servidor de aplicação, autenticação da API, autorização, endpoints centrais, contratos, versionamento e idempotência.

---

## 1. Finalidade do pacote
Este pacote existe para executar um bloco completo do projeto sem romper a ordem oficial, mantendo clareza de escopo, agentes, entregas e bloqueios.

## 2. Leitura obrigatória deste pacote
1. `docs/modulos/21-api-rest-integracoes-e-servidor-de-aplicacao.md`
2. `docs/modulos/01-plataforma-saas-tenancy.md`
3. `docs/modulos/04-identidade-usuarios-perfis-permissoes.md`

## 3. Agentes prioritários
- `agents/00-agent-orquestrador-geral.md`
- `agents/08-agent-api-rest-e-integracoes.md`
- `agents/05-agent-controllers-e-fluxos.md`
- `agents/04-agent-models-e-banco-local.md`
- `agents/10-agent-seguranca-permissoes-e-tenancy.md`
- `agents/07-agent-qa-e-homologacao.md`

## 4. Escopo real do pacote
Este pacote deve entregar apenas o que for compatível com a sua fase, sua maturidade e os módulos envolvidos.

### 4.1. Entra neste pacote
- catálogo oficial de endpoints
- contratos de request/response
- matriz de autenticação/autorização/idempotência

### 4.2. Não entra neste pacote
- sync final sem fila pronta
- backoffice final sem API madura

## 5. Critérios de entrada
- Pacote anterior correspondente aprovado;
- dependências obrigatórias fechadas conforme `docs/04-matriz-de-dependencia-entre-modulos.md`;
- fase do roadmap compatível;
- Pacote 00 já concluído.

## 6. Critérios de saída
O pacote só pode ser considerado concluído quando entregar, no mínimo:
- catálogo oficial de endpoints
- contratos de request/response
- matriz de autenticação/autorização/idempotência

## 7. Regra obrigatória
Nenhum executor pode misturar este pacote com o próximo sem registrar claramente o status do pacote atual.

## 8. Próximo passo oficial
Após a conclusão deste pacote, o próximo passo oficial é `docs/pacotes/11-pacote-fase3-sync-offline-pre-venda-e-reconciliacao.md`.