type: conventions

tags: [shared, conventions]

created: 2026-06-26

Convenções — SHARED

Regra de Ouro

> "Vai quebrar?" — Antes de qualquer mudança em produção, confirmar com o usuário.

Padrões de Trabalho

Builds Node

• - Sempre usar nvm use 20 antes de comandos node/npm
• - Node path: /root/.nvm/versions/node/v20.20.2/bin/node

SQL

• - NUNCA usar triplos backticks em SQL copiado — avisar o usuário
• - Usar INSERT ... ON CONFLICT DO NOTHING — nunca DELETE ou UPDATE destrutivo

Meta WhatsApp

• - SEMPRE confirmar qual sistema antes de mexer: ComercialRS ou Chatwoot?
• - ComercialRS Meta: webhook em /var/www/comercialrs/data/meta_webhook_vps_service.py (porta 8083) — ÚNICO sistema com Meta Business API
• - Chatwoot: inbox próprio WhatsApp, NÃO tem Meta Business API — NÃO conflitar nunca

Auth

• - ComercialRS usa Supabase Cloud (dauftiqcvgaydddoxqhh)
• - Auth local (VPS) em deploy-vps-auth-1 porta 9999

after contexto compressão

• - Verificar estado real antes de assumir — não confiar só na memória

---

Estrutura de Arquivos

`

TOOLS/ — Scripts, migrations SQL, utilities

DOCUMENTATION/ — Documentação de referência

LOGS/ — Histórico de sessões (YYYY-MM-DD.md)

`

---

Nomenclatura de Arquivos

Tipo	Padrão
---	---
Migration SQL	YYYYMMDD_descricao.sql
Log de sessão	YYYY-MM-DD.md
Skill	skill-nome.md

---

Regra de Conflito

Se vault e memória local contradizem → vault vence

---

Hermes Insights / RelatoriosRS — Regra de Desenvolvimento

> ATENÇÃO: Sistema de relatórios em produção — PROTEGIDO

Regras fixas:

1. NÃO remover, desativar ou alterar sistemas de leitura que estão funcionando

2. Sistema de relatórios é o mesmo — o que muda é só visual e praticidade (UX/UI)

3. Qualquer mudança em produção — SOMENTE com ordem explícita do usuário

4. Adições são permitidas, mas nunca como substituição do que já existe e funciona

5. Regra de ouro: "Vai quebrar?" — confirmar antes de tocar qualquer coisa

O que EXISTE e NÃO PODE SER REMOVIDO:

• - Score engine (cron noturno)
• - Commercial reports (Gemini IA)
• - Clientes em espera API
• - Dashboard + paineis existentes
• - 16 relatórios individuais de agentes

Última atualização: 2026-06-29