sr-cardoso-backend
Sr Cardoso 后端 Cloud Run/Express/Firestore。用于创建或修改端点、JWT 认证、日程规则、财务、品牌、WhatsApp、定时任务或 Firestore 模型设计。
📖 中文导读:Sr Cardoso 后端 Cloud Run/Express/Firestore。用于创建或修改端点、JWT 认证、日程规则、财务、品牌、WhatsApp、定时任务或 Firestore 模型设计。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: sr-cardoso-backend description: Backend Cloud Run/Express/Firestore do Sr Cardoso. Use quando criar ou alterar endpoints, auth JWT, regras de agenda, financeiro, branding, WhatsApp, cron jobs, ou modelagem Firestore.
Sr Cardoso Backend
Overview
Executar tarefas no backend Express/Cloud Run com Firestore, respeitando regras de negocio e contratos com o frontend.
Entradas e estrutura
- Iniciar por
apps/server/src/index.tseapps/server/src/app.ts. - Usar
apps/server/src/routes/public.tspara rotas publicas. - Usar
apps/server/src/routes/admin.tspara rotas admin e RBAC. - Usar
apps/server/src/lib/*para auth, finance, branding e Evolution API. - Usar
apps/server/src/services/whatsappNotifications.tspara envios automaticos.
Auth e RBAC
- Usar
requireAdminerequireMasterdeapps/server/src/lib/adminAuth.ts. - Manter claims: role, username, barberId.
- Manter token JWT HS256 com
ADMIN_JWT_SECRET.
Modelagem Firestore (resumo)
barbers,bookings,customers,adminUsers.- Subcolecao
barbers/{barberId}/slots. - Configs em
settings/finance,settings/branding,settings/whatsapp-notifications. - Filas em
whatsappMessageQueueewhatsappOutbound.
Regras de agenda
- Usar timezone
America/Sao_Paulo. - Validar slots em 30 minutos e domingo fechado.
- Respeitar schedule configurado do barbeiro.
Quando criar/alterar endpoints
- Validar input com Zod (preferir schemas de
packages/shared). - Atualizar tipos/contratos em
packages/sharedse necessario. - Atualizar
apps/web/src/lib/api.tspara refletir novos endpoints. - Verificar necessidade de index em
firebase/firestore.indexes.json.
Transacoes Firestore
- Ler documentos antes de escrever dentro da transacao.
- Usar
FieldValue.serverTimestamp()para createdAt/updatedAt.
Cron
- Proteger
/api/cron/*comCRON_SECRET. - Aceitar
x-cron-secretoux-cron-key.
Branding e upload
- Usar
apps/server/src/lib/branding.ts. - Requer
GCP_STORAGE_BUCKETe permissao da service account.
Observacoes
- Evitar Firebase SDK no frontend; toda escrita deve passar pelo backend.
apps/functionse legado; nao usar como fonte de verdade.