AppContabill — Plataforma e conexões

Visão geral da plataforma

Um único serviço web (API + interfaces), multi-subdomínio, sessões isoladas por superfície.

App cliente

Produto do dia a dia

Registo de despesas e documentos, OCR, arquivo, contas empresariais e pessoais, ligação a contabilista e mensagens com o escritório.

Backoffice empresa

Gestão interna da empresa

Fluxo dedicado a titulares e colaboradores (NIF empresa): validações, equipa, períodos e visão agregada alinhada com a app.

Backoffice contabilista

Gestão de carteira

Clientes autorizados, documentos, alertas de obrigações, IVA resumido, exportações e canal de mensagens por cliente.

Admin operacional

Centro interno AppContabill

Sem dados comerciais de clientes nas conversas: foco em suporte, moderação, auditoria técnica e operação (ver secção Admin).

Conexões — modelos de utilização

Três formas típicas de “quem liga a quem”. Todas passam por identificação segura (sessão) e regras de permissão na API.

1. Utilizador empresa ↔ contabilista

Empresa simples — um ou mais titulares na conta empresa, com convite ou código de adesão ao contabilista. O escritório vê documentos e estado dentro dos limites de acesso concedidos.

Upload e classificação na app ou backoffice empresa.
Contabilista: leitura/gestão via backoffice de contabilista e APIs de cliente dedicadas.
Mensagens bidirecionais app ↔ contabilista por thread de cliente.

2. Empresa multi-utilizador + contabilista

Conta empresa com colaboradores — titulares e perfis de equipa. Documentação enviada por funcionários associa-se à conta empregadora (evita duplicar ficheiros entre perfis), em linha com o backoffice empresa e métricas operacionais.

O contabilista continua a ver a carteira por cliente empresa, não “N cópias” por colaborador.
Alertas e obrigações podem ser geridos no contexto escritório–cliente.
Admin operacional pode inspeccionar segmentos e tráfego para suporte (sem substituir o contabilista).

3. Utilizador + multi-utilizador + contabilista + admin

Acrescenta a camada Admin: equipa AppContabill com sessão separada da app e sem misturar com a sessão do cliente ou do contabilista.

Cliente / contabilista — trabalho normal em produto (documentos, mensagens produto, exportações).
Admin — painéis internos, métricas, bloqueios, pagamentos e uploads a nível plataforma, com registo de auditoria das operações sensíveis.

Contas pessoais

Dois modos: arquivo privado ou preparação para o contabilista (entrega IRS anual e documentação de suporte).

Modo A

Apenas utilizador

Conta pessoal para organizar documentos e registos sem obrigatoriedade de partilha. Ideal para arquivo pessoal e despesas não empresariais.

Privado por defeitoSem escritório

Modo B

Partilha com contabilista

Quando existe relação de confiança com o contabilista, o mesmo modelo de acessos e convites da vertente empresa pode alinhar-se com a preparação de IRS anual: documentos e meta-dados disponíveis ao escritório conforme permissões, sem confundir com a conta empresa.

IRS / ficha financeiraCanal com escritório

Admin operacional — âmbito exclusivo

O painel interno não é o “super-contabilista”: não substitui o produto nem acede às conversas privadas cliente–contabilista como se fosse um terceiro utilizador.

Áreas cobertas pelo backoffice admin

Autenticação admin própria (login, recuperação de password, sessão isolada).
Dashboard empresarial — vista agregada, segmentos (pessoal, empresa simples, multi, funcionários), uploads deduplicados ao nível plataforma.
Utilizadores — listagem, detalhe, bloqueio, desbloqueio, remoção e hard-delete; purga de contas desligadas.
Clientes bloqueados — lista e reativação.
Contabilistas — listagem, detalhe, papel, perfil, ligar cliente, convites.
Contas pessoais (vista admin) — overview, contas, alertas, uploads, histórico de alertas.
Convites de referência e registo de alertas operacionais.
Uploads & pagamentos — visibilidade para operações e faturação interna.
Auditoria — consulta de eventos administrativos (ver caixa seguinte).
Downloads ténicos — documentos/registos para suporte autorizado.

Inventário técnico (alto nível)

Serviço Node.js (Express), PostgreSQL, sessões persistentes, contentor Docker; APIs JSON sob /api/… com middleware de autenticação por superfície.

Domínio	Função resumida
Auth & contas	Login, registo, recuperação password, contas ligadas, contexto contabilista.
Registos & dashboard	CRUD de lançamentos, totais, orçamento pessoal, deteção de entidades.
Documentos & OCR	Upload, análise de PDF/imagem, extração, duplicados, documentos auxiliares.
Exportação	Relatórios e CSV/PDF conforme regras de conta.
Mensagens	Directas cliente ↔ contabilista (threads por par).
Contabilista	Clientes, documentos de carteira, resumos IVA, convites, alertas de obrigações.
Empresa (backoffice)	Gestão interna empresa, colaboradores, validações, integração com mesma API de negócio.
Seguros & mobile	Integrações específicas e fluxo móvel simplificado.
SaaS	Resolução de subdomínio, contexto `/api/saas/context`, cookies de sessão por host.
Admin	Rotas `/admin/api/…` e páginas estáticas sob `/admin/…`.