User stories

Introdução

User stories são descrições concisas de funcionalidades contadas da perspectiva do usuário final, captando o "quem", o "o quê" e o "por quê" de cada requisito. Para o desenvolvimento do novo aplicativo da CPTM, elas são essenciais por colocarem os passageiros no centro do projeto, facilitando a priorização das funcionalidades e a comunicação entre equipes técnicas e stakeholders das diferentes diretorias envolvidas.

US01 - Consulta da situação das linhas

Título: Visualização do status operacional das linhas em tempo real

Descrição concisa: Como um passageiro da CPTM, quero visualizar a situação operacional atual de todas as linhas para que eu possa me planejar adequadamente antes de iniciar minha viagem.

Critérios de aceitação:

• O aplicativo deve exibir todas as linhas da CPTM (7-Rubi, 10-Turquesa, 11-Coral, 12-Safira e 13-Jade)
• O aplicativo deve exibir as linhas do Metrô e concessionárias (1-Azul, 2-Verde, 3-Vermelha, 4-Amarela, 5-Lilás, 15-Prata, 8-Diamante, 9-Esmeralda)
• Cada linha deve exibir seu status operacional atual com indicadores visuais claros (verde para normal, amarelo para velocidade reduzida, vermelho para paralisação)
• As informações devem ser atualizadas em tempo real via API
• A consulta deve funcionar mesmo com conexão limitada de internet
• Um botão deve permitir atualização manual dos dados

Notas ou comentários: Esta funcionalidade é crucial pois representa o principal motivo de consulta do aplicativo pela maioria dos usuários. As informações devem ser obtidas diretamente da API operacional da CPTM.

Prioridade: Alta

Estimativa de esforço: Médio (3)

Identificação de relações:

• Dependência com US02 (Detalhamento de linha específica)
• Base para US04 (Planejamento de trajeto)

US02 - Detalhamento de linha específica

Título: Visualização detalhada de estações de uma linha

Descrição concisa: Como um passageiro da CPTM, quero visualizar todas as estações de uma linha específica para que eu possa verificar quais estações estão disponíveis e suas integrações.

Critérios de aceitação:

• Ao clicar em uma linha na tela de situação, o aplicativo deve mostrar todas as estações em ordem sequencial
• Cada estação deve exibir seu nome completo e endereço
• Indicadores de acessibilidade devem ser exibidos para cada estação
• Indicadores de integração com outras linhas devem ser exibidos quando aplicável
• Um botão para retornar à visão geral das linhas deve estar disponível
• Um botão para acessar o mapa da rede deve estar disponível

Notas ou comentários: Esta funcionalidade permite ao usuário explorar uma linha específica quando já tem um destino em mente, mas precisa confirmar o nome das estações ou verificar integrações.

Prioridade: Alta

Estimativa de esforço: Médio (3)

Identificação de relações:

• Estende US01 (Situação das Linhas)
• Dependência com US03 (Detalhamento de estação específica)

US03 - Planejamento de trajeto

Título: Planejamento de viagem com origem e destino

Descrição concisa: Como um passageiro da CPTM, quero planejar meu trajeto informando pontos de origem e destino para que eu possa saber qual rota seguir e quanto tempo levarei.

Critérios de aceitação:

• O aplicativo deve permitir a inserção de pontos de origem e destino via campo de texto
• Deve ser possível selecionar pontos a partir de favoritos salvos
• Deve mostrar opções de rotas organizadas por tempo de viagem
• Cada rota deve exibir tempo estimado, distância, número de baldeações e linhas utilizadas
• Deve ser possível visualizar instruções passo a passo da rota selecionada
• A função deve considerar o status operacional atual das linhas para recomendações

Notas ou comentários: Como não existe API própria para esta função, será necessário implementar um motor de busca de rotas próprio ou integrar com APIs externas como Google Maps.

Prioridade: Alta

Estimativa de esforço: Alto (5)

Identificação de relações:

• Dependência com US01 (Situação das Linhas)
• Relacionado com US10 (Favoritos)

US04 - Informações de acessibilidade

Título: Consulta de recursos de acessibilidade nas estações

Descrição concisa: Como um passageiro com necessidades especiais de mobilidade, quero consultar os recursos de acessibilidade disponíveis em cada estação para que eu possa planejar minha viagem com confiança.

Critérios de aceitação:

• Exibir um mapa visual dos equipamentos de acessibilidade por estação
• Fornecer um mapa acessível de transporte em formato de texto para leitores de tela
• Indicar quais estações possuem elevadores, rampas, piso tátil e outros recursos
• Informar o status operacional dos equipamentos de acessibilidade (funcionando/em manutenção)
• Permitir filtragem de estações por tipos específicos de acessibilidade
• Incluir informações sobre assistência disponível para pessoas com deficiência

Notas ou comentários: É importante garantir que o próprio aplicativo seja acessível, respeitando as diretrizes de acessibilidade para aplicativos móveis, além de fornecer as informações sobre acessibilidade física nas estações.

Prioridade: Alta

Estimativa de esforço: Médio (3)

Identificação de relações:

• Relacionado com US02 (Detalhamento de Linha Específica)
• Relacionado com US03 (Planejamento de Trajeto)

US05 - Consulta de intervalos entre trens

Título: Verificação de intervalos programados entre trens

Descrição concisa: Como um passageiro da CPTM, quero consultar os intervalos programados entre trens para cada linha e período do dia para que eu possa planejar meus horários de viagem com precisão.

Critérios de aceitação:

