Início

Tela de Login

/login

Porta de entrada do MDZ ADV. Informe usuário e senha cadastrados. O JWT é guardado em sessionStorage — se fechar a aba, precisa logar de novo (mais seguro contra XSS).

Dicas:

• Esqueceu a senha? Procure o admin do escritório para resetar.
• Sessão expira ao fechar a aba — comportamento esperado, é mais seguro.

Dashboard (Painel Inicial)

/dashboard

Painel consolidado: total de processos ativos, prazos próximos, audiências da semana, alertas, KPIs do escritório. Primeira tela após o login.

Dicas:

• Os cartões mostram comparativos vs. período anterior.
• Use o Assistente IA (ícone no canto inferior) para perguntas livres.
• Clique em qualquer KPI para ir direto à tela detalhada.

Núcleo Jurídico

Lista de Processos

/processos

Catálogo dos processos do escritório. Busca por CNJ, apelido, classe, status. Filtros por advogado responsável, cliente, status (ativo, arquivado, suspenso).

Dicas:

• Use Buscar por CNJ para localizar rápido — o sistema valida o número automaticamente.
• Cadastre um processo novo pelo botão + Novo Processo no topo.
• Cada linha tem botão de Sincronizar com o tribunal (ícone de refresh).

Detalhe do Processo (Multi-fonte)

/processos

Tela do processo com abas por fonte (Datajud, eSAJ, PJe, etc.), badges mostrando quais fontes confirmaram cada movimentação, painel lateral do Assistente IA com contexto do processo já carregado.

Dicas:

• Movimentação com badge Datajud + eSAJ = confirmada por 2 fontes (mais confiável).
• Movimentação com badge Apenas eSAJ = exclusiva — pode ser detalhe interno do tribunal.
• Botão Sincronizar agora atualiza todas as fontes ativas em foreground.
• Painel lateral (ícone 💬) abre o assistente já com contexto do processo.
• Pergunte ao assistente: "casos parecidos com este?", "resuma últimas movimentações".

Clientes

/clientes

Cadastro de clientes pessoa física e jurídica. Cada cliente pode ter N processos vinculados, contatos, documentos e contratos.

Dicas:

• PF e PJ têm campos diferentes — o formulário ajusta automaticamente.
• CPF/CNPJ é validado em tempo real (módulo 11).
• Cliente desativado fica em soft delete — recuperável.

Captação (Leads/CRM)

/leads

Funil comercial do escritório: leads recebidos pelo site, indicação ou captação ativa, com pipeline visual (kanban) por status.

Dicas:

• Arraste cards entre colunas para mudar o status.
• Converter em Cliente transforma o lead em cliente cadastrado mantendo histórico.
• Origem do lead alimenta os relatórios de marketing.

Prazos

/prazos

Controle de prazos processuais com alertas por proximidade (7/3/1 dias). Cálculo automático considerando feriados nacionais e do tribunal.

Dicas:

• Data fatal é a data limite — o sistema alerta ANTES, não NO dia.
• Prazos sugeridos pela IA (a partir de intimações) ficam pendentes para revisão do advogado.
• Status cumprido registra quem cumpriu e quando — auditoria preservada.

Audiências

/audiencias

Agenda de audiências com sync bidirecional opcional para o Google Calendar. Suporta presencial, virtual (link) ou híbrida.

Dicas:

• Para virtual, cole o link do Meet/Zoom no campo Sala online.
• Habilite Google Calendar em /admin/integracoes para sync automático.
• Notas pré e pós-audiência ficam vinculadas ao processo.

Tarefas (Kanban)

/tarefas

Quadro Kanban de tarefas do escritório. Colunas customizáveis por equipe. Atribuição, prioridade, prazo, comentários.

Dicas:

• Arraste para mover entre colunas.
• Comentários ficam no histórico — útil pra auditoria de decisões.
• Tarefa pode estar vinculada a um processo, cliente ou ser livre.

Geração e Protocolo

Peças (Geração com IA)

/peticoes

Geração de peças jurídicas a partir de templates e IA. Templates ficam no banco — IA preenche placeholders, advogado revisa antes de aprovar.

Dicas:

• Sempre revise antes de aprovar — IA sugere, advogado decide.
• Cada peça tem histórico de versões com diff entre elas.
• Exporta em .docx pronto para protocolar.

Protocolos Eletrônicos

/protocolos

Histórico de petições protocoladas eletronicamente (PJe, eSAJ, Projudi). Cada protocolo registra quem assinou, quando, e guarda o comprovante.

Dicas:

• Para protocolar, é obrigatório ter certificado ICP-Brasil A1 (.p12) cadastrado.
• Cadastro do cert: /admin/config-tribunais → aba Certificados.
• Comprovante PDF fica no MinIO — clique em Baixar comprovante.

Jurisprudência (RAG)

/jurisprudencia

Base de jurisprudência indexada no Qdrant para busca semântica. Ao gerar peça, a IA consulta jurisprudência relevante automaticamente.

Dicas:

• Adicione novos julgados pelo botão + Importar.
• Busca por similaridade — não precisa palavra exata.
• Tags ajudam a filtrar (ex.: 'plano de saúde', 'consumidor').

Tribunais e Intimações

Intimações (DJEN)

/intimacoes

Captura automática de intimações via DJEN (Diário de Justiça Eletrônico Nacional). Filtra por OAB do advogado e gera prazos sugeridos.

Dicas:

• Sync automático a cada 6h — configure intervalo em /admin/config-tribunais.
• Prazo é sugerido pela IA — advogado precisa aceitar para virar prazo oficial.
• Intimação não lida fica destacada em vermelho.

Tribunais do Escritório

/admin/tribunais-escritorio

Configura quais tribunais sincronizar (Datajud, PJe, eSAJ, Projudi, e-Proc, STF, STJ, DOU), com qual frequência, e suas credenciais por fonte.

Dicas:

• Datajud, STF, STJ são públicos — só liga e usa.
• PJe exige WSDL do tribunal + CPF/senha ou certificado .p12.
• eSAJ/Projudi exigem OAB + senha do portal do TJ.
• Após 3 erros consecutivos, o sistema pausa o adapter por 1h (circuit breaker).
• Senhas ficam cifradas com Fernet — nunca trafegam em claro.

Config Global de Tribunais (super-admin)

/admin/config-tribunais

Configurações técnicas globais (URL de API, api_keys) das fontes — gerenciadas pelo super-admin. Inclui upload de certificados ICP-Brasil A1 (.p12).

Dicas:

• Upload do .p12 é por advogado por tribunal — cada um cadastra o próprio.
• Senha do .p12 é cifrada com Fernet derivado do SECRET_KEY.
• Teste a conexão de cada adapter pelo botão Testar.

Financeiro e BI

Financeiro

/financeiro

Honorários, parcelas, recebimentos e cobranças via Asaas. Provisão de causa, timesheet, DRE.

Dicas:

• Configurar Asaas em /admin/config-asaas — chave API + ambiente (sandbox/prod).
• Honorário pode ser fixo, êxito ou misto — campos ajustam.
• Cobrança gera link de pagamento por boleto/Pix/cartão.

Relatórios

/relatorios

Relatórios operacionais e gerenciais: produtividade por advogado, vencimento de prazos, processos por classe, financeiro por período.

Dicas:

• Filtre por período pelos campos do topo.
• Exporte para Excel ou PDF.
• Salve filtros recorrentes como favoritos.

Meus Dashboards (BI)

/bi

Dashboards customizáveis por usuário. Arraste widgets do catálogo, configure filtros, salve layouts próprios.

Dicas:

• Cada widget puxa dado em tempo real — clique no relógio para forçar refresh.
• Compartilhe dashboard com outros usuários do escritório.

Operação

Monitoramento Central

/monitoramento

Painel de monitoramento de OABs e processos críticos. Alerta quando movimentação relevante chega.

Dicas:

• Cadastre OABs adicionais no monitoramento — útil pra controlar parceiros.
• Alerta vai por push, e-mail ou WhatsApp conforme preferência.

Notificações

/notificacoes

Caixa de notificações do usuário — eventos do sistema, prazos, intimações, menções em comentários.

Dicas:

• Configure preferências de canal (push/email/WhatsApp) em /admin/preferencias.
• Marca como lida em massa pelo botão Marcar todas como lidas.

Portal do Cliente (visão do cliente)

/clientes

Tela pública que o cliente vê ao acessar com o link gerado pelo escritório. Saudação personalizada, KPIs (processos ativos, prazos, audiências, documentos), lista dos processos e prazos em somente leitura. A gestão dos tokens fica dentro do Hub do Cliente → aba Portal.

Dicas:

• Gere o link na aba Portal dentro do detalhe do cliente.
• Token é longo, aleatório e tem expiração configurável.
• Cliente vê somente os próprios processos — sem login/senha.
• Cada acesso é auditado: IP, data, hora, navegador.

Compliance

Auditoria

/auditoria

Log imutável de todas as ações sensíveis: quem fez o quê, quando, em qual entidade. Trigger no Postgres impede UPDATE/DELETE.

Dicas:

• Filtre por entidade, ação ou usuário.
• Exporte para CSV se precisar entregar para LGPD/perícia.
• Trigger garante imutabilidade — ninguém edita audit log nem com SQL direto.

LGPD

/lgpd

Gestão de solicitações LGPD do titular (acesso, exclusão, portabilidade) e registros de processamento (RPs). Exportação em formato padrão ANPD.

Dicas:

• Toda solicitação tem prazo legal — o sistema alerta no painel.
• Exclusão LGPD respeita anonimização (não delete físico de dados auditados).

Administração

Configuração de IA

/admin/config-ai

Provider de IA (Ollama, OpenAI, Anthropic, OpenRouter), modelo, embedding, temperatura, system prompt. Tudo via banco — não vai pra .env.

Dicas:

• Sempre teste o provider depois de mudar.
• Embedding define a coleção do Qdrant — mudar provider exige reindexação.
• System prompt em pt-BR — define personalidade do assistente.

Hubs (refatoração UX)

Hub do Processo

/processos/{processo_id}

Tela-mãe do processo refatorada em padrão hub split. Nav lateral com 12 abas: Visão geral, Movimentações, Documentos, Prazos, Audiências, Tarefas, Peças, Protocolos, Intimações, Honorários, IA contextual e Auditoria. Hash da URL preservado: /processos/{id}#prazos cai direto na aba.

Dicas:

• Aba IA contextual detecta vínculos com outros processos (mesmo cliente, mesmas partes, mesma classe/assunto, vara, advogado contrário, cadeia recursal, litisconsórcio).
• Cada vínculo tem badge de confiança (Alta/Média/Baixa) e pode ser confirmado ou descartado.
• URL antiga preservada em /processos/{id}/legacy — sem perda de funcionalidade.

Hub do Cliente

/clientes/{cliente_id}

Tela-mãe do cliente refatorada em padrão hub split. Nav lateral com 8 abas: Dados cadastrais, Processos, Contatos, Honorários, Documentos, Portal, LGPD e IA contextual.

Dicas:

• Aba Portal centraliza geração e revogação de tokens de acesso ao portal público.
• Aba IA mostra resumo executivo automático: total de processos, ativos, honorários contratados, a receber.
• URL antiga preservada em /clientes/{id}/legacy.

Diários Oficiais

Diários Oficiais

/diarios

Listagem e busca textual em PDFs de DOU, DJEs estaduais e DOEs estaduais. Pipeline diário (Celery Beat 4× ao dia) baixa PDFs, extrai texto via pdfplumber, indexa em Qdrant pra RAG e em PostgreSQL tsvector pra busca rápida em português.

Dicas:

• Filtros estruturais: UF, tipo (DOU/DJE/DOE/DOM), data início/fim.
• Busca textual com plainto_tsquery('portuguese') — radicalizado e ranqueado.
• Cada edição mostra fonte, caderno, data, páginas, status (pendente/indexado/falha) e trecho contextual com a palavra-chave.
• Botão Sincronizar agora força descoberta em foreground (sem esperar Celery beat).

Perguntar à IA — Diários

/diarios/perguntar

RAG sobre o acervo de PDFs indexados. Embeda a pergunta, busca top-K chunks relevantes no Qdrant filtrados por UF/tipo/data, passa pra LLM responder com base nos trechos + cita as fontes.

Dicas:

• Chips de sugestão: licitações federais, sentenças sobre consumidor, concursos jurídicos, planos de saúde.
• Resposta vem com lista de citações: fonte (DOU, DJE-SP), caderno, data, score de similaridade.
• Filtros UF + tipo permitem direcionar a pergunta a um subconjunto do acervo.

Filtros de Notificação — Diários

/diarios/filtros

Filtros salvos pelo usuário pra receber notificação automática quando edição nova bater palavras-chave. Roda após cada processar_edicao concluir. Escopo opcional por UF, tipo e fontes específicas.

Dicas:

• Match OR entre palavras-chave (uma por linha no formulário).
• Restrições estruturais (UF, tipos) refinam o match.
• Cada disparo gera Notificacao com TipoEvento.SISTEMA + payload com palavras que bateram.
• Histórico: total_disparos + ultimo_disparo_em por filtro.

Detalhe da edição — Diários

/diarios/{diario_id}

Tela de detalhe de uma edição específica do diário oficial. Mostra metadados completos (fonte, caderno, edição, páginas, tamanho), status de indexação, contagem de chunks no Qdrant e prévia do texto extraído.

Dicas:

• Acessada pelo ícone de olho na lista de edições em /diarios.
• Botão PDF original abre a URL pública da edição (quando disponível).
• Prévia exibe os primeiros 2.000 caracteres do texto extraído — útil pra confirmar qualidade do OCR/parsing.
• Contagem de chunks no Qdrant indica se a edição está pronta pra responder via RAG (/diarios/perguntar).

Agenda

Agenda

/agenda

Calendário visual unificado com FullCalendar 6 que agrega audiências, prazos, tarefas com data e apontamentos de timesheet num único panorama. Permite alternar entre visões mês, semana e dia, e filtrar por tipo através de chips coloridos no topo. Cada cor indica a origem do evento: audiência (roxo), prazo (vermelho), tarefa (dourado), timesheet (verde escuro).

Dicas:

• Chips no topo filtram por tipo — clique alterna ativo/inativo. Estado fica salvo na sessão.
• Visões disponíveis: Mês (panorâmica), Semana (timeline horária) e Dia (detalhe do dia).
• Clicar num evento abre a tela original em nova aba — agenda mantém posição e filtros.
• Botão Hoje volta rapidamente ao dia atual em qualquer visão.