Pular para o conteúdo principal

WI 920 - Atualização automática noturna

Contexto da task​

  • Título: [Doc] Enriquecer a documentação completa do módulo de Motoristas
  • Work Item: 920
  • Run ID: DOC-FROTA-DAILY-20260813-231417-31753067185
  • Branch técnica: docs/ai-task-920
  • Atualizado em (UTC): 2026-08-13 23:14:29

Entendimento da solicitação​

Enriquecimento da documentação - Módulo de Motoristas ------------------------------------------------------------- ### Objetivo Elevar a documentação de Motoristas para nível operacional, com regras explícitas, validações de campos, vínculo com contratos e evidências visuais, quando possível. ### Escopo da rodada * Tornar claras as obrigatoriedades do cadastro de motorista. * Explicitar regras de validação e mensagens de erro comuns. * Conectar requisitos de motorista ao fluxo de contratos. * Adicionar evidências visuais (screenshots) por etapa crítica. ### Itens a adicionar hoje #### 1. Matriz de campos obrigatórios do motorista * Criar seção Campos obrigatórios no passo a passo de cadastro. * Listar obrigatórios para completude operacional: Nome, CPF, categoria CNH, telefone, endereço, data de nascimento, estado civil, profissão. * Separar campos obrigatórios de campos recomendados. Critério de aceite: * Operação consegue identificar, sem ambiguidade, quais campos impedem progressão para contrato. #### 2. Regras de validação de campos (com padrão aceito) * CPF com 11 dígitos. * Telefone com 10 ou 11 dígitos. * E-mail com formato válido. * CNH com categoria válida. * CNH não vencida. * Renda estimada não negativa. * Unicidade de CPF/CNH por tenant. Critério de aceite: * Cada regra possui exemplo de entrada válida e inválida. #### 3. Tabela de erros comuns e ação recomendada * Criar tabela Mensagem, causa provável, ação da operação. * Incluir erros de duplicidade CPF/CNH, CNH vencida, telefone inválido, e-mail inválido e motorista não encontrado. Critério de aceite: * Tabela cobre pelo menos 8 cenários reais e orienta correção sem apoio técnico. #### 4. Regras de aprovação e reprovação * Documentar transições de status permitidas. * Documentar bloqueio de reprovação quando motorista possui contrato ativo. * Explicar quando usar justificativa de reprovação. Critério de aceite: * Equipe entende claramente quando pode aprovar, reprovar e quando o sistema bloqueia. #### 5. Elegibilidade motorista x tipo de veículo no pré-contrato * Documentar regra de CNH para carro (categorias com B/C/D/E). * Documentar regra de CNH para moto (categoria A ou combinação com A). * Explicar impacto da elegibilidade na criação do contrato. Critério de aceite: * Usuário de operação entende por que um motorista pode ser bloqueado no contrato. #### 6. Checklist pronto para contrato * Criar checklist final antes de encaminhar motorista para Contratos. * Incluir status de aprovação, dados completos e documentação mínima. Critério de aceite: * Checklist pode ser usado como gate operacional de transição Motoristas -> Contratos. #### 7. Fluxo de motorista vindo do marketplace * Explicar diferença entre cadastro interno e aprovação oriunda do marketplace. * Documentar passos de revisão e decisão operacional. Critério de aceite: * Fluxo marketplace está explícito e sem conflito com fluxo padrão. #### 8. Plano de screenshots obrigatórios * Capturar tela de lista de motoristas. * Capturar modal de cadastro. * Capturar tela de anexos/documentos. * Capturar ação de aprovação. * Capturar ação de reprovação com motivo. * Capturar erro de validação (exemplo real). * Capturar validação de elegibilidade no contrato (quando aplicável). Critério de aceite: * Cada seção crítica da documentação possui pelo menos 1 screenshot contextual. #### 9. Auditoria funcional e rastreabilidade operacional * Adicionar seção curta de rastreabilidade: quais eventos operacionais devem ser observados. * Orientar suporte sobre o que validar primeiro em divergências. Critério de aceite: * Documentação orienta triagem inicial de suporte sem depender de desenvolvimento. ### Priorização desta noite * P0: itens 1, 2, 5 e 6. * P1: itens 3 e 4. * P2: itens 7, 8 e 9. ### Evidência de conclusão da rodada * Links das páginas atualizadas. * Lista de screenshots anexadas. * Resumo dos principais ganhos para operação. * Pendências remanescentes (se houver).

Registro operacional​

Este conteúdo foi preparado automaticamente pelo fluxo noturno para revisão humana antes de merge em $(main).