Presença do calendário semanal
Verifica se calendar.txt está presente quando não existe outro ficheiro que defina as datas de serviço.
Propriedades da regra
| Propriedade | Valor |
|---|---|
| Rule ID | calendar_file_missing |
| Ficheiros | calendar.txt, calendar_dates.txt |
| Campo | Se aplica em todo o ficheiro |
| Tipo | Ficheiro |
| Severidade | Condicional (obrigatório quando calendar_dates.txt está ausente) |
Como funciona
Quando a regra passa, calendar.txt está presente, calendar_dates.txt está presente sem uma exigência específica, ou a configuração ignora a ausência. Sem configuração, a ausência dos dois ficheiros é um problema. A regra não verifica o conteúdo nem a cobertura temporal dos ficheiros.
A regra avalia a presença dos ficheiros de calendário no conjunto GTFS, seguindo os passos abaixo por ordem, até um deles dar o resultado.
| # | Pergunta | Se sim | Se não |
|---|---|---|---|
| 1 | O ficheiro calendar.txt está presente? | ✅ Passa | Segue para o passo 2 |
| 2 | A configuração da regra recomenda calendar.txt? | ❌ Reporta o problema: ficheiro recomendado em falta | Segue para o passo 3 |
| 3 | A configuração da regra exige calendar.txt? | ❌ Reporta o problema: ficheiro obrigatório em falta | Segue para o passo 4 |
| 4 | O ficheiro calendar_dates.txt está presente? | ✅ Passa | Segue para o passo 5 |
| 5 | A validação está a decorrer sem uma configuração de regras? | ❌ Reporta o problema: falta um ficheiro de calendário | Termina sem reportar outro problema nesta regra |
Como se relacionam
O conjunto GTFS pode definir o serviço regular em calendar.txt ou listar todas as datas em calendar_dates.txt. Pelo menos um destes ficheiros tem de estar presente quando não existe uma configuração diferente.
Exemplos
calendar.txt | calendar_dates.txt | Resultado | Porquê |
|---|---|---|---|
presente | ausente | ✅ Passa | Existe calendário semanal |
ausente | presente | ✅ Passa | As datas podem ser definidas como exceções |
ausente | ausente, sem configuração de regras | ❌ Problema | Falta um ficheiro de calendário |
ausente | presente, mas calendar.txt é obrigatório | ❌ Problema | A configuração exige o ficheiro |
Como corrigir
| Problema | Causa provável | O que fazer |
|---|---|---|
| Ficheiro obrigatório em falta | A configuração da regra exige calendar.txt | Adicionar calendar.txt ao conjunto GTFS ou rever a configuração da regra |
| Ficheiro recomendado em falta | A configuração da regra recomenda calendar.txt | Adicionar calendar.txt ao conjunto GTFS ou rever a configuração da regra |
| Falta um ficheiro de calendário | Nem calendar.txt nem calendar_dates.txt está presente | Adicionar calendar.txt ou calendar_dates.txt ao conjunto GTFS |