Documentação do Advvia (Beta)¶

Bem-vindo(a) à documentação para usuários do Advvia.

Esta pasta concentra os manuais voltados a quem usa o sistema. Para documentação técnica (API, arquitetura, deploy), veja ../advvia-api-docs.md e o ../README.md na raiz do projeto.

Propósito do Advvia¶

O Advvia existe para tornar possível a comunicação estruturada, clara e completa entre advogado e cliente.

Em vez de informações sobre o caso ficarem espalhadas em mensagens de WhatsApp, emails soltos e pastas de Drive, tudo é reunido em um espaço comum. Para isso, o sistema combina:

Funcionalidades de organização das informações — uma forma sistemática de registrar fatos, processos, tarefas e documentos do caso.
Ferramentas de comunicação — um espaço comum onde advogado, cliente e demais interessados acompanham o mesmo caso, com a mesma informação atualizada à medida que ele evolui.

Por onde começar¶

Escolha o manual conforme o seu papel no Advvia. Se estiver em dúvida, comece pelo último (Usuário Final) — ele é o mais curto e introdutório.

Manual	Para quem
Manual do Proprietário	Quem cria casos, monta a equipe, define papéis e gerencia o ciclo de vida do caso.
Manual do Advogado	Quem trabalha o caso no dia a dia: cadastra eventos, controla prazos, organiza processos e arquiva referências.
Manual do Usuário Final	Clientes, partes envolvidas e interessados que recebem acesso para acompanhar o caso (e, se forem Parte/Cliente, também contribuir).

Os manuais se sobrepõem propositalmente nos pontos em comum (login, navegação, conceitos básicos) para que cada um seja autocontido. Quem quiser uma visão completa pode lê-los em sequência.

O modelo de dados em 30 segundos¶

Tudo no Advvia gira em torno de um caso. Cada caso é organizado em quatro conjuntos principais de informação que se conectam:

Eventos — a linha do tempo. Tudo que aconteceu: fatos da realidade (fatuais) e movimentações de processos (processuais).
Processos — não só os judiciais: também administrativos, policiais, sindicâncias, procedimentos disciplinares.
Pendências — tarefas e acontecimentos a serem resolvidos: peças, prazos, providências, perícias.
Arquivos — qualquer referência útil ao caso: documentos, vídeos, áudios, memorandos, provas, sites, links.

Os quatro conjuntos se vinculam livremente — um arquivo pode estar amarrado a um evento, uma pendência pode pertencer a um processo, e assim por diante. Esses vínculos são o que permitem ao Advvia gerar visões integradas como o Status Report (IA) na home do caso.

Papéis dentro de um caso¶

Cada usuário tem um papel por caso. O mesmo usuário pode ser proprietário em um caso e parte em outro.

Papel	Visualiza	Cria conteúdo	Altera / exclui	Convida	Exclui o caso
Proprietário	sim	sim	qualquer item do caso	sim	sim
Advogado	sim	sim	qualquer item do caso	sim	não
Parte / Cliente	sim	sim	apenas os itens que ele mesmo criou	não	não
Interessado	sim	não	não	não	não

Notas:

Existe apenas um Proprietário por caso — é o usuário que criou o caso, e o único com poder de excluir o caso inteiro.
Advogado e Proprietário têm permissões equivalentes sobre o conteúdo do caso (criam, alteram e excluem qualquer item). A única diferença é que apenas o Proprietário pode excluir o caso.
Parte/Cliente é colaborador: registra fatos, anexa documentos, abre pendências. Altera e exclui apenas o que ele mesmo criou — o que outros membros (Advogado, Proprietário, outras partes) cadastraram fica intocado por ele. Não convida.
Interessado é apenas observador: nada de criação, alteração ou exclusão.

Glossário rápido¶

Termo	Significado
Caso	Unidade central. Reúne eventos, processos, pendências, arquivos e a equipe.
Evento	Item da linha do tempo. Tipo `fatual` ou `processual`. Código `EV-XXX`.
Processo	Procedimento formal — judicial, administrativo, policial, etc. Código `PR-XXX`.
Pendência	Tarefa a resolver, com status (ABERTA / EM ANDAMENTO / BLOQUEADA / CONCLUÍDA / CANCELADA). Código `PD-XXX`.
Arquivo	Referência a um documento, mídia ou link externo.
Vínculo	Ligação entre arquivos e eventos/pendências/processos. Define o contexto em que o arquivo é relevante.
Status Report	Síntese gerada por IA do estado atual do caso, na home.
Caso padrão	Caso aberto automaticamente quando você entra no Advvia. Marcado com ★.
Convite	Email com link único enviado a uma pessoa para que ela entre no caso com determinado papel.

Reportar problemas durante o beta¶

Esta é uma versão beta. Se algo não funcionar como o esperado, ou se sentir falta de uma função, use os canais combinados pela sua equipe para reportar — eles repassam ao time do Advvia.