- Sistemas de campo offline-first
- Saúde digital
Consultare
API e back-office da app de primeiros socorros Consultare, desenhados para funcionar offline.
- Período
- 2019–2021
- Estado
- Em produção
- Papel
- Programador principal do backend e do back-office
- Cliente
- EQUIP Moçambique
- Parceiros
- Associação Empoderando Moçambique
Problema
Perante acidentes domésticos comuns (mordeduras, queimaduras, traumatismos, intoxicações) falta informação fiável de primeiros socorros, muitas vezes sem internet. A app precisava de conteúdo médico estruturado e de o ter disponível no telemóvel mesmo offline.
Solução
Construí a API JSON consumida pela app móvel e pela web app: categorias, incidentes com sintomas, tratamentos passo-a-passo e prevenções, destaques e informações de saúde pública. O back-office em Blade permite à equipa de conteúdo gerir tudo isto, ordenar passos e publicar ou despublicar sem apagar. A app mobile e a web app são da equipa.
Decisões técnicas
01
Rota única com todo o conteúdo para a app guardar localmente
`incidentes/all` devolve o conteúdo completo num só pedido, para a app o guardar e funcionar sem rede.
02
Ícones SVG embebidos em Base64 no JSON
Os ícones de categorias e destaques seguem dentro da resposta, o que permite um "pacote de ícones" descarregável e ilustrações offline.
03
Endpoint de "última actualização"
A app pergunta a data da última alteração e só volta a sincronizar quando há conteúdo novo.
04
Prevenções ligadas a vários incidentes (N:M)
Uma tabela pivot evita duplicar a mesma prevenção em cada incidente.
05
Estado activo/inactivo em vez de apagar
Categorias e incidentes podem ser retirados da app sem perder o conteúdo revisto.
Imagens
01 / 06 — Página inicial do Consultare com três telemóveis a mostrar categorias de incidentes e um tratamento passo-a-passo
Tecnologias
- Laravel
- PHP
- MySQL
- JavaScript
- Bootstrap
- Azure DevOps
Resultados verificáveis
- incidentes no back-office (80 activos)
- 158
- ícones inseridos
- 366
O que aprendi
Desenhar uma API para uma app offline: payload completo, recursos embebidos e uma data de actualização para decidir quando sincronizar.
ODS
ODS 3 · Saúde e Bem-Estarprincipal
Informação de primeiros socorros estruturada — sintomas, tratamentos passo-a-passo e prevenção — disponível no telemóvel mesmo sem internet, para acidentes domésticos e doenças comuns.