Documento Funcional — Avance Clinic MVP

Versão: 1.0
Data: 2026-06-10
Base: PRD v1.0 + Mockup Interativo (7 telas)
Público: Stakeholders, devs, investidores

1. Visão Geral do Fluxo MVP

A Avance é uma plataforma SaaS B2B2C que concilia automaticamente agenda médica, demonstrativos de produção e recebimentos. O MVP tem 2 perfis de acesso: Gestor (empresa gestora) e Médico (profissional multi-locado). Cada perfil vê uma parte diferente do sistema.

1.1 Arquitetura de Alto Nível

[Diagram]

2. Jornadas de Usuário

2.1 Gestor (Carlos — Empresa Gestora)

Carlos é o usuário administrativo. Ele cadastra médicos, importa planilhas, resolve divergências e emite relatórios.

[Diagram]

2.2 Médico (Dra. Marina — Cardiologista)

Marina é a usuária final. Ela acessa para ver quanto trabalhou, quanto faturou e quanto recebeu. Não interage com importação nem revisão.

[Diagram]

3. Fluxos Detalhados

3.1 Fluxo de Autenticação e Troca de Perfil

[Diagram]

Descrição:

Tela única de login com toggle "Gestor | Médico" no header.
Estado salvo em localStorage.
Gestor acessa: Dashboard, Clínicas, Agenda, Importação, Fila de Revisão, Relatórios.
Médico acessa: Dashboard (próprios dados), Agenda, Relatório.

3.2 Fluxo de Importação de Dados

[Diagram]

Descrição:

Upload de .xlsx, .xls, .csv (máx 50MB).
Preview com sugestão automática de mapeamento de colunas.
Colunas obrigatórias: CRM, Data, Procedimento, Valor Faturado, Valor Recebido, Local.
Registros inválidos são listados para correção.
Após importação, o motor de conciliação é disparado automaticamente.

3.3 Fluxo do Motor de Conciliação

[Diagram]

Regras de Matching (MVP):

Situação	Regra	Status
CRM + Data + Procedimento + Valor perfeito	Tolerância R$ 0,01	MATCHED
Data próxima (±3 dias), resto perfeito	Valor igual	MATCHED_COM_ALERTA
Valor dentro de ±10%, resto perfeito	Requer validação	PENDING_REVIEW
Sem correspondência	Nenhum campo compatível	DIVERGENTE
Múltiplos candidatos	2+ demonstrativos para 1 agenda	CONFLITO

3.4 Fluxo de Contestação de Glosa

[Diagram]

Descrição:

Glosa é calculada automaticamente: Valor Faturado - Valor Recebido.
Motivos padronizados: Procedimento não autorizado, Dados incompletos, Carteirinha irregular, Erro de faturamento, Outros.
Alerta automático após 20 dias sem ação.
Taxa de sucesso de contestação é rastreada por médico e por motivo.

4. Mapeamento das 7 Telas do Mockup

4.1 Navegação por Perfil

[Diagram]

4.2 Descrição das Telas

#	Tela	Perfil	Função	Estado do Dado
1	Login	Gestor + Médico	Entrada com alternância de perfil	—
2	Dashboard	Gestor + Médico	Cards de resumo (produção, faturamento, recebido, glosas, saldo) + gráfico de 12 meses + ranking de locais	Vivo
3	CRUD Clínicas	Gestor	Lista, cadastro, edição e exclusão de locais de trabalho	Estático
4	Agenda	Gestor + Médico	Visualização de atendimentos (calendário/lista)	Mock
5	Importação	Gestor	Upload de Excel/CSV, preview, mapeamento de colunas, validação	Estático
6	Fila de Revisão	Gestor	Tabela de registros não conciliados com ações (match, divergente, editar)	Mock
7	Relatório Médico	Gestor + Médico	View-only do demonstrativo mensal (estilo PDF real)	Mock

5. Fluxo de Dados (Visão Conceitual)

[Diagram]

Entidades principais:

Tenant: Empresa gestora (subdomínio isolado).
Profissional: Médico vinculado ao tenant (CRM único).
Local: Hospital, clínica ou operadora.
Agenda: Atendimentos realizados (CRM, Data, Procedimento, Local).
Demonstrativo: Faturamento (CRM, Data, Procedimento, Valor Faturado, Local).
Pagamento: Recebimento efetivo (CRM, Data, Procedimento, Valor Recebido, Local).
Reconciliação: Resultado do match entre Agenda, Demonstrativo e Pagamento.
Glosa: Diferença entre faturado e recebido (com status de contestação).

6. Ciclo de Vida de um Registro

[Diagram]

7. Resumo do MVP em 12 Semanas

[Diagram]

8. Glossário Rápido

Termo	Significado
Tenant	Empresa gestora isolada com seu próprio banco de dados
Demonstrativo	Documento (Excel/PDF) que lista os atendimentos faturados por um local
Glosa	Diferença entre o valor faturado e o valor efetivamente recebido
Match	Cruzamento automático entre agenda, demonstrativo e pagamento
Conciliação	Processo de cruzar dados de múltiplas fontes para validar recebimento
Staging	Área temporária onde dados importados ficam antes de serem processados
Contestação	Ação formal para questionar uma glosa junto ao hospital/operadora

Documento gerado a partir do PRD v1.0 e do Plano de Mockup Interativo.