← Voltar ao índice

Contábil Core

SaaS brasileiro para escritórios de contabilidade — centraliza atendimento, clientes, obrigações fiscais, documentos e inteligência tributária.

URL: contabil.blackcatcorp.com.br
Backend: Node.js + Express
Frontend: React + Vite
Banco: PostgreSQL 16
Status: 🏗️ Em construção
Express JWT Auth PostgreSQL Multi-tenancy RBAC WhatsApp API IA Tributária React

Especificação do Produto

Missão

SaaS brasileiro para escritórios de contabilidade — centraliza atendimento, clientes, obrigações fiscais, documentos e inteligência tributária.

Usuários-alvo

Escritórios de contabilidade, contadores, analistas fiscais

Status

🏗️ Em construção — contabil.blackcatcorp.com.br (em breve)

Funcionalidades principais
Próximos passos

Endpoints da API

Autenticação — /api/auth

POST/api/auth/register
Registra novo usuário no tenant. Body: { name, email, password, tenant_id }
POST/api/auth/login
Login com email/senha. Retorna JWT com claims de tenant e perfil. Body: { email, password }

Clientes — /api/clients

GET/api/clients Requer JWT
Lista clientes do escritório com paginação e filtros por regime tributário.
POST/api/clients Requer JWT
Cria novo cliente 360°. Body: { name, cnpj, regime_tributario, responsavel_id, ... }
GET/api/clients/:id Requer JWT
Retorna perfil completo do cliente incluindo obrigações, documentos e histórico de atendimento.

Obrigações Fiscais — /api/obligations

GET/api/obligations Requer JWT
Lista obrigações fiscais do período com status (pendente/entregue/atrasada). Suporta filtros por cliente e competência.
POST/api/obligations Requer JWT
Cria obrigação fiscal para cliente. Body: { client_id, tipo, competencia, vencimento, responsavel_id }

Conversas — /api/conversations

GET/api/conversations Requer JWT
Lista conversas de atendimento (WhatsApp + email) com status e cliente vinculado.
POST/api/conversations/:id/messages Requer JWT
Envia mensagem em uma conversa. Body: { content, channel }. Suporta canal WhatsApp e email.

Documentos — /api/documents

GET/api/documents Requer JWT
Lista documentos com versionamento. Filtrável por cliente, tipo e período.
POST/api/documents/upload Requer JWT
Upload de documento com versionamento automático. Multipart/form-data com file e client_id.

Inteligência IA — /api/ai

POST/api/ai/suggest Requer JWT
Gera sugestão tributária supervisionada. Body: { question, client_id, context }. Resposta revisada antes de envio.

Dashboard — /api/dashboard

GET/api/dashboard/metrics Requer JWT
Métricas do escritório: clientes ativos, obrigações pendentes, conversas abertas, documentos recentes.

Saúde

GET/api/health
Healthcheck do servidor. Retorna {"status":"ok","timestamp":"..."}

Arquitetura Docker

contabil-frontend (nginx:80) ─┐
                               ├─ rede blackcat (Caddy proxy)
contabil-backend (3000) ───────┤
                               └─ rede contabil-internal
contabil-postgres (5432) ────── rede contabil-internal

Gerado automaticamente — BlackCat Corp • Voltar ao índice