JurisIntel Dashboard

Um aplicativo inteligente para pesquisa de jurisprudência, análise de precedentes e apresentação de insights jurídicos em dashboards, complementado por guias práticos para peticionamento e um gerador de prompts para pesquisa aprofundada.

Funcionalidades Principais

• Análise Jurisprudencial Detalhada: Pesquisa e exibe teses firmadas pelo STJ, precedentes relevantes, evolução temporal de casos e entendimentos, além de identificar divergências jurisprudenciais.
• Guias Práticos para Advogados: Oferece explicações e exemplos sobre prequestionamento e elementos essenciais do Recurso Especial.
• Gerador de Prompts Avançados: Cria prompts personalizados para pesquisa jurídica profunda, direcionados a Tribunais Estaduais e fontes doutrinárias, utilizando o tema da pesquisa principal como base.
• Relatórios Exportáveis: Permite gerar e baixar relatórios completos da análise e dos guias em formatos HTML (com estilo) e Markdown.
• Links para Fontes: Inclui links diretos para as fontes das teses e precedentes, quando disponíveis.
• Interface Moderna e Responsiva: Construído com foco na experiência do usuário, utilizando Tailwind CSS para um design limpo e adaptável.

Tecnologias Utilizadas

• React: Biblioteca JavaScript para construção da interface do usuário.
• TypeScript: Superset do JavaScript que adiciona tipagem estática.
• Tailwind CSS: Framework CSS utility-first para estilização rápida e customizável.
• Google Gemini API (@google/genai): Para análise jurídica inteligente e geração de conteúdo.
• Recharts: Biblioteca de gráficos para visualização de dados (evolução temporal).
• ES Modules no Navegador: Carregamento de módulos JavaScript diretamente no navegador via importmap.

Como Começar

Siga estas instruções para configurar e executar o projeto.

Pré-requisitos

• Git instalado.
• Um navegador web moderno (Chrome, Firefox, Edge, Safari).
• Docker Desktop instalado e rodando (inclui Docker Compose).
• Uma chave de API válida para o Google Gemini. Você pode obter uma no Google AI Studio.

1. Clonar o Repositório

Primeiro, clone este repositório para sua máquina local. Se você ainda não criou um repositório no GitHub para este projeto, veja a seção "Configurando o Repositório no GitHub" mais abaixo.

# Substitua pela URL do seu repositório (se já existir)
# git clone https://github.com/SEU_USUARIO/jurisintel-dashboard.git

# Se você recebeu os arquivos de outra forma, apenas navegue até o diretório do projeto
cd path/to/your/jurisintel-dashboard

2. Configurar a Chave da API do Gemini

O aplicativo requer uma chave de API do Google Gemini para funcionar.

Crie um arquivo .env.local na raiz do seu projeto e adicione sua chave de API. Este arquivo será lido pelo processo de build do Docker.

VITE_API_KEY=SUA_CHAVE_API_DO_GEMINI_AQUI

Importante: O nome da variável de ambiente deve começar com VITE_ para ser exposta ao código frontend pelo Vite dentro do container Docker durante o build.

3. Executar com Docker Compose

Navegue até o diretório raiz do projeto no seu terminal.

Execute o script docker-setup.sh para construir a imagem, iniciar o container e configurar o volume compartilhado para relatórios. Este script também removerá todos os recursos do Docker ao ser interrompido (Ctrl+C).

chmod +x ./docker-setup.sh
./docker-setup.sh

O aplicativo estará disponível em http://localhost:5005.

Os relatórios gerados serão salvos na pasta reports na raiz do seu projeto local, que é compartilhada com o container Docker.

Para parar a aplicação e limpar os recursos do Docker, pressione Ctrl+C no terminal onde o script está rodando.

Execução Manual com Docker Compose (Alternativa)

Se preferir, você pode gerenciar os contêineres manualmente:

• Construir a imagem:

  docker-compose build

• Iniciar os contêineres:

  docker-compose up -d

• Verificar os logs:

  docker-compose logs -f

• Parar os contêineres e remover volumes e imagens:

  docker-compose down --volumes --rmi all

Configurando o Repositório no GitHub (Se você ainda não o fez)

Se você recebeu os arquivos do projeto e quer criar seu próprio repositório no GitHub para versionamento:

1. Vá para o GitHub e crie um novo repositório. Você pode nomeá-lo, por exemplo, jurisintel-dashboard.
2. No diretório do seu projeto local (onde estão os arquivos index.html, etc.), inicialize um repositório Git (se ainda não for um):

   git init -b main

3. Adicione todos os arquivos ao Git:

   git add .

4. Faça o primeiro commit:

   git commit -m "Commit inicial do JurisIntel Dashboard"

5. Conecte seu repositório local ao repositório remoto que você criou no GitHub:

   # Substitua SEU_USUARIO e NOME_DO_SEU_REPOSITORIO pela URL correta do seu repo no GitHub
   git remote add origin https://github.com/SEU_USUARIO/NOME_DO_SEU_REPOSITORIO.git

6. Envie seus arquivos para o GitHub:

   git push -u origin main

Agora seu código estará no GitHub! Lembre-se do aviso sobre a chave de API: não envie sua chave diretamente no código para um repositório público.

Estrutura do Projeto (Visão Geral)

jurisintel-dashboard/
├── README.md                   # Este arquivo
├── index.html                  # Ponto de entrada HTML principal
├── index.tsx                   # Ponto de entrada do React
├── App.tsx                     # Componente principal da aplicação
├── metadata.json               # Metadados da aplicação
├── services/
│   └── geminiService.ts        # Lógica para interagir com a API Gemini
├── components/                 # Componentes React reutilizáveis
│   ├── SearchBar.tsx
│   ├── Tabs.tsx
│   ├── Card.tsx
│   ├── LoadingSpinner.tsx
│   ├── DashboardSection.tsx
│   ├── GuidanceSection.tsx
│   ├── PromptGeneratorSection.tsx
│   └── Icons.tsx               # Componentes de ícones SVG
└── types.ts                    # Definições de tipos TypeScript

Contribuições

Contribuições são bem-vindas! Se você tiver sugestões ou melhorias, sinta-se à vontade para abrir uma issue ou um pull request (se aplicável ao seu fluxo de trabalho).

Licença

Este projeto pode ser distribuído sob a licença MIT (ou outra de sua escolha). Adicione um arquivo LICENSE se desejar especificar uma.