JORNADAS DOS ATORES, MDS

O documento textual que descreve como cada ator opera o sistema, função por função: como entra, onde entra e o que faz. É escrito por função (papel), nunca por pessoa: genérico e abstrato, para que qualquer um que assuma o papel se reconheça. Onde o DRS especifica o sistema e os funis, este artefato olha pela cadeira de quem opera.

Por que existe

O DRS tem um bloco de Atores e Jornadas, mas ele é orientado ao fluxo (o caminho do lead, do pedido, do dado) e à capability (quem pode o quê). Falta a visão de cada papel no seu dia: o que a pré-venda faz quando chega de manhã, onde o operador de campo registra a venda, como o financeiro entra no processo. As Jornadas dos Atores preenchem isso: para cada ator, listam as funções que ele executa e, para cada função, a jornada concreta.

Serve a três usos: treinamento e onboarding (a pessoa lê a própria seção e sabe operar), validação pela ótica do operador (revisar se cada papel consegue, de fato, fazer seu trabalho com o que foi especificado) e alinhamento (todos enxergam onde sua função encaixa no todo).

O que cada jornada declara

Para cada função que um ator executa, a jornada responde, em prosa curta:

Como entra: o gatilho, o momento em que aquela função começa (um lead novo chega, um agendamento é criado, uma obra é concluída).
Onde entra: o lugar onde a função acontece (qual tela, funil, sistema ou canal).
O que faz: as ações concretas do ator naquela função, e o resultado que elas produzem.

Princípios

Por função, não por pessoa. Use os papéis (ex.: Atendimento, Operador de Campo, Financeiro, Gestão), nunca nomes próprios. O documento descreve o trabalho, não quem o ocupa; trocar a pessoa não muda nada.
Genérico e abstrato. A linguagem é reutilizável: descreve a função de forma que sirva a qualquer instância daquele papel.
Uma seção por ator, várias funções por ator. Cada ator tem sua seção; dentro dela, cada função que ele executa é uma entrada com Como entra / Onde entra / O que faz.
Cobertura completa dos atores. Todo ator do catálogo do DRS aparece aqui com pelo menos uma função; toda função relevante de um papel é descrita.
Cruzado com o DRS. As jornadas referenciam os funis, telas e requisitos do DRS, sem repetir a especificação.

Formato canônico

Texto, sem checkbox (é um documento de leitura, não um checklist). Uma seção por ator; cada função como um item:

## Atendimento (pré-venda)

### Triagem de leads novos
- Como entra: um lead novo cai no funil por integração de fonte.
- Onde entra: a caixa de conversas e o funil comercial.
- O que faz: abre o lead, faz o primeiro contato e qualifica, aplicando as tags de origem e tipo.

### Agendamento da visita
- Como entra: o lead foi qualificado.
- Onde entra: o calendário do operador de campo, pela ficha.
- O que faz: escolhe responsável e horário pela disponibilidade real e marca a visita.

Infraestrutura (Modulareasy)

As Jornadas dos Atores são um documento doc_kind = 'journeys' com parent_slug igual ao slug do DRS. Renderizam como documento textual (sem checklist nem barra de progresso), e fazem parte da família de 5: DRS, Roadmap, Inventário, Jornadas e Plano de Testes, que se cruzam (cada um aponta para os outros quatro). Em entregas white-label, herdam a identidade visual do DRS.

A família MDS responde a cinco perguntas: o DRS diz o que o sistema faz; o Roadmap diz em que ordem construir e como verificar; o Inventário diz o que precisa existir; as Jornadas dos Atores dizem como cada papel opera o sistema no dia a dia; e o Plano de Testes diz o que validar antes de entregar (Alfa interno e Beta com o cliente).