AlocMap - Tutorial

Mensagem do Desenvolvedor

O AlocMap nasceu da necessidade real de gerir, de forma eficiente, a ocupação de gabinetes numa clínica médica. O desafio: distribuir ocupantes (por exemplo, médicos) pelos espaços disponíveis, respeitando disponibilidades e requisitos específicos (ex.: medicina dentária, oftalmologia, cardiologia). Sem uma ferramenta dedicada, a gestão torna‑se complexa e propensa a conflitos.

Transformei esse desafio numa aplicação prática e em constante evolução. Procurei torná‑la transversal para outros contextos com necessidades semelhantes: quartos de hotel, mesas de restaurante, salas de formação — sempre que seja necessário reservar um espaço e evitar sobreposições.

Entrar ou criar um projeto 

1. Aceda a alocmap.byronsd.com. Confirme que usa um navegador atualizado e que a sua rede não bloqueia o endereço. Dúvidas? Contacte‑me.
2. Se este aplicativo lhe foi indicado pelo administrador, ele dir‑lhe‑á o nome do projeto e a palavra‑passe do projeto a introduzir.

3) Para criar um novo projeto:
4) Clique em "+ Nova Unidade".
5) Preencha os dados de identificação da unidade:
    a) Nome e morada — obrigatórios;
    b) Telefone e email — opcionais.
6) Configuração da unidade:
    a) Nome dos ocupantes — no meu caso, "médicos"; pode usar professor, turma, técnico, profissional, cliente, etc.;
    b) Nome das alocações — no meu caso, "gabinetes"; pode ser quartos, mesas, salas, etc.
7) Palavras‑passe (dois níveis):
    a) Palavra‑passe do projeto — acesso de consulta;
    b) Palavra‑passe de administrador — acesso para configurar o projeto, editar alocações, criar ocupantes, etc.

Página Principal 

Esta é a página principal da aplicação. Neste exemplo está preenchida com dados de teste; se estiver a criar um projeto de raiz, mais abaixo explico como configurar.

O que vê neste ecrã:
1) Seletor de data: no canto superior esquerdo, escolha o dia a visualizar. Por defeito, a aplicação abre no dia de hoje, mas pode selecionar qualquer outro dia ou mês.
2) Na coluna da direita (barra branca) estão os ocupantes (neste caso, médicos). Nestes cartões encontram‑se os médicos que deram disponibilidade para trabalhar no dia selecionado, com indicação da hora e da especialidade (para facilitar a alocação).
3) Abaixo, surgem os setores (no meu caso, 4 pisos de consultas) e, dentro de cada piso, os gabinetes de consulta disponíveis, onde são alocados os médicos.

4) Quem entrar no projeto com a palavra‑passe de administrador pode fazer as alocações: arraste o cartão da caixa branca para um gabinete. Pode também mover um cartão de um gabinete para outro ou voltar a colocá‑lo na caixa branca.

5) Abaixo do seletor de data existe um filtro onde pode, por exemplo, escolher apenas um piso, mostrar só gabinetes ocupados ou livres, ou os que têm conflitos (dois médicos no mesmo horário). Também pode ver apenas médicos de uma especialidade ou um médico em específico para saber em que gabinete está.

Drawer - Menu com opções (Admin)

Se entrar com a palavra‑passe de administrador, encontrará no canto superior direito da barra superior (app bar) o menu lateral (drawer). Este menu dá‑lhe acesso a várias configurações, listadas abaixo e explicadas mais adiante.

Gerir Ocupantes (Admin)

Como já referi, no meu caso, os ocupantes do gabinete são médicos, e como foi isso que configurei no início do projeto, então aparece Gerir Médicos.

1. Ao Clicar no icon aparece a listagem dos ocupantes já criados, e o icon + no canto inferior direito que permite criar novos ocupantes.

2. Configurar ocupante

Pode criar um novo ocupante ou, se tocar num cartão da lista anterior, editar a configuração existente.
Neste cartão pode:
1. Colocar o nome do médico;
2. Indicar a especialidade;
3. Adicionar observações pertinentes;
4. Clicar num dia da semana e escolher corretamente o tipo de marcação no diálogo seguinte.

5. Ao clicar num dia (ex.: segunda‑feira) será questionado sobre o tipo de marcação:
a) Única — apenas esse dia;
b) Semanal — todas as segundas‑feiras até ao final do ano;
c) Quinzenal — semana sim, semana não;
d) Mensal — por exemplo, a primeira segunda‑feira de cada mês até ao final do ano;
e) Consecutivas — vários dias seguidos numa semana específica.

Se não está a gerir uma clínica, o modelo adapta‑se a outros cenários. Por exemplo, numa empresa: todas as segundas quartas‑feiras do mês, 10h00–13h00, reserva a sala para a reunião operacional.

Gerir Alocações (Admin)

Mais uma vez, com acesso de administrador é possível criar e editar alocações.
No meu caso, criei quatro pisos de consultas e, dentro de cada piso, os gabinetes com a respetiva numeração e especialidades permitidas.

À semelhança de "Gerir Médicos", pode editar um gabinete tocando no ícone de lápis, ou criar um novo local usando o botão no canto inferior direito.

Ao criar um novo local, são pedidos três dados principais:

1. Nome do local
2. Piso/Setor
3. Especialidades permitidas

Configurar Horário (Admin)

Esta é outra configuração importante.
O seu estabelecimento, pode esta sempre aberto 24/24h.
Pode abrir das 9 às 16h, todos os dias da semana.
Pode encerrar às 2a feira, como a fazem alguns restaurantes.
Esta configuração do horário permite gerir essas particularidades

Feriados e dias encerrados (Admin)

Registe aqui os dias em que o estabelecimento está encerrado. Por exemplo, feriados: ao selecionar um feriado no calendário, surgirá a indicação "Estabelecimento encerrado". Pode também registar períodos de férias, obras ou outras situações semelhantes.

Relatórios (Admin)

Este módulo está em desenvolvimento. Estou a recolher necessidades reais de relatórios (ex.: taxas de ocupação por período, espaços livres/ocupados, distribuição por especialidade) para disponibilizar os mais úteis. Assim que estiver pronto, atualizarei este tutorial.