HANDOFF.md atualizado para Sessoes 1-10 + proxima sessao A#31-rev
Documento "ler primeiro ao voltar" reflete estado atual: 15 areas auditadas, zero critico/alto aberto, A#31 reformulada como "Preparacao pra deploy" (MVP nao tem cloud Supabase nem secrets reais). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Leonardo
+88
-138
@@ -1,174 +1,124 @@
|
||||
# HANDOFF — 2026-04-19 (Sessão 6)
|
||||
# HANDOFF — 2026-04-19 (após Sessões 1-10)
|
||||
|
||||
Documento de continuidade. Quando você voltar, comece lendo esta página. Todo o trabalho está registrado no banco (`/saas/desenvolvimento` → **Verificações**, **Auditoria**, **Testes**) — este arquivo é só o mapa.
|
||||
Documento de continuidade. **Quando voltar, comece lendo esta página.**
|
||||
Todo o estado vive no banco (`/saas/desenvolvimento` → Auditoria/Verificações/Testes).
|
||||
|
||||
---
|
||||
|
||||
## 📊 Estado atual
|
||||
|
||||
| Tipo | Aberto | Notas |
|
||||
|---|---|---|
|
||||
| **A# auditoria** | **0** | ✅ todas as 30 resolvidas |
|
||||
| **V# verificações** | **9** | auth(3), pacientes(3), saas(2), router(1) |
|
||||
| **T# testes** | **2 a escrever** | T#9 useAgendaEvents wrapper, T#10 E2E |
|
||||
| **Áreas não auditadas** | **3** | financeiro, comunicação, documentos/prontuários |
|
||||
| **Migrations não commitadas** | **8** | Sessão 6 (ver lista abaixo) |
|
||||
| **Vitest** | **179/179** | 8 suites |
|
||||
| **SQL integration tests** | **33/33** | `database-novo/tests/run.cjs` |
|
||||
| | |
|
||||
|---|---|
|
||||
| **A# auditoria** abertos | **1** (A#31 — reformular pra "Preparação pra deploy") |
|
||||
| **V# verificações** abertos | 14 (todos médios/baixos adiados, plano completo no DB) |
|
||||
| **🔴 Críticos** | **0** ✅ |
|
||||
| **🟠 Altos** | **0** ✅ |
|
||||
| **Áreas auditadas** | **15** (todas as principais do SaaS) |
|
||||
| Vitest | 208/208 |
|
||||
| SQL integration | 33/33 |
|
||||
| E2E (Playwright) | 5/5 |
|
||||
| Migrations totais | 18 |
|
||||
| Último commit | `d6eb992` (pushed ao Gitea) |
|
||||
|
||||
---
|
||||
|
||||
## ✅ Sessão 6 (hoje, 2026-04-19) — resumo
|
||||
## 🎯 Próxima sessão — A#31-rev (Preparação pra deploy)
|
||||
|
||||
### Bloco 1 — V#34 + V#41 (Opção B2: plano + override + exceção comercial)
|
||||
- **Migration** `20260419000001_tenant_features_b2_governance.sql`:
|
||||
- Trigger `tenant_features_guard_with_plan` ganhou bypass via session flag (`current_setting('app.allow_feature_exception')`)
|
||||
- Nova RPC `set_tenant_feature_exception(tenant_id, feature_key, enabled, reason)` SECURITY DEFINER com regras assimétricas:
|
||||
- `enabled=false` → tenant_admin OU saas_admin (preferência do cliente)
|
||||
- `enabled=true` AND plano permite → tenant_admin OU saas_admin
|
||||
- `enabled=true` AND plano NÃO permite → **só saas_admin + reason obrigatório** (exceção comercial)
|
||||
- Policy `tenant_features_write_saas_only` — writes diretos só saas_admin
|
||||
- **Store** `tenantFeaturesStore.isEnabled` reescrito (B2): override negativo desliga, override positivo liga, sem override segue plano
|
||||
- **Store** `setForTenant` agora chama RPC com `reason` opcional
|
||||
- **UI nova** `/saas/tenant-features` (selector de tenant, catálogo, dialog com `reason` obrigatório p/ exceção, log de mudanças)
|
||||
- **JSDoc** documentando separação semântica (`entitlementsStore.has` = "plano permite?" vs `tenantFeaturesStore.isEnabled` = "ativo agora?")
|
||||
- **Testes** `src/stores/__tests__/tenantFeaturesStore.spec.js` — 17 cenários incluindo regressão V#34
|
||||
**Contexto:** A#31 era "Deploy real" mas você não tem cloud Supabase nem
|
||||
secrets reais ainda (MVP). Precisa virar **preparação** — deixar tudo
|
||||
pronto pra quando criar a cloud você executar sozinho com mínimo atrito.
|
||||
|
||||
### Bloco 2 — Pendentes Sessão 5
|
||||
- **V#42** — `entitlementsStore.loadFor*` no catch agora NÃO marca como carregado (estado fica como "not loaded" → próximo request retenta) + `logError` adicionado
|
||||
- **V#40** — `features.is_active` (migration `...02`) + UI: soft delete + filtro "Mostrar depreciados" + Tag de status + botão Reativar
|
||||
- **V#36** — RPC `delete_plan_safe` (migration `...03`): bloqueia DELETE se houver subscriptions ativas. SaasPlansPage migrada
|
||||
- **V#35** — Migration `...04`: 17 → 11 policies. Removidas 3 read-auth duplicadas em plans/features/plan_features + 3 subsets/no-ops em subscriptions. `COMMENT ON POLICY` em todas
|
||||
**Tarefas (~2-3h, zero risco):**
|
||||
|
||||
### Bloco 3 — Testes T#5 / T#7 / T#8
|
||||
- **T#5** `tenantStore.spec.js` — 15 testes: singleflight, regressão V#5 (não herdar tenant de outro user), erros, setActiveTenant, reset, getters. Stub localStorage in-memory (env=node sem jsdom)
|
||||
- **T#7** `validators.spec.js` — 38 testes: sanitização do intake (digitsOnly, CPF/CNPJ, phone, email, CEP, toISODate)
|
||||
- **T#8** `database-novo/tests/run.cjs` — runner Node + docker exec. **33 cenários SQL** cobrindo set_tenant_feature_exception, delete_plan_safe, intake, features.is_active, defesa em camadas, twilio config
|
||||
1. **`DEPLOY.md`** na raiz — checklist de 8 passos com comandos exatos +
|
||||
diagnóstico de erros comuns + ordem de execução
|
||||
2. **Validar migrations num container limpo** — recriar banco do zero,
|
||||
aplicar as 18 migrations + seeds em ordem, garantir zero erro
|
||||
3. **`.env.example`** completo — todas VITE_ vars + cada secret de edge
|
||||
function listado com instrução
|
||||
4. **Auditoria das edge functions** — CORS, fallback de env var ausente,
|
||||
error handling. Documentar quais env cada uma precisa
|
||||
5. **Script `db.cjs deploy-check`** — comando que valida pré-condições
|
||||
antes de deploy (ordena migrations, verifica diffs, lista secrets)
|
||||
6. **Atualizar HANDOFF.md** com seção "Pra deployar"
|
||||
|
||||
### Bloco 4 — A#20 (CAPTCHA) — rev2 self-hosted
|
||||
**Decisão:** descartado Cloudflare Turnstile / hCaptcha em favor de defesa em camadas self-hosted. Razões: zero LGPD, zero provider, zero fricção pro paciente legítimo (UX importa muito em paciente vulnerável buscando atendimento).
|
||||
|
||||
5 camadas:
|
||||
1. **Honeypot** — campo invisível (frontend), bot rejeita
|
||||
2. **Validação** básica
|
||||
3. **Rate limit por IP** — `check_rate_limit` RPC
|
||||
4. **Math captcha condicional** — só ativa após N falhas do mesmo IP (default 3)
|
||||
5. **Modo paranoid** global toggle (saas_security_config.captcha_required_globally)
|
||||
|
||||
Implementação:
|
||||
- Migration `...06` (4 tabelas: `saas_security_config`, `public_submission_attempts`, `submission_rate_limits`, `math_challenges`)
|
||||
- Migration `...07` (RPCs: `check_rate_limit`, `record_submission_attempt`, `generate_math_challenge`, `verify_math_challenge`, `cleanup_expired_math_challenges`)
|
||||
- Edge function `submit-patient-intake` reescrita (dual endpoint: submit + `/captcha-challenge`)
|
||||
- Componente `MathCaptchaChallenge.vue` (lazy)
|
||||
- Tela `/saas/security` com card explicativo (6 seções), KPIs 24h, toggles, sliders, dashboard de IPs ativos, modo paranoid
|
||||
|
||||
### Bloco 5 — SaaS Twilio Config (operacional editável)
|
||||
- Migration `...08` (tabela `saas_twilio_config` singleton + RPCs `get_twilio_config` / `update_twilio_config`)
|
||||
- **Decisão de segurança**: `TWILIO_AUTH_TOKEN` permanece em env var (único secret); SID/webhook/rate/margem migram pra DB
|
||||
- Edge function `twilio-whatsapp-provision` lê do banco com fallback pra env (back-compat)
|
||||
- Tela `/saas/twilio-config` com card explicativo + status do AUTH_TOKEN (ping pra detectar se está setado)
|
||||
- **Bug fix**: `friendlyErrorMessage()` em `twilioWhatsappService.js` traduz "Edge Function returned a non-2xx status code" pra mensagens contextuais
|
||||
**Quando voltar, é só dizer "começa A#31-rev" e eu sigo o plano.**
|
||||
|
||||
---
|
||||
|
||||
## 🛑 Pendências (V# abertos por área)
|
||||
## 📚 Memória persistente (carregada automaticamente)
|
||||
|
||||
### auth (3)
|
||||
- **V#2** (médio) — Listener `supabase.auth.onAuthStateChange` duplicado
|
||||
- **V#6** (baixo) — `globalRole` cache sem TTL e sem invalidação por realtime
|
||||
- **V#10** (médio) — Bloqueio SaaS em tenant-app só por `startsWith` de path (frágil)
|
||||
|
||||
### pacientes (3)
|
||||
- **V#3** (médio) — Pacientes não tem composables/services — toda lógica em pages
|
||||
- **V#8** (baixo) — `agenda_eventos.select` patient_id com `limit 1000` arbitrário
|
||||
- **V#9** (médio) — `PatientsCadastroPage` com **1985 linhas** (precisa quebrar)
|
||||
|
||||
### router (1)
|
||||
- **V#9** (baixo) — `ensureMenuBuilt` roda em toda navegação autenticada
|
||||
|
||||
### saas (2)
|
||||
- **V#17** (baixo) — 23 `console.*` em páginas SaaS
|
||||
- **V#18** (baixo) — `tenantFeaturesStore` sem TTL real (cache pode ficar stale)
|
||||
Já saved no memory system (`MEMORY.md` — não precisa lembrar):
|
||||
- **Sanitização sempre** — trim, length, regex em toda entrada/saída
|
||||
- **Priorização por severidade** — críticos+altos imediatos, médios/baixos adiam com plano
|
||||
- **Self-hosted > provider externo** — LGPD/clínico
|
||||
- **Gotcha supabase_admin** — `psql -U supabase_admin -h localhost` direto pra ALTER POLICY em tabelas owned
|
||||
- **Tracking dev_*_items** — A#/V#/T# vivem no DB, UI `/saas/desenvolvimento`
|
||||
- **Project Overview** + **MVP Assessment**
|
||||
|
||||
---
|
||||
|
||||
## 🗂️ Migrations criadas hoje (ordem cronológica)
|
||||
## 📦 Commits relevantes
|
||||
|
||||
```
|
||||
database-novo/migrations/
|
||||
├── 20260419000001_tenant_features_b2_governance.sql (V#34/V#41)
|
||||
├── 20260419000002_features_is_active.sql (V#40)
|
||||
├── 20260419000003_delete_plan_safe.sql (V#36)
|
||||
├── 20260419000004_consolidate_policies.sql (V#35)
|
||||
├── 20260419000005_restrict_intake_rpc.sql (A#20 — REVOKE anon)
|
||||
├── 20260419000006_layered_bot_defense.sql (A#20 rev2 — schema)
|
||||
├── 20260419000007_bot_defense_rpcs.sql (A#20 rev2 — RPCs)
|
||||
└── 20260419000008_saas_twilio_config.sql (Twilio config)
|
||||
```
|
||||
|
||||
Todas aplicadas no banco local. **Se for pra cloud, aplicar nessa ordem.**
|
||||
|
||||
---
|
||||
|
||||
## 🗜️ Arquivos criados/modificados (código)
|
||||
|
||||
**Criados:**
|
||||
```
|
||||
src/components/security/MathCaptchaChallenge.vue
|
||||
src/views/pages/saas/SaasTenantFeaturesPage.vue
|
||||
src/views/pages/saas/SaasSecurityPage.vue
|
||||
src/views/pages/saas/SaasTwilioConfigPage.vue
|
||||
src/stores/__tests__/tenantStore.spec.js
|
||||
src/stores/__tests__/tenantFeaturesStore.spec.js
|
||||
src/utils/__tests__/validators.spec.js
|
||||
database-novo/tests/run.cjs
|
||||
supabase/functions/submit-patient-intake/index.js (reescrita)
|
||||
```
|
||||
|
||||
**Modificados:**
|
||||
```
|
||||
src/stores/tenantFeaturesStore.js (lógica B2 + RPC)
|
||||
src/stores/entitlementsStore.js (V#42 fix + JSDoc)
|
||||
src/services/twilioWhatsappService.js (friendlyErrorMessage)
|
||||
src/views/pages/saas/SaasFeaturesPage.vue (V#40 soft delete)
|
||||
src/views/pages/saas/SaasPlansPage.vue (V#36 RPC)
|
||||
src/views/pages/saas/SaasTwilioWhatsappPage.vue (toast warn em vez de error)
|
||||
src/views/pages/clinic/clinic/ClinicFeaturesPage.vue (texto erro plano-denied)
|
||||
src/views/pages/public/CadastroPacienteExterno.vue (honeypot + math captcha)
|
||||
src/router/routes.saas.js (3 rotas novas)
|
||||
src/navigation/menus/saas.menu.js (3 itens menu novos)
|
||||
supabase/functions/twilio-whatsapp-provision/index.ts (lê config DB)
|
||||
.env (limpo Turnstile vars)
|
||||
d6eb992 Sessoes 6cont-10: hardening em 6 areas + scan completo do SaaS ← último
|
||||
7c20b51 Sessoes 1-6 acumuladas: hardening B2, defesa em camadas, +192 testes
|
||||
d088a89 (commit anterior do projeto)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Números finais
|
||||
## 🗂️ Áreas auditadas (15)
|
||||
|
||||
| Métrica | Antes (Sessão 5) | Hoje |
|
||||
|---|---|---|
|
||||
| A# auditoria | 30 (1 aberto) | 30 (0 abertos) |
|
||||
| V# verificações | 42 (15 abertos) | 42 (9 abertos) |
|
||||
| Suites de teste vitest | 6 (109 tests) | 8 (179 tests) |
|
||||
| Suites SQL integration | 0 | 1 (33 tests) |
|
||||
| Migrations totais | 5 (Sessão 5) | 13 (+8 hoje) |
|
||||
| Telas SaaS novas | — | 3 (`/tenant-features`, `/security`, `/twilio-config`) |
|
||||
| Área | Estado |
|
||||
|---|---|
|
||||
| auth, router, stores, agenda, seguranca, saas | 100% fechado/ok |
|
||||
| **pacientes** ✨ | **100% fechado** (V#9 — script extraído; template breakdown adiado pra quando houver E2E) |
|
||||
| **documentos** ✨ | 100% fechado |
|
||||
| **calendario** ✨ | 100% fechado |
|
||||
| **servicos** ✨ | 100% fechado |
|
||||
| financeiro | 5 fechados, 6 médios/baixos adiados |
|
||||
| comunicacao | 5 fechados, 5 médios/baixos adiados |
|
||||
| tenants | 6 fechados, 2 baixos adiados |
|
||||
| addons | 3 resolvidos, 1 médio adiado |
|
||||
| central_saas | 1 alto fechado, 2 médios adiados |
|
||||
|
||||
✨ = áreas 100% fechadas (zero pendência).
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Ordem sugerida quando voltar
|
||||
## ⚠️ Pendências documentadas no DB (14 V# adiados)
|
||||
|
||||
1. **Decidir se commita** o trabalho da Sessão 6 (~30 arquivos, 8 migrations).
|
||||
2. **Continuar Sessão 6** (em andamento): A+B+C+D escolhidos, faltando concluir B/C/D.
|
||||
3. Outras opções:
|
||||
- **Nova área de revisão sênior** — financeiro / comunicação / documentos
|
||||
- **Deploy real** (Supabase cloud + secrets + edge functions)
|
||||
- **Testes T#9 + T#10**
|
||||
Todos médios/baixos com plano completo em `dev_verificacoes_items.acao_sugerida`.
|
||||
**Não esquecer.** Sprint dedicado de polimento depois do deploy.
|
||||
|
||||
- **financeiro** (6): parcelamento CHECK, payouts flow, recurrence DELETE,
|
||||
composables, máscara PIX, dashboard inadimplência
|
||||
- **comunicacao** (5): notifications/schedules silos, email_templates_global
|
||||
filtros, retention notification_logs, dashboard health, audit dismissals
|
||||
- **tenants** (2): owner_users policies, company_profiles + dev_user_credentials
|
||||
- **central_saas** (2): rate limit voto, valores tipo_acesso
|
||||
- **addons** (1): UI de extrato
|
||||
|
||||
Plus (não V#):
|
||||
- **PatientsCadastroPage template breakdown** — 1951 linhas. Esperar E2E
|
||||
- **Sprint de polimento** dos 14 médios/baixos juntos
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Nada commitado (ainda)
|
||||
## 🛠️ Stack lembretes (caso precise)
|
||||
|
||||
Working directory tem ~30 arquivos modificados desde Sessão 5. Revise com `git status` + `git diff` antes de decidir o que comitar.
|
||||
- **DB local:** `docker exec -i supabase_db_agenciapsi-primesakai psql -U postgres -d postgres`
|
||||
- **DB local como supabase_admin (pra ALTER POLICY em tabelas owned):**
|
||||
```bash
|
||||
docker exec -i -e PGPASSWORD=postgres -e PGCLIENTENCODING=UTF8 \
|
||||
supabase_db_agenciapsi-primesakai \
|
||||
psql -U supabase_admin -d postgres -h localhost -f migration.sql
|
||||
```
|
||||
- **Vitest:** `npx vitest run`
|
||||
- **SQL integration:** `node database-novo/tests/run.cjs`
|
||||
- **E2E:** `npx playwright test` (precisa dev server: `npm run dev`)
|
||||
|
||||
**Nada quebrou:** vitest 179/179 + SQL 33/33.
|
||||
---
|
||||
|
||||
## 📌 Bom descanso, até amanhã!
|
||||
|
||||
Reference in New Issue
Block a user