CONTRIBUTING.md

Contribuindo para o Zairyx

Obrigado por considerar contribuir! Este guia explica como participar do projeto.

Primeiros Passos

1. Fork o repositório
2. Clone seu fork: git clone https://github.com/SEU_USUARIO/Cardapio-Digital.git
3. Instale dependências: npm install
4. Configure o ambiente: npm run setup:local
5. Valide: npm run doctor

Fluxo de Trabalho

1. Crie uma branch a partir de main: git checkout -b feature/minha-feature
2. Faça suas alterações
3. Rode npm run audit:full (build + lint + testes)
4. Commit com mensagem descritiva
5. Abra um Pull Request para main

Padrões de Código

• TypeScript strict — sem any desnecessário
• ESLint — npm run lint deve passar sem erros
• Tailwind CSS — sem CSS custom quando Tailwind resolve
• Componentes — Radix UI + shadcn/ui como base
• Validação — Zod para inputs de API

Estrutura de Commits

Use mensagens claras e descritivas:

feat: adiciona template para food truck
fix: corrige cálculo de comissão no tier Gold
docs: atualiza guia de instalação

Segurança

• Nunca commite .env ou credenciais
• Sempre use RLS em novas tabelas Supabase
• Valide todos os inputs de API com Zod
• Veja SECURITY.md para reportar vulnerabilidades

Licença

Ao contribuir, você concorda que suas contribuições serão licenciadas sob a BSL 1.1 do projeto.