FAQ de Ordens de Servico

Como o Levy Service difere de um CMMS generico?

Ferramentas CMMS genericas (Maintainx, Limble) tem um parts catalog maduro e bom gerenciamento geral de tarefas, mas nao sabem nada sobre seus veiculos. Triggers sao manuais ou de calendario. O Levy Service e construido sobre a telemetria ao vivo da sua frota, entao o rule engine dispara em mileage, battery, codigos IoT, condition reports e eventos de geofence. Essa diferenca aparece na taxa de 50%+ de auto-create que frotas Levy saudaveis batem.

Como isso se compara ao Atom Task Manager?

Paridade de features e a meta explicita da Fase 2. A vantagem competitiva e o rule engine baseado em telemetria IoT - a Atom nao tem stack IoT proprio, entao nao pode entregar regras dirigidas por telemetria. O mesmo vale para Joyride Lanterne. Voce ganha as mesmas superficies de dashboard na Levy mais uma classe de regras que nenhum concorrente consegue cobrir.

Da para usar sem regras?

Da. A Fase 1 (criar + atribuir + resolver manualmente) funciona sozinha. Muitas frotas operam assim no primeiro mes enquanto aprendem o sistema e depois ligam regras uma de cada vez. O tier Starter exclui regras de proposito para incentivar esse padrao.

Tasks contam para minha fatura Levy?

Nao. Tasks sao ilimitadas em todos os tiers. O tier controla features (rule engine, parts catalog, vendor portal, analytics avancado), mas nao mede por contagem de task.

Um tecnico pode estar em mais de uma task ao mesmo tempo?

Sim, tecnicamente. O sistema nao bloqueia um tecnico de ser assignee atual de varias tasks em in_progress. Na pratica, o operator-app o guia por uma de cada vez e a captura de minutos de mao de obra acompanha os minutos efetivamente gastos por task.

E se o celular do tecnico morrer no meio da task?

A task continua em in_progress no servidor. Se nenhum heartbeat for recebido por 30 minutos, o sistema vira a task para blocked com block_reason='tech_offline' e notifica o ops manager. Quando o tecnico voltar online, ele pode continuar pela fila offline.

Riders veem a ordem de servico vinculada a corrida deles?

Riders veem uma confirmacao ao enviar o issue e um email quando a task resultante e verified (se notificacao por email estiver ativada). Nao veem o detalhe interno da task, assignees, parts ou labor.

Como reembolsos interagem com ordens de servico?

Nao interagem diretamente. Um rider issue cria uma task; reembolsos sao um fluxo de decisao separado por /api/rides/[id]/adjust-fare ou /api/rides/[id]/refunds. O ops manager decide o reembolso apos olhar o issue e a corrida. Reembolsos sempre vao contra a corrida, nunca direto contra o wallet - veja a documentacao de rides para detalhes.

Que papeis podem verificar tasks?

Apenas ops_manager e lead_tech. Isso e intencional - juniores nao podem assinar o proprio trabalho. A lista de papeis e: ops_manager, lead_tech, tech, junior_tech, chargehand, deployer, vendor, read_only.

Como migro de Slack/Planilhas?

Fale com seu CSM sobre a ferramenta de import CSV. Ela aceita um export de planilha com colunas de vehicle number, title, priority e assignee e cria tasks em lote no estado inicial correto. Para times baseados em Slack, aponte um workflow do Slack para a mencao do bot e encaminhe threads de manutencao - uma task e criada com o veiculo certo anexado.

Dois tecnicos podem trabalhar na mesma task?

So um tecnico e assignee atual por vez. Colaboradores adicionais podem postar comentarios e subir fotos "during", mas so o assignee pode tocar Start/Resolve/Block. Se precisar trocar no meio, o manager reatribui pelo side drawer e a timeline se preserva.

O que acontece se eu deletar um veiculo?

Linhas de vehicles sao soft-deleted (a linha continua, deleted_at e setado). Tasks contra o veiculo sao preservadas indefinidamente para o registro financeiro mas ficam read-only. Voce nao pode criar tasks novas contra um veiculo soft-deleted.

Custo de pecas e em centavos ou dolares?

Centavos, em toda parte. parts_catalog.unit_cost_cents, task_parts.unit_cost_cents, task_labor.total_cost_cents, tasks.total_cost_cents - tudo em centavos. A UI converte no momento da renderizacao.

Por quanto tempo as fotos sao mantidas?

Dois anos em hot storage. Apos dois anos, task_photos.archived_at e setado e o arquivo fisico vai para um bucket de cold storage. As fotos continuam acessiveis (signed URL com TTL um pouco maior) mas nao saem no query default do task detail.

Posso exportar ordens de servico para CSV?

Pode. A barra de filtros do Kanban tem um botao Download CSV que exporta a visao filtrada atual com todos os campos da task, incluindo totais de parts e labor. O equivalente da API e GET /api/tasks?format=csv.

O operator-app funciona no Mexico/Brasil/Europa?

Funciona. O app esta traduzido para en/es/fr/de/pt. Push notifications passam pela infra global da Expo. Mapas deep-linkam para Apple Maps (iOS) ou Google Maps (Android), que funcionam em todo lugar. A unica coisa que precisa de config por mercado e a lista de parceiros vendors - veja seu CSM.