• Permitir a seleção da linha desejada para consulta
• Exibir tabela com intervalos programados segmentados por dia da semana (úteis, sábados, domingos/feriados)
• Exibir faixas horárias com seus respectivos intervalos (ex: hora do rush vs. período noturno)
• Destacar visualmente o intervalo atual com base no horário de consulta
• Permitir alternar facilmente entre linhas diferentes para comparação
• Incluir observações sobre possíveis alterações programadas nos intervalos

Notas ou comentários: Os dados devem refletir a programação oficial da CPTM e ser atualizados sempre que houver mudanças operacionais.

Prioridade: Alta

Estimativa de esforço: Baixo (2)

Identificação de relações:

• Relacionado com US01 (Situação das Linhas)
• Pode ser integrado com US03 (Planejamento de Trajeto)

US06 - Mapa de conveniência

Título: Localização de serviços e comércios nos arredores das estações

Descrição concisa: Como um passageiro da CPTM, quero visualizar os serviços e comércios disponíveis dentro e nos arredores de cada estação para que eu possa aproveitar melhor meu tempo de deslocamento.

Critérios de aceitação:

• Exibir mapa com serviços disponíveis dentro e próximos às estações (bancos, farmácias, postos médicos, delegacias, autoescolas, mercados)
• Permitir filtrar por tipo de serviço ou comércio
• Mostrar a distância aproximada entre a estação e cada estabelecimento
• Indicar horário de funcionamento dos estabelecimentos quando disponível
• Permitir que comerciantes locais cadastrem seus estabelecimentos mediante aprovação da CPTM
• Atualizar periodicamente as informações para garantir precisão

Notas ou comentários: Esta funcionalidade foi mencionada como extra na página 22 do documento e deve facilitar a vida dos passageiros que querem otimizar seu tempo realizando tarefas no caminho. A administração dos comércios cadastrados deve ser compartilhada, com a CPTM gerindo informações sobre serviços públicos e permitindo autocadastro de comércios privados.

Prioridade: Média

Estimativa de esforço: Alto (4)

Identificação de relações:

• Relacionado com US02 (Detalhamento de Linha Específica)
• Relacionado com US03 (Planejamento de Trajeto)
• Pode requerer sistema de cadastro para comerciantes

US07 - Canais de contato

Título: Acesso rápido a canais de comunicação com a CPTM

Descrição concisa: Como um passageiro da CPTM, quero acessar rapidamente todos os canais oficiais de comunicação com a companhia para que eu possa obter informações, fazer reclamações ou sugestões.

Critérios de aceitação:

• Listar todos os canais de contato oficiais da CPTM: telefone, WhatsApp, e-mail, formulário web
• Incluir links diretos para as redes sociais da companhia (Twitter, Facebook, Instagram, YouTube, TikTok, LinkedIn)
• Permitir a discagem direta para números de telefone ao clicar
• Abrir aplicativos de redes sociais instalados no dispositivo ao selecionar respectivo ícone
• Incluir horários de funcionamento de cada canal de atendimento
• Agrupar contatos por tipo (atendimento geral, ouvidoria, achados e perdidos, etc.)

Notas ou comentários: Os links e números devem ser verificados periodicamente para garantir que continuam válidos.

Prioridade: Alta

Estimativa de esforço: Baixo (1)

Identificação de relações:

• Independente de outras histórias

US08 - Localização de trens em tempo real

Título: Visualização da posição dos trens em tempo real

Descrição concisa: Como um passageiro da CPTM, quero visualizar a localização dos trens em tempo real para que eu possa estimar quando o próximo trem chegará à minha estação.

Critérios de aceitação:

• Permitir a seleção da linha desejada para visualização
• Exibir mapa da linha com a posição atual de cada trem em operação
• Atualizar posições em intervalos regulares (30 segundos ou menos)
• Mostrar direção de deslocamento de cada trem
• Indicar estimativa de tempo para chegada em cada estação
• Funcionar mesmo com conexão de internet limitada (dados baixos)

Notas ou comentários: Embora marcada como não prioritária, esta funcionalidade pode aumentar significativamente a experiência do usuário ao reduzir a incerteza sobre o tempo de espera. Requer acesso à API com dados de GPS dos trens.

Prioridade: Média

Estimativa de esforço: Alto (4)

Identificação de relações:

• Relacionado com US01 (Situação das Linhas)
• Relacionado com US06 (Consulta de Intervalos)

US09 - Report do passageiro

Título: Reporte de ocorrências e problemas pelo passageiro

Descrição concisa: Como um passageiro da CPTM, quero reportar problemas ou situações encontradas nas estações e trens para que a companhia possa tomar providências rapidamente e outros passageiros sejam alertados.

Critérios de aceitação:

• Permitir categorização do tipo de ocorrência (segurança, limpeza, manutenção, etc.)
• Permitir seleção da estação e área específica onde o problema foi encontrado
• Permitir descrição textual do problema
• Opcional: permitir envio de foto da ocorrência
• Exibir confirmação de recebimento do report
• Permitir visualização de reports recentes feitos por outros usuários após aprovação da CPTM
• Exibir status de resolução dos reports enviados pelo usuário

Notas ou comentários: Esta funcionalidade foi mencionada como extra nas "Funcionalidades Extras" do documento. Semelhante ao modelo do Waze, permite que os próprios passageiros contribuam para a melhoria do serviço, mas necessita de moderação pela CPTM.

Prioridade: Média

Estimativa de esforço: Alto (4)

Identificação de relações:

• Relacionado com US08 (Canais de Contato)
• Pode requerer autenticação de usuário