Skip to content

erdmanncross/ACS-Saude

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ACS Saúde — Aplicativo de Apoio ao Letramento em Saúde

Um aplicativo híbrido (web + mobile) desenvolvido para apoiar Agentes Comunitários de Saúde (ACS) na Atenção Primária à Saúde, facilitando a comunicação de conteúdos educativos em linguagem acessível durante visitas domiciliares e ações comunitárias.

🎯 Objetivo

Fortalecer as ações educativas na Atenção Primária, melhorando a comunicação entre profissionais de saúde e comunidade, ampliando o acesso da população a informações confiáveis em saúde.

✨ Funcionalidades Principais

  • 📚 Biblioteca de Temas — 10 temas prioritários (Hipertensão, Diabetes, Vacinação, Saúde do Idoso, Medicamentos, Saúde da Criança, Saúde da Gestante, Tuberculose, Dengue, Saúde Mental)
  • 📖 Glossário Visual — 25+ termos técnicos com definições em linguagem simples e emojis ilustrativos
  • ✅ Checklists de Visita — 6 templates para organizar visitas domiciliares (Geral, Idoso, Criança, Gestante, Hipertenso, Diabético)
  • 🔀 Fluxos de Orientação — 5 fluxos de decisão interativos para identificar sinais de alerta e encaminhar adequadamente
  • 🎬 Vídeos Educativos — Conteúdo audiovisual por tema para apoiar as orientações
  • 🔍 Busca Global — Busca unificada em temas, glossário e fluxos
  • 📶 Modo Offline — Todos os conteúdos disponíveis sem conexão à internet
  • 🏠 Dashboard Inteligente — Home com dica do dia, acesso rápido e temas em destaque

🛠 Tech Stack

Camada Tecnologia
Frontend Expo 54, React Native 0.81, React 19, TypeScript 5.9
Styling NativeWind 4 (Tailwind CSS para React Native)
Navegação Expo Router 6
Backend Firebase (Firestore, Auth, Storage, Cloud Functions)
Persistência Local AsyncStorage
Testes Vitest

📱 Plataformas Suportadas

  • iOS (via Expo/EAS)
  • Android (via Expo/EAS)
  • Web (via Firebase Hosting)

🚀 Quick Start

Pré-requisitos

node >= 18
pnpm >= 9.12.0
firebase-tools >= 13.0.0
eas-cli >= 5.0.0

Instalação e Desenvolvimento

# 1. Clonar repositório
git clone https://github.com/erdmanncross/ACS-Saude.git
cd ACS-Saude

# 2. Instalar dependências
pnpm install

# 3. Iniciar dev server
pnpm dev

# 4. Acessar no navegador
# Web: http://localhost:8081
# Mobile: Escanear QR code com Expo Go

Testes

pnpm test

📚 Estrutura do Projeto

acs-saude-app/
├── app/                    # Rotas Expo Router
│   ├── (tabs)/            # Navegação principal (5 abas)
│   ├── tema/[id].tsx      # Detalhe do tema
│   ├── video/[id].tsx     # Player de vídeo
│   ├── perfil.tsx         # Perfil do ACS
│   ├── busca.tsx          # Busca global
│   └── configuracoes.tsx  # Configurações
├── components/            # Componentes reutilizáveis
├── hooks/                 # Hooks customizados
├── lib/                   # Utilitários e dados
│   ├── health-data.ts     # Conteúdo de saúde (temas, glossário, vídeos, fluxos)
│   └── storage.ts         # Persistência offline
├── tests/                 # Testes unitários
├── design.md              # Plano de design da interface
├── DEPLOY_FIREBASE.md     # Guia de deploy no Firebase/GCP
└── todo.md                # Checklist de funcionalidades

🔐 Segurança e Privacidade

  • Autenticação via Firebase Authentication
  • Dados do usuário armazenados apenas localmente (AsyncStorage) ou no Firestore com regras de segurança
  • Modo offline não requer conexão à internet
  • Nenhum dado pessoal é compartilhado com terceiros

📦 Deploy

Web (Firebase Hosting)

firebase login
firebase init hosting
pnpm run build:web
firebase deploy --only hosting

Mobile (Expo/EAS)

eas login
eas build --platform android --profile preview
eas build --platform ios --profile preview

Veja DEPLOY_FIREBASE.md para instruções detalhadas.

📋 Checklist de Funcionalidades

Veja todo.md para o status completo de todas as funcionalidades implementadas.

🤝 Contribuindo

Contribuições são bem-vindas! Por favor:

  1. Faça um fork do repositório
  2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
  3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
  4. Push para a branch (git push origin feature/AmazingFeature)
  5. Abra um Pull Request

📝 Licença

Este projeto é licenciado sob a MIT License — veja o arquivo LICENSE para detalhes.

📧 Contato e Suporte

Para dúvidas, sugestões ou reportar bugs, abra uma issue no repositório.


Desenvolvido com ❤️ para fortalecer a Atenção Primária à Saúde

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors