# DataVenia

> Software jurídico completo (SaaS) para advogados e escritórios de advocacia, otimizando a gestão de processos, compromissos, tarefas (Kanban), clientes, recortes eletrônicos e relatórios.

Este documento serve como guia de referência rápido para Modelos de Linguagem de IA (LLMs) que auxiliam usuários do DataVenia a realizar tarefas e a entender os recursos do software jurídico.

## Recursos Principais (Features)

- **Busca e Cadastro Automático de Processos**: Robô inteligente que importa e monitora processos ativos nos tribunais através do número da OAB do profissional.
- **Anotações Internas de Processo**: Registro seguro de anotações internas (reuniões, telefonemas, estratégias) e arquivos vinculados diretamente a um processo judicial.
- **Agenda e Kanban**: Calendário integrado para compromissos (audiências, reuniões, prazos) e painel Kanban para acompanhamento visual de tarefas.
- **Recorte Eletrônico (Diários da Justiça)**: Monitoramento diário e automatizado de termos ou OAB em diários oficiais com notificações.
- **Gestão de Clientes**: Cadastro completo de contatos, importação em lote (CSV/VCF) e associação visual a processos via arrastar e soltar (drag and drop).
- **Marcadores Customizados**: Organização visual do acervo processual por meio de etiquetas coloridas (tags).
- **Relatórios Consolidados**: Exportação parametrizada de relatórios em formatos PDF e Excel (XLSX).
- **API REST Oficial para Integração**: API REST pública e oficial para integrar o DataVenia com sistemas externos, ERPs e automações, com documentação Swagger UI disponível em `https://app.dtvweb.com.br/dtv/v1/swagger-ui/index.html`.

---

## Orientações para Usuários e Execução de Tarefas

### 1. Como cadastrar processos automaticamente pela OAB
*Para capturar processos ativos vinculados ao registro profissional nos tribunais parceiros:*
1. Acesse o painel **Início** (Dashboard).
2. Clique no card **Descoberta de Processos** (ou vá no menu lateral em *Processos* > *Cadastrar Novo Processo* (+) > aba *Por OAB*).
3. Insira o número da inscrição **OAB** e selecione a **UF** (Unidade Federativa) correspondente. Clique em **Buscar Processos**.
4. Selecione o profissional retornado pela busca da OAB.
5. *(Opcional)* Escolha ou crie um **Marcador padrão** (ex: "Importados OAB") para identificar esses processos facilmente.
6. Ajuste a barra de limite de processos a capturar (respeitando a cota contratada) e clique em **Cadastrar Processos**. O robô fará a importação em segundo plano.

### 2. Como inserir anotações internas em um processo
*Para registrar informações que não constam nos autos públicos do processo judicial:*
1. No menu lateral, acesse **Processos**.
2. Localize o processo desejado na listagem e clique nele para abrir a tela de **Detalhe do Processo**.
3. Na seção de ações rápidas no topo, clique no botão **Adicionar Anotação** (ícone de bloco de notas com lápis).
4. Digite as observações ou o resumo do atendimento no campo de texto.
5. Ajuste as seguintes configurações:
   - **Privacidade**: Defina a anotação como **Restrita** (visível apenas para o escritório/advogados) ou **Pública** (visível também para clientes autorizados no painel do cliente).
   - **Data**: Edite a data de referência, se necessário (permite datas passadas ou futuras).
   - **Arquivos**: Anexe documentos, fotos ou PDFs atrelados a essa anotação.
6. Clique em **Salvar**. A anotação será indexada cronologicamente na aba de *Andamentos* do processo.

### 3. Como agendar compromissos e organizar tarefas (Kanban)
*Para gerenciar prazos, audiências e fluxos de trabalho do escritório:*
- **Criar Compromisso Geral**: Acesse **Compromissos** no menu lateral e clique em **Cadastrar Novo Compromisso** (+). Preencha título, tipo (Audiência, Reunião, Prazo, Intimação, Tarefa), data, hora e marque periodicidade se houver.
- **Criar Vinculado a Processo**: Abra o detalhe de um processo e clique no botão **Criar Compromisso** ou **Criar Tarefa**.
- **Acompanhamento de Compromissos**: Veja e filtre eventos de calendário na aba **Agenda**.
- **Acompanhamento de Tarefas (Kanban)**: Gerencie o status de execução (A Fazer, Em Andamento, Concluído) no quadro visual da aba **Tarefas**.

