# PRD Master — Modelo Padrão

> **planilhaprofissional.com** · Product Requirements Document
> Trilha principal: **Apps / PWA / SaaS**
> Anexos: [Excel/VBA](docs/anexos/ANEXO_B_EXCEL.md) · [Ebook](docs/anexos/ANEXO_C_EBOOK.md)

---

## Como usar este modelo

1. Copie [docs/templates/PRD_APP_TEMPLATE.md](docs/templates/PRD_APP_TEMPLATE.md) para `apps/nome-do-app/PRD.md`
2. Preencha **apenas os campos em branco** — não altere títulos dos capítulos
3. Consulte os padrões fixos em `docs/padroes/` — **não copie, apenas referencie**
4. Registre desvios em **Desvios de Arquitetura** (final do documento)
5. Valide [REQUISITOS_OBRIGATORIOS_APPS.md](docs/padroes/REQUISITOS_OBRIGATORIOS_APPS.md) antes de desenvolver

**Requisitos obrigatórios em todos os apps** (resumo): rodapé fixo · aba Comece Aqui · aba LGPD · menu sanduíche PC/celular · PWA com botão instalar · schema Supabase isolado · senha isolada por app · tela alterar senha.

Detalhes: [ARQUITETURA_FABRICA_APPS.md](docs/padroes/ARQUITETURA_FABRICA_APPS.md) §6–§8.

**Padrão consolidado** (melhor de cada app analisado): [PADRAO_CONSOLIDADO_FABRICA.md](docs/PADRAO_CONSOLIDADO_FABRICA.md)

**Auth oficial (accounts · profiles · licenses):** [AUTH_ACCOUNTS_PROFILES_LICENSES.md](docs/padroes/AUTH_ACCOUNTS_PROFILES_LICENSES.md) · Prompt Mestre **V2**: [PROMPT_MESTRE_APP.md](docs/padroes/PROMPT_MESTRE_APP.md) · [PROMPT_MESTRE_v2.md](PROMPT_MESTRE_v2.md) · Notas: [05/09/2026](docs/NOTAS_2026-09-05.md) · [11/09/2026](docs/NOTAS_2026-09-11.md)

---

## 1. Informações Gerais

| Campo | Valor |
|-------|-------|
| Nome do Projeto | __________________________ |
| Versão | __________________________ |
| Data | __________________________ |
| Autor | __________________________ |
| Cliente | __________________________ |
| Status | Planejamento / Desenvolvimento / Testes / Produção |
| Schema Supabase | __________________________ (ex.: `petcare`) |
| URL YouTube (Comece Aqui) | __________________________ |

---

## 2. Objetivo do Projeto

Responder:

- Qual problema resolve?
- Para quem?
- Qual transformação gera?
- Qual valor entrega?

**Exemplo:** Desenvolver um app PWA de gestão financeira capaz de reduzir em 80% o tempo gasto com controle manual.

---

## 3. Público-alvo

- [ ] Pessoa física
- [ ] Empresas
- [ ] Contadores
- [ ] Produtores rurais
- [ ] Pequenos negócios
- [ ] Outro: __________________________

---

## 4. Personas

| Campo | Persona 1 | Persona 2 |
|-------|-----------|-----------|
| Nome | | |
| Problema | | |
| Objetivo | | |

---

## 5. Escopo

### O que o produto faz

_(descrever)_

### O que o produto NÃO faz

_(descrever — evita retrabalho)_

---

## 6. Funcionalidades

| ID | Funcionalidade | Prioridade | Observação |
|----|----------------|------------|------------|
| F001 | Login | Alta | Senha isolada neste app |
| F002 | Cadastro | Alta | |
| F003 | Dashboard | Alta | |
| F004 | Comece Aqui (1ª aba) | Alta | **Obrigatório** — ver padrão |
| F005 | LGPD / Termos | Alta | **Obrigatório** |
| F006 | Alterar Senha | Alta | **Obrigatório** |
| F007 | Menu sanduíche | Alta | PC + celular — **Obrigatório** |
| F008 | PWA — Instalar App | Alta | PC + celular — **Obrigatório** |
| F009 | Rodapé fixo | Alta | **Obrigatório** |
| | | | |

---

## 7. Fluxo do Usuário

```
Landing (não instalado) → Instalar PWA → Login → Comece Aqui → Dashboard → ... → LGPD/Termos
```

_(detalhar fluxos específicos do app)_

---

