📖 Guia de utilização
Para quando te esqueceres de alguma coisa. Escreve uma palavra para procurar (por exemplo “atrasado” ou “Double”).
🚀 Um dia de trabalho, passo a passo
- Hoje → confirma a data no topo. Se for um dia novo, o programa cria-o sozinho.
- Equipa → marca quem está Presente, Atrasado (e em que área entra), Ausente ou de Férias. Tudo o que não mexeres fica Presente. Quem sabe que vai sair mais cedo: marca “Vai sair mais cedo”.
- Hoje → toca em ＋ Área 1 (barra fixa de baixo) e indica o stock: quantos autocarros de 13 m, 15 m, 18 m e Double Étage. Usa os botões − e ＋, escreve o número ou toca num ⚡ stock habitual.
- O programa distribui sozinho. Toca em 🔎 Verificar para veres a tabela com o resultado e a diferença para a média.
- Se estiver bem, toca em ✓ Confirmar. A área fica bloqueada para ninguém a mudar sem querer.
- Para a área seguinte, toca em ＋ Área 2 e repete. O programa tem em conta tudo o que já foi feito nas áreas anteriores do dia.
- Na última área toca em “Marcar última área”. O programa tenta então equilibrar os pontos finais do dia.
- No fim, desce até ao Relatório do dia para o chefe e partilha em imagem, texto ou PDF.
👥 Presentes, atrasados, ausentes, férias e saídas cedo
- Presente: participa em todas as áreas.
- Atrasado: escolhes a área em que entra. Limpa um pouco menos nesse dia (a redução de pontos escolhe-se no início do dia: 3, 5 ou outro valor) e não compensa mais tarde.
- Ausente e Férias: 0 pontos nesse dia e nenhuma dívida. As férias continuam nos dias seguintes até mudares o estado.
- Vai sair mais cedo: marcas no início do dia (não precisas de saber em que área). A pessoa fica uns pontos à frente dos colegas (o “avanço”, 3 por defeito, em Definições). No fim do dia, em 🏁 Fim do dia, escolhes se essa saída é Compensada ou não. Só há compensação se acabou com menos do que os presentes; se acabou com mais, não devolve.
- Para tirar alguém só de uma área (pausa), abre “⚙️ Opções” na pessoa e escolhe a participação nessa área.
📦 Stock, stock habitual e Double Étage
- O stock é o que há nessa área. Cada área tem o seu.
- Stock habitual: preenche os valores, toca em “💾 Guardar este” e dá um nome. Depois basta tocar no botão ⚡ para o aplicar. Gere-os em Mais → Definições (até 6). “⎘ Área anterior” copia o stock da área anterior.
- Double Étage como 2 de 13 m: indica quantos Double são contados como 2 × 13 m. Cada um é entregue inteiro a uma só pessoa (que fica com pelo menos 2 × 13 m) e aparece com ★ no relatório. Não aumenta o número físico de autocarros.
- Os pontos por tipo (1, 1, 1 e 2 por defeito) mudam-se em Definições.
✋ Corrigir a distribuição à mão
- Modo Manual (distribuis tu tudo): no cartão da área, toca em ✋ Manual. Começa com a sugestão automática e depois dás a cada pessoa os autocarros que quiseres, com − e ＋. Um painel mostra por tipo se faltam ou sobram autocarros; só confirmas quando estiver tudo certo. “↻ Preencher com a sugestão automática” repõe o ponto de partida. Voltar a ⚙️ Automático apaga o que escreveste nessa área. É por área: podes ter umas áreas em automático e outras manuais, e as automáticas seguintes têm em conta o que deste à mão. A compensação conta o que cada um realmente fez.
- Atribuição manual (adiantamento) no modo Automático: em cada pessoa, abre “⚙️ Opções · atribuição manual” e dá-lhe autocarros extra com − e ＋. Esses autocarros saem dos colegas, sem aumentar o total da área, e o programa tenta compensar nas áreas seguintes.
- Transferir a tocar: no cartão “↔ Transferir autocarros”, toca no tipo (por exemplo 13m ×4) de quem o tem e depois em “Passar 1 × … para [colega]”. Cada transferência tem um ✕ para a anular. Só se transferem os automáticos, não os manuais.
- Para mudar uma área já confirmada, toca em 🔓 para a desbloquear.
↶ Desfazer e refazer
- ↶ na barra fixa de baixo (e “Desfazer” no cartão do dia) volta atrás até 25 alterações; ↷ Refazer repõe.
- O histórico de desfazer só existe enquanto a página está aberta: se recarregares, perde-se (os dados ficam guardados na mesma).
- Se o ↶ estiver cinzento, não há nada para desfazer.
⚖️ Compensações: quem recebe mais ou menos no dia seguinte
- No fim do dia vês quem ficou acima ou abaixo da média: na tabela de verificação, e no gráfico 📊 Equilíbrio do dia.
- No dia seguinte, o cartão Compensações explica, por pessoa e por tipo de autocarro, porque alguém recebe mais ou menos.
- Só entra na compensação quem trabalhou o dia todo e à hora, mais quem saiu cedo e escolheste compensar. Atrasos, faltas e férias não criam dívida nem crédito.
- A compensação é contínua e nunca faz alguém passar à frente dos outros. O saldo acumula-se dentro do mês e passa para o mês seguinte quando o fechas.
- O gráfico Saldo (separador Semana) mostra o saldo de cada um, já com o dia de hoje (provisório).
📊 Gráficos e resumos
- Hoje: cartão “Equilíbrio do dia”, com barras por pessoa e uma linha preta na média.
- Semana: o mesmo gráfico por Dia, Semana, Mês ou Ano, em Pontos, Autocarros, Por tipo ou Saldo. Abaixo ficam os resumos semanais e mensais.
- O mês aberto pode ser mudado em “Escolher mês”. Os meses fechados estão em Mais → Histórico.
📤 Relatório para o chefe
- Aparece no separador Hoje quando há áreas. Mostra, por pessoa, quantos autocarros de cada tipo; os Double ×2 aparecem com ★ dentro dos 13 m.
- Tens botões para partilhar como imagem, partilhar como texto, copiar e imprimir / PDF.
- Os Double Étage podem ter as matrículas indicadas; o relatório mostra-as.
🎨 Personalizar
- Mais → Definições → Aparência: tema claro, escuro ou automático, tamanho da letra e cor da aplicação. Fica só no teu telemóvel.
- Trabalhadores — personalizar: cor de cada um, nome curto (aparece nos gráficos e transferências) e ordem da lista (A–Z ou manual com ↑ ↓).
- Nomes, cores e ordem são partilhados por todos os utilizadores.
📅 Fim do mês, cópias e dados
- Mais → Guardar: exporta uma cópia JSON (faz isto de vez em quando), importa uma cópia e fecha o mês.
- Guardar e fechar o mês descarrega o ficheiro completo, guarda o resumo no histórico, põe os relatórios a zero e mantém os saldos de compensação. Guarda o ficheiro descarregado: o detalhe de cada dia do mês fechado fica lá.
- Se a aplicação ficar lenta, vê “Espaço ocupado” e compacta os meses fechados.
- “Apagar absolutamente tudo” elimina os dados partilhados de todos; pede confirmação duas vezes.
👆 Gestos e atalhos
- Deslizar para os lados muda entre Hoje, Equipa e Semana.
- ⬆ no canto volta ao topo quando já desceste bastante.
- Nos números, tocar no campo seleciona tudo para escreveres por cima.
- “✓ Todos presentes” na Equipa repõe a presença de todos, exceto quem está de férias.
🛠️ Problemas comuns
- “Esta área está confirmada”: toca em 🔓 para a desbloquear, altera e volta a confirmar.
- “Stock e distribuição não coincidem”: confere o stock e as atribuições manuais (um manual maior que o stock impede a conta).
- No modo Manual não consigo confirmar: o painel mostra o que falta ou sobra por tipo; acerta os números e confirma.
- Alguém não recebe autocarros: vê se está Ausente, de Férias, Atrasado (só entra na sua área) ou em pausa nessa área.
- Dois 13 m a contar como um Double Étage: no cartão da área, usa o campo “13 m a contar como Double Étage”. Cada par sai dos 13 m e passa para os Double (2 pontos), e aparece com ◆ no relatório. É o contrário do campo “Double Étage a contar como 2 de 13 m”; não uses os dois na mesma área.
- O Double Étage convertido não dá a ninguém: só pode ir para quem tem pelo menos 2 de 13 m nessa área.
- Mudei o dia e perdi o que fiz: está no dia anterior. Escolhe a data no topo de Hoje.
- Os dados não gravam / aparece erro de rede: confirma a ligação e se a sessão continua iniciada (Mais → Terminar sessão e voltar a entrar).
- Fiz asneira: usa ↶ Desfazer. Para recomeçar um dia, apaga as áreas com “Eliminar área”.
Nada encontrado. Tenta outra palavra.
As regras completas do cálculo estão em Mais → Regras.
📋 Regras do Gestor de Autocarros
Consulta estas regras sempre que precisares. Descrevem o funcionamento pretendido; o equilíbrio automático é aproximado e deve ser conferido.
1. Trabalhadores e áreas
Podes registar os trabalhadores de que precisares, sem limite fixo definido na aplicação, e até 30 áreas por dia. O desempenho depende da capacidade do dispositivo. A presença é definida diariamente: Presente, Atrasado, Ausente ou Férias. As férias continuam nos dias seguintes até alterares o estado do trabalhador. Só os trabalhadores disponíveis numa área recebem autocarros. Quem falta ou está de férias não recebe pontos e não acumula dívida.
Eliminação total dos dados
No separador Guardar todos os utilizadores autorizados podem apagar os dados partilhados: trabalhadores, identificadores, presenças, áreas, distribuições, compensações, históricos, relatórios e configurações. O programa pergunta duas vezes se tens a certeza. Se cancelares qualquer uma, nada é apagado. Após a segunda confirmação, os dados partilhados são eliminados e a aplicação recomeça com os dados iniciais. As cópias JSON já descarregadas não são eliminadas.
Identificação individual dos trabalhadores
Quando acrescentas um trabalhador, escreves apenas o nome. O programa atribui-lhe automaticamente um identificador próprio (um número interno único), para não confundir pessoas com nomes iguais. Não precisas de escrever, decorar ou gerir esse número. Se mudares o nome de um trabalhador, o identificador mantém-se e os seus pontos, autocarros, compensação e histórico continuam associados à mesma pessoa. Um novo trabalhador começa sem pontos e sem dívidas relativas ao período anterior à sua entrada. Os nomes são apresentados por ordem alfabética, com os presentes primeiro e os ausentes depois.
2. Autocarros e pontos
Há quatro tipos: 13 m, 15 m, 18 m e Double Étage. Por padrão valem 1, 1, 1 e 2 pontos, respetivamente. Os valores podem ser alterados em Definições. O programa procura equilibrar os pontos e as quantidades de cada um dos quatro tipos, porque cada tipo tem um valor de pagamento diferente, mesmo quando vale o mesmo número de pontos. Não calcula salários sem os preços reais.
3. Atribuição manual: adiantamento
Os autocarros atribuídos manualmente são acrescentados à quota automática do trabalhador e retirados das quotas dos colegas, sem ultrapassar o stock da área. Exemplo: 40 autocarros, 8 trabalhadores; o Trabalhador 1 pode receber 7 na primeira área (5 normais + 2 de avanço). O programa procura compensar esse avanço nas áreas e dias seguintes até ao fim do mês, sem ultrapassar o stock.
4. Chegada atrasada
O trabalhador que chega atrasado começa apenas na área indicada (por exemplo, Área 2). Não recebe autocarros nas áreas anteriores e não recupera esses pontos. A redução por atraso é configurada em cada dia (por exemplo, 3 ou 5 pontos), comparando o acumulado do dia sem penalização adicional pelas áreas anteriores.
5. Saída antecipada — avanço e compensação
Como não se sabe em que área alguém vai sair, em Equipa marcas "Vai sair mais cedo" no início do dia: essa pessoa fica sempre um pequeno avanço de pontos (por defeito 3, em Definições) à frente dos colegas, em todas as áreas, para que ao sair tenha limpo tanto quanto os outros. Quando sair, escolhes Saiu mais cedo na área em que sai: mantém os autocarros e pontos feitos e não recebe mais nesse dia. No fim do dia (cartão "Fim do dia — saídas antecipadas") vês o resultado e escolhes Compensar ou Não compensar, mesmo com as áreas confirmadas. Se compensar e ficou com menos do que os presentes, a diferença é recuperada nos dias seguintes, sem passar à frente dos outros; se ficou com mais, não devolve.
6. Não participa nesta área — mantém o equilíbrio
Esta opção serve, por exemplo, para um trabalhador que já recebeu autocarros a mais numa área anterior. Recebe zero autocarros na área escolhida e pode voltar a participar na área seguinte. Os pontos e autocarros já limpos continuam a contar, e o trabalhador continua incluído na compensação diária e mensal. O objetivo é equilibrar os pontos, o número total de autocarros e os tipos 13 m, 15 m, 18 m e Double Étage até ao final do mês. Não é uma falta nem uma saída antecipada.
7. Compensação justa de forma contínua entre meses
O programa procura equilibrar os pontos e as quantidades dos quatro tipos (13 m, 15 m, 18 m e Double Étage), tendo em conta os adiantamentos manuais e as decisões do responsável. Não participar numa área não elimina a compensação. Já faltas e férias não criam dívida. Uma saída antecipada com compensação pode ser recuperada nos dias seguintes; uma saída antecipada sem compensação não. Quem chega atrasado não recupera as áreas anteriores. O equilíbrio automático é aproximado e deve ser conferido. Em Hoje → Compensações de hoje vês, pessoa a pessoa e dia a dia, porquê alguém recebe mais ou menos: o que o programa não conseguiu igualar num dia é compensado nos dias seguintes, por todos, de forma contínua.
8. Confirmação e segurança
Antes de avançar para a área seguinte, consulta a verificação de pontos e autocarros e confirma a área. A área confirmada fica bloqueada; para corrigir é preciso desbloquear com confirmação. Faz cópias de segurança JSON regularmente, sobretudo antes de trocar de versão ou limpar dados do navegador.
9. Semanas e meses
Os resultados são apresentados por semana e por mês, por trabalhador, com totais de 13 m, 15 m, 18 m, Double Étage, pontos e autocarros. Ao escolher Ir para semana seguinte, o programa pergunta se queres descarregar uma cópia JSON; avançar não apaga os registos anteriores.
10. Fechar o mês
Em Guardar e fechar o mês, exportas uma cópia, conservas os resumos semanais e mensais no Histórico e começas o novo mês com contadores a zero. As diferenças elegíveis para compensação continuam no mês seguinte, embora os relatórios mensais comecem do zero. No Supabase ficam os resumos, as matrículas dos Double Étage e os lugares; os detalhes completos de cada mês ficam no ficheiro JSON descarregado no fecho — guarda-o.
11. Segurança dos dados
Os dados ficam guardados no Supabase e são partilhados pelos utilizadores autorizados, por isso estão acessíveis em qualquer dispositivo após iniciares sessão. Exporta regularmente cópias JSON e guarda-as num local seguro; contêm dados dos trabalhadores.
12. Relatório do dia para o chefe
Em Hoje → Relatório do dia vês, para cada pessoa que trabalhou, os 13 m, 15 m, 18 m e Double Étage, o total de autocarros e os totais do dia. Os Double Étage contados como 2 × 13 m aparecem identificados (★) em quem os fez, e a matrícula dos Double aparece se a tiveres registado. Podes partilhar como imagem ou texto (WhatsApp, email…), copiar o texto ou guardar em PDF pelo botão Imprimir.
Atenção: estas são as regras de trabalho acordadas. A integração de compensações e sugestões ainda necessita de testes com dados fictícios; confirma sempre os resultados antes de os aplicar.