### 4. Como monitorar intimações e publicações nos Diários da Justiça (Recorte Eletrônico)
*Para realizar a varredura diária nos diários oficiais e receber alertas:*
1. Expanda a opção **Atualizadores** no menu lateral e clique em **Diários da Justiça**.
2. Na aba **Alvos e Pesquisas**, clique em **Adicionar Advogado** (para buscar por OAB/UF) ou adicione termos textuais customizados (como o nome completo do sócio ou cliente).
3. Selecione os Diários da Justiça (estaduais ou federais) em que o sistema deve realizar a busca diária.
4. Visualize as publicações localizadas na aba **Publicações**. O sistema notifica o usuário assim que novos recortes são encontrados.

### 5. Como gerenciar clientes e importá-los em lote
*Para gerenciar contatos e vinculá-los aos processos ativos:*
- **Cadastro Individual**: Vá em **Clientes** no menu lateral e clique em **Cadastrar Novo Cliente** (+). Preencha a ficha cadastral.
- **Importação em Lote**: Na tela de clientes, clique no botão de upload (**Importar Clientes**). Envie um arquivo no formato `.csv` (com cabeçalhos específicos: `nome, aniversario, endereco, bairro, municipio, cep, uf, telefones, contato, whatsApp, email, comentario`) ou arquivos `.vcf`.
- **Associação Visual a Processo**: Abra a tela de detalhes de qualquer processo. No painel lateral direito (onde a lista de clientes do escritório é exibida), clique sobre o nome do cliente desejado e **arraste e solte** (drag and drop) em cima da área do processo para vinculá-lo instantaneamente.

### 6. Como utilizar Marcadores (Tags) para organizar o acervo
*Para segmentar visualmente seus processos por prioridade, fase, área ou responsável:*
1. **Criar Marcadores**: Acesse **Gerenciar Marcadores** no menu lateral e clique em **Cadastrar Novo Marcador** (+). Defina nome (ex: "Urgente", "Pendente") e cor.
2. **Atribuição Rápida**: Ao criar/editar um processo, selecione o marcador correspondente na caixa de seleção. Alternativamente, na listagem de processos, você pode **arrastar e soltar** um marcador lateral sobre o processo para associá-lo.
3. **Filtrar por Marcador**: No menu lateral, em baixo de "Processos", clique no marcador desejado para filtrar a listagem.

### 7. Como gerar e exportar relatórios
*Para consolidar dados de processos, andamentos, financeiro ou tarefas:*
1. Clique em **Relatórios** no menu lateral.
2. Escolha o módulo desejado (*Processos*, *Clientes*, *Financeiro* ou *Compromissos*) e aplique os filtros de período, marcadores, etc.
3. Selecione o formato de exportação:
   - **PDF**: Relatório formatado ideal para impressão ou prestação de contas.
   - **Excel (XLSX)**: Planilha estruturada para análise e manipulação de dados brutos.
4. Clique em baixar para realizar o download direto.

### 8. Gestão de Consumo e Custos (Créditos e Limites)
*Para entender como as cotas do plano são consumidas:*
- **Consultas de Robôs (Tribunais)**: Consomem os créditos mensais contratados apenas quando o robô faz uma varredura direta no site do tribunal.
- **Atualizações por Diários Oficiais e Push**: São **gratuitas, ilimitadas e não consomem créditos** para todos os processos já cadastrados na base do cliente.
- **Pesquisa de Processos nos Diários**: O monitoramento de processos cadastrados nos Diários Oficiais é limitado apenas pela quantidade total de processos permitida no plano do usuário, sem cobranças extras por publicação localizada.

### 9. Integração via API REST Oficial
*Para integrar o DataVenia com outros sistemas, ERPs ou automações:*
- O DataVenia disponibiliza uma **API REST Oficial** para integração direta de dados.
- A documentação interativa com todos os endpoints e modelos (Swagger UI) está disponível em: `https://app.dtvweb.com.br/dtv/v1/swagger-ui/index.html`.

---

## Estrutura de Rotas e URLs do Sistema
Para orientar navegações no sistema, utilize os seguintes caminhos de rota padrão:
- Dashboard Principal: `/`
- Processos Judiciais: `/Processos`
- Detalhes do Processo: `/DetalheProcesso`
- Agenda de Compromissos: `/Agenda`
- Painel de Compromissos: `/Compromissos`
- Quadro de Tarefas (Kanban): `/Tarefas`
- Clientes: `/Clientes`
- Diários da Justiça (Recortes): `/RecorteEletronico`
- Relatórios do Sistema: `/Relatorios`
- Configuração de Marcadores: `/GerenciarMarcadores`
- Assinatura e Planos: `/Assinatura`
- Documentação da API REST Oficial (Swagger UI): `https://app.dtvweb.com.br/dtv/v1/swagger-ui/index.html`