# Fashion360 — Padrões Gerais do Projeto

## Princípios centrais
- Clean Code, SOLID, separação de responsabilidades e reaproveitamento máximo de código.
- Documento oficial antes de código.
- Uma fase por vez; sem pular mock para integração.
- `docs/` é fonte de verdade. `agents/` é camada operacional.
- Toda entrega relevante exige checklist, QA e homologação.
- Reutilização de componentes e consistência estrutural são obrigatórias em toda implementação.

## Stack aprovada
- React
- Vite
- TypeScript
- Bootstrap

## Arquitetura de interface
- desenvolvimento obrigatoriamente orientado a componentes;
- componentes devem ser reutilizáveis, coesos e com responsabilidade única;
- antes de criar qualquer componente, a IA deve verificar se já existe componente equivalente ou parcialmente compatível no projeto;
- se existir componente compatível, a prioridade é reutilizar, parametrizar, compor ou evoluir o componente existente;
- a criação de novo componente só é permitida quando não houver componente reaproveitável no projeto;
- é proibido duplicar estrutura, comportamento, estilo ou lógica já existente sem justificativa documental;
- toda nova implementação deve respeitar o padrão visual, técnico e arquitetural já adotado no sistema.

## Convenções obrigatórias
- trabalhar por pacotes;
- handoff explícito entre agentes;
- outputs sempre delimitando o que entra agora e o que fica bloqueado;
- qualquer dúvida crítica deve ser resolvida pela documentação, nunca por invenção.

## Evolução técnica por fase
- mock e interface primeiro;
- integração local depois;
- banco local na fase adequada;
- servidor de aplicação nas fases seguintes.
- consumo de API REST na fase adequada;

## Testes
Toda fase deve ter:
- massa mock ou massa real adequada;
- critérios de aceite;
- checklist de entrega;
- validação por QA antes de avançar.