# Feature Rollout

> Plataforma de production readiness que liga documentação, tarefas, cenários, testes, evidências, riscos e rollout à mesma decisão auditável.

## Comece aqui

- Documentação: https://feature-rollout.dev/docs
- Quickstart: https://feature-rollout.dev/docs/quickstart
- OpenAPI 3.1: https://feature-rollout.dev/openapi.json
- Plataforma hospedada: https://feature-rollout.dev
- Docker local: http://127.0.0.1:3000

## Mapa da documentação

- [Início](https://feature-rollout.dev/docs): Entenda a decisão de rollout e escolha o caminho certo para começar.
- [Quickstart](https://feature-rollout.dev/docs/quickstart): Suba o ambiente local e chegue à primeira decisão em menos de dez minutos.
- [Instalação](https://feature-rollout.dev/docs/getting-started/installation): Instale a CLI e valide a identidade usada no terminal.
- [Ambiente local](https://feature-rollout.dev/docs/guides/local-docker): Opere a imagem Docker pública, persistência, backup e atualização.
- [Operação CLI e HTTP](https://feature-rollout.dev/docs/guides/cli-http): Escolha corretamente entre Docker, CLI, HTTP e dashboard.
- [Autenticação](https://feature-rollout.dev/docs/guides/authentication): Autentique pessoas, terminais e pipelines com o escopo adequado.
- [Modelo de dados](https://feature-rollout.dev/docs/concepts/data-model): Conheça projetos, portfólios, features e seus vínculos.
- [Contrato de prontidão](https://feature-rollout.dev/docs/concepts/readiness-contract): Entenda score, bloqueantes, gate e guardrails de rollout.
- [Recursos](https://feature-rollout.dev/docs/reference/resources): Consulte a hierarquia e os identificadores estáveis do produto.
- [Tarefas](https://feature-rollout.dev/docs/guides/tasks): Modele trabalho, critérios de aceite e vínculos com cenários.
- [Evidências](https://feature-rollout.dev/docs/guides/evidence): Registre provas auditáveis e contexto para humanos e modelos.
- [API HTTP](https://feature-rollout.dev/docs/api): Consulte convenções, autenticação, endpoints e códigos HTTP.
- [Referência interativa](https://feature-rollout.dev/docs/api/reference): Pesquise contratos, compare linguagens e execute requisições com segurança.
- [SDKs](https://feature-rollout.dev/docs/api/sdks): Use os clientes oficiais TypeScript e Python e trate erros estruturados.
- [Catálogo v2](https://feature-rollout.dev/docs/api/catalog-v2): Reconcilie features, tarefas e prontidão como código.
- [Documentações API](https://feature-rollout.dev/docs/api/documents): Crie documentos, versões, diffs e análises de coerência.
- [Relatórios de teste](https://feature-rollout.dev/docs/api/test-reports): Envie CTRF, JUnit, Playwright, Cypress e cobertura.
- [Comandos](https://feature-rollout.dev/docs/cli/reference): Consulte os comandos e códigos de saída disponíveis na CLI.
- [CI/CD](https://feature-rollout.dev/docs/guides/ci-cd): Publique sinais e bloqueie promoções com gates auditáveis.
- [Configuração](https://feature-rollout.dev/docs/reference/configuration): Configure variáveis, headers e contexto de repositório.
- [Changelog](https://feature-rollout.dev/docs/reference/changelog): Acompanhe releases, compatibilidade, migrações e depreciações.
- [Versionamento e erros](https://feature-rollout.dev/docs/reference/versioning-errors): Entenda versões, compatibilidade, depreciações e respostas de erro.

## Contrato de segurança para agentes

- Confirme /api/health e o campo mode antes de qualquer mutação.
- Use somente endpoints documentados; não escreva diretamente no PostgreSQL.
- Leia o recurso atual e apresente o diff antes de gravar.
- Não exclua projetos, documentos, containers ou volumes sem confirmação humana explícita.
- No ambiente remoto, não copie cookies do navegador. Use apenas Bearer tokens nas famílias de API que os suportam.
- Releia o recurso após a gravação e reporte os IDs alterados.

## Limites atuais

- A CLI pública autentica com fr login, identifica com fr whoami e revoga com fr logout; ainda não possui CRUD de recursos.
- Tokens pessoais emitidos por fr login usam management:read/write combinados com o papel no workspace.
- A Management API pública cobre projetos, portfólios, features, cenários, evidências, riscos e documentos; catálogo, testes, cobertura, OIDC e gates permanecem nas famílias próprias. Consulte openapi.json.