## 8. Regras de Negócio

_(ex.: Cliente inadimplente → não pode emitir relatório)_

---

## 9. Modelo de Venda e Monetização (Hotmart)

- Comissão de afiliados: __________________________
- Garantia: __________________________
- O que está incluso na compra: __________________________
- Política de atualizações: __________________________
- Suporte pós-venda: canal e prazo __________________________

| Plano | Preço | Módulos | Limitações |
|-------|-------|---------|------------|
| Trial | | | |
| Básico | | | |
| Profissional | | | |
| Premium | | | |

---

## 10. Licença de Uso e Termos

- Licença **não exclusiva**, uso pessoal, proibida revenda/redistribuição
- Sanções em caso de descumprimento
- Aba **LGPD / Termos de Uso** obrigatória no app (texto adaptado deste capítulo)
- Para planilhas: abas "Comece Aqui" e "Termos de Uso / Licença" obrigatórias

---

## 11. Banco de Dados

> Schema isolado obrigatório — ver [ARQUITETURA_FABRICA_APPS.md](docs/padroes/ARQUITETURA_FABRICA_APPS.md) §8

**Schema deste app:** `__________________________`

### Tabelas (preencher por app)

| Tabela | Campos principais | RLS |
|--------|-------------------|:---:|
| users / profiles | id, email, company_id, password_changed_at | ✅ |
| password_change_log | id, user_id, changed_at, success | ✅ |
| audit_logs | ver [AUDITORIA.md](docs/padroes/AUDITORIA.md) | ✅ |
| | | |

---

## 12. Relacionamentos

_(diagrama ou descrição: Cliente → Pedidos → Itens → Produtos)_

---

## 13. APIs

| Método | Rota | Descrição |
|--------|------|-----------|
| POST | /login | |
| POST | /auth/change-password | Alterar senha — **obrigatório** |
| | | |

---

## 14. Interface (tela por tela)

Cada tela deve documentar: **Objetivo · Campos · Botões · Validações · Mensagens · Layout**

### Telas obrigatórias (padrão fábrica)

| Tela | Ordem | Observação |
|------|:-----:|------------|
| Landing (pré-instalação) | — | PWA não instalado |
| Login | 1 | |
| **Comece Aqui** | 2 | **Primeira aba após login** + link YouTube |
| Dashboard | 3 | |
| **LGPD / Termos** | — | Aba dedicada no menu |
| **Alterar Senha** | — | Menu sanduíche |
| **Rodapé** | — | Todas as telas — ver padrão |

**Rodapé obrigatório:** planilhaprofissional.com · WhatsApp +55 66 99238-8026 · suporte@planilhaprofissional.com

### Telas específicas do app

_(preencher)_

---

## 15. Design System

Paleta e tipografia: ver [ARQUITETURA_FABRICA_APPS.md](docs/padroes/ARQUITETURA_FABRICA_APPS.md) §5

| Papel | HEX |
|-------|-----|
| Fundo | #F8F9FA |
| Verde principal | #184A4E |
| Verde complementar | #9FA488 |
| Dourado | #CAB77D |
| Bege claro | #ECE4BB |

**Fonte:** Tahoma · Tema claro (padrão)

---

## 16. Componentes

- Botão Primário / Secundário
- Modal · Tabela · Toast / Alerta · Loading
- Navbar / Menu sanduíche / Footer (rodapé padrão)
- Botão Instalar PWA

---

## 17. Segurança

Referência: [ARQUITETURA_FABRICA_APPS.md](docs/padroes/ARQUITETURA_FABRICA_APPS.md) §8 · [AUDITORIA.md](docs/padroes/AUDITORIA.md)

- [ ] JWT / Supabase Auth no schema do app
- [ ] RLS em todas as tabelas
- [ ] Service Role nunca no frontend
- [ ] Senha isolada — sem SSO entre apps
- [ ] Schema PostgreSQL isolado
- [ ] Tela e log de alteração de senha
- [ ] Auditoria de alterações
- [ ] LGPD
- [ ] Rate limit e permissões por perfil (Admin, Operador, Cliente)

---

## 18. Performance

- Tempo máximo de resposta: __________________________
- Cache · Paginação · Lazy loading · Compressão

---

## 19. Compatibilidade

- Navegadores: Chrome / Edge (versões atuais)
- Dispositivos: desktop · mobile · PWA instalável
- Requisitos mínimos: __________________________

---

## 20. Testes

- [ ] Login / Cadastro / Editar / Excluir
- [ ] Responsividade (PC + celular)
- [ ] Menu sanduíche (PC + celular)
- [ ] PWA — instalar PC e celular
- [ ] Comece Aqui — 1ª aba + link YouTube
- [ ] LGPD / Termos
- [ ] Rodapé em todas as telas
- [ ] Alterar senha
- [ ] Schema isolado — sem vazamento entre apps
- [ ] Performance · Segurança

Checklist completo: [REQUISITOS_OBRIGATORIOS_APPS.md](docs/padroes/REQUISITOS_OBRIGATORIOS_APPS.md)

---

## 21. Critérios de Aceitação

### Técnico

- [ ] Todos os itens obrigatórios do checklist aprovados
- [ ] Playwright — testes críticos passando

### Comercial

- [ ] Imagens Hotmart nos formatos corretos
- [ ] Página de venda e copy finalizadas
- [ ] Termos publicados no app

---

## 22. Roadmap

| Versão | Entrega |
|--------|---------|
| 1.0 | |
| 2.0 | |
| 3.0 | |

---

## 23. Backlog

_(melhorias futuras)_

---

## 24. Riscos

| Risco | Mitigação |
|-------|-----------|
| Mudança de API externa | |
| Problema de hospedagem | |
| Falha em integração | |
| Escalabilidade | |

---

## 25. Cronograma

| Sprint | Entrega prevista |
|--------|------------------|
| Sprint 1 | |
| Sprint 2 | |
| Sprint 3 | |

---

## 26. Custos

| Item | Valor estimado |
|------|----------------|
| Vercel | |
| Supabase | |
| Domínio | |
| APIs / IA | |

---

## 27. Tecnologias

React · TypeScript · Vite · Shadcn/UI · Tailwind · Supabase · PostgreSQL · PWA · GitHub · Vercel · Playwright

---

## 28. Estrutura de Pastas

```
src/
├── components/
├── pages/
├── hooks/
├── services/
├── lib/
├── types/
├── utils/
├── assets/
├── styles/
supabase/
├── migrations/
docs/
tests/
public/
├── manifest.json
└── icons/
```

---

## 29. Convenções de Código

- Nomes de arquivo fixos — sem variantes
- PascalCase (componentes) · camelCase (funções)
- Interfaces com prefixo `I`
- ESLint + Prettier
- Commits: [VERSIONAMENTO.md](docs/padroes/VERSIONAMENTO.md)

---

## 30. Documentação do Projeto

| Arquivo | Obrigatório |
|---------|:-----------:|
| PRD.md | ✅ |
| README.md | ✅ |
| CHANGELOG.md | ✅ |
| DATABASE.md | ✅ |
| DEPLOY.md | ✅ |
| SECURITY.md | ✅ |

---

## 31. Controle de Versões

| Versão | Autor | Mudança | Data |
|--------|-------|---------|------|
| 1.0.0 | | Criação do PRD | |

---

## 32. Histórico de Alterações

| Data | Versão | Autor | Descrição |
|------|--------|-------|-----------|
| | | | |

---

## 33. Aprovação

| Papel | Nome | Data | Assinatura |
|-------|------|------|------------|
| Cliente | | | |
| Gerente | | | |
| Desenvolvedor | | | |

---

## Desvios de Arquitetura

> Preencher **somente** se este app divergir dos padrões em `docs/padroes/`. Caso contrário, escrever: *Nenhum desvio.*

| Padrão | Desvio proposto | Justificativa | Aprovado |
|--------|-----------------|---------------|:--------:|
| | | | ☐ |

---

## Referências fixas (não alterar)

- [ARQUITETURA_FABRICA_APPS.md](docs/padroes/ARQUITETURA_FABRICA_APPS.md)
- [REQUISITOS_OBRIGATORIOS_APPS.md](docs/padroes/REQUISITOS_OBRIGATORIOS_APPS.md)
- [AUDITORIA.md](docs/padroes/AUDITORIA.md)
- [VERSIONAMENTO.md](docs/padroes/VERSIONAMENTO.md)
- [PP_CORE_PLATFORM.md](PP_CORE_PLATFORM.md)
- [PADRAO_CONSOLIDADO_FABRICA.md](docs/PADRAO_CONSOLIDADO_FABRICA.md) — melhor de cada app analisado

---

*PRD Master — planilhaprofissional.com — Framework v1.1.0*