Processos (fluxo)

As etapas do caso, seus gatilhos, atores e onde entram IA/automação. Detalhe completo nos documentos de fluxo.

Documentos de fluxo: Intake · Coordinator · Attorney Setup · Kickoff · After Kickoff.

Agentes de IA

Stack: Agno v2 (AgentOS) sobre OpenRouter; o backend orquestra os disparos. Gemini é usado na captura do kickoff (ecossistema Google).

Sub-agents internos

Rodam por dentro de um agent (não são agents de produção separados). O Sandbox mostra o trace (resultado/diálogo) quando o agent é acionado.

Agente de Intake - contrato

Endpoint no Agno: POST /triage { case_id }, disparado pelo backend quando o caso entra na triagem. Pipeline de 8 passos:

# pipeline
1. coletar lead (cases+clients+leads) + checar recorrência (clients/cases por email/phone)
2. achar reuniões no yousa-sales (match email/phone, fallback "review")
3. resumir transcrições .......... sub-agent interno (trace no Sandbox)
4. classificar tipo de caso + confiança
5. requisitos da AILA via MCP .... sub-agent interno (trace no Sandbox)
6. comparar requisitos × (resumo + lead) → tem / falta
7. produzir relatório
8. gravar em case_intake_reports + indexar no RAG do caso

# saída estruturada (Pydantic)
IntakeReport:
  case_type_suggested: str        # entre os CaseType
  confidence: float               # 0..1
  overview: str                   # resumo do cliente para o advogado
  green_flags:      [ {item, reason} ]
  red_flags:        [ {item, severity, reason, escalate} ]   # escalate = crítica
  requirement_gaps: [ {field, issue, hint_to_sales} ]
  pre_strategy: str               # sugestão advisory; alimenta a aba Estratégia
  readiness_score: int            # 0..100 (pronto p/ kickoff)
  prior_case_refs:  [ {client_id|case_id, note} ]
  aila_citations:   [ {title, aila_url, snippet} ]
  transcript_summary: str         # resumo; nunca a transcrição crua
  source_meetings: [ ids ]   match_status: ok|review|none

Config por case_type (aila_query + checklist objetivo seed + red flags) em intake_rules.yaml no repo do Agno. Red flags sensíveis (criminal, overstay, negativa anterior, fraude) são marcadas como críticas com ênfase máxima no card (sem notificação automática; decisão de escalar é do advogado).

Telas

Protótipo navegável (look shadcn + design system). Componentes do frontend: shadcn, ag-grid (tabelas), FullCalendar (calendário), dnd-kit (boards), CounterCard/StatusBadge/Header/Sidebar.

Abrir protótipo: Dashboard · Painel Attorney · Casos · Detalhe · Calendário · Coordinator Setup · Sandbox.

Banco de dados

Supabase (Postgres). Reusa o schema existente e adiciona o mínimo necessário. RLS habilitada em todas as tabelas.

Tabelas existentes reusadas

Novos objetos & extensões

case_intake_reports novo spec T-1

create table case_intake_reports (
  id                   bigint primary key generated always as identity,
  case_id              int references cases(id) on delete cascade,
  case_type_suggested  text,
  confidence           numeric,            -- 0..1
  overview             text,
  requirement_gaps     jsonb default '[]', -- {field, issue, hint_to_sales}
  green_flags          jsonb default '[]', -- {item, reason}
  red_flags            jsonb default '[]', -- {item, severity, reason, escalate}
  pre_strategy         text,
  readiness_score      int,                -- 0..100
  prior_case_refs      jsonb default '[]', -- recorrência: {client_id|case_id, note}
  transcript_summary   text,               -- resumo; nunca a transcrição crua
  source_meetings      jsonb default '[]', -- ids das reuniões (yousa-sales)
  match_status         text default 'ok'
                       check (match_status in ('ok','review','none')),
  aila_citations       jsonb default '[]', -- {title, aila_url, snippet}
  model                text,
  status               text default 'draft'
                       check (status in ('draft','reviewed','error')),
  error_message        text,
  created_at           timestamptz default now()
);
create index on case_intake_reports (case_id, created_at desc);

documents - extensão extensão

alter table documents
  add column internal_deadline date,            -- prazo interno (After Kickoff)
  add column responsible_id    uuid references users(id);  -- quem produz

petition_filings - extensão extensão

alter table petition_filings
  add column deadline_production date,  -- definidas pelo Coordinator
  add column deadline_revision   date,
  add column deadline_final      date;

agent_client_messages novo proposto

Thread do agente de comunicação/kickoff (Etapa 3). Permite gate de aprovação, continuidade e auditoria.

create table agent_client_messages (
  id          bigint primary key generated always as identity,
  case_id     int references cases(id) on delete cascade,
  channel     text,   -- whatsapp | email | app
  direction   text,   -- outbound | inbound
  body        text,
  status      text,   -- draft | awaiting_approval | sent | received
  approved_by uuid references users(id),
  created_at  timestamptz default now()
);

case_knowledge_chunks novo spec T-8

RAG do caso (pgvector no YousaLawDB). O intake indexa overview + resumo + dados + requisitos AILA; base de contexto para a futura IA dos advogados. Sem transcrição crua.

create extension if not exists vector;
create table case_knowledge_chunks (
  id          bigint primary key generated always as identity,
  case_id     int references cases(id) on delete cascade,
  source_type text,   -- overview | transcript_summary | case_data | aila_requirement
  content     text,
  embedding   vector(N),
  metadata    jsonb default '{}',
  created_at  timestamptz default now()
);

case_agent_messages novo spec T-9

Chat do advogado com o agent sobre o caso (texto e áudio). O áudio é transcrito; o arquivo cru não é guardado.

create table case_agent_messages (
  id         bigint primary key generated always as identity,
  case_id    int references cases(id) on delete cascade,
  role       text check (role in ('user','agent')),
  content    text,
  source     text check (source in ('text','audio')),
  created_at timestamptz default now()
);

Sandbox de Agents (Settings) novo spec ativ. 5

Registro e governança dos agents: agent_registry (identidade + parent_slug + modelo + runtime_snapshot), agent_prompt_versions (histórico imutável, 1 ativa), agent_test_runs (playground, retenção 30d). Detalhe em specs/Yousa Agno/Studio e Sandbox/Tarefas/5-agent-sandbox/.

View do Painel de Prazos & Responsáveis proposto

União de documentos (prazo interno + responsável) e filings (deadlines por etapa) - alimenta a tela de prazos com filtros (responsável, tipo de caso, tipo de documento, demanda).

Integrações

O que cada etapa precisa conectar e o estado atual no sistema.

Documento de especificações · NEW FLOW LEGAL · sujeito à revisão do advogado responsável. Implementação não iniciada (exceto onde marcado "existente").

Automações

Orquestradas pelo backend (padrão do NPS: evento → ação). Princípios: transacional onde toca várias tabelas, idempotente (reexecutar não duplica), gate humano onde fala com cliente, fila no padrão sync_inbox (claim + lease + retry + DLQ) para trabalho assíncrono.

Garantias transversais

Specs completas: automações do setup em specs/Yousa Legal/Intake Setup/1 - Intake/Tarefas/6-setup-automations/, agendamento em specs/Yousa Legal/Intake Setup/2 - Pre-Kickoff/Tarefas/7-attorney-setup-kickoff/, captura de transcrição em specs/Yousa Legal/Intake Setup/4 - Kick Off/Tarefas/8-captura-transcricoes-caso/.

Agents & Sandbox

Em Settings/Agents: um ambiente para ver e governar todos os agents e sub-agents do sistema. Um agent criado no código aparece aqui automaticamente.

Como um agent entra no sistema

Cada agent declara um manifesto (slug, owner, descrição, modelo, tools, MCPs, parent_slug para sub-agents, talks_to_client). No boot do AgentOS, o registro é sincronizado e o agent passa a aparecer no Sandbox. Convenção em specs/Yousa Agno/Studio e Sandbox/Tarefas/5-agent-sandbox/REGISTERING-AN-AGENT.md.

O que o Sandbox oferece

Tabelas (Sandbox)

Spec completa em specs/Yousa Agno/Studio e Sandbox/Tarefas/5-agent-sandbox/ (plan + tarefas + QA + REGISTERING-AN-AGENT.md). Método Claude for Legal + Chat em specs/Yousa Agno/Agentes/Tarefas/11-legal-method-and-agent-chat/.