The National Digital Address Infrastructure for Angola
Milhões de pessoas em Angola vivem em zonas sem nomes de ruas formais. Esta realidade cria barreiras críticas:
| Setor | Impacto |
|---|---|
| 🚑 Emergências | Ambulâncias não conseguem localizar pacientes rapidamente |
| 📦 Logística | Entregas atrasam ou perdem-se; custos operacionais elevados |
| 🛒 E-commerce | Empresas hesitam em operar em Angola |
| 🏦 Serviços Financeiros | Bancos não conseguem verificar endereços para crédito |
| 🏛️ Governo | Censos e levantamentos imprecisos; planejamento urbano difícil |
| 🌍 Inclusão Digital | Milhões excluídos da economia digital |
Morada AO cria uma infraestrutura de endereçamento digital capaz de identificar qualquer localização em Angola com precisão.
Usando Plus Codes (Google Open Location Code), a aplicação gera moradas únicas, curtas e fáceis de partilhar — sem depender de internet ou de nomes de ruas formais.
✅ Funciona offline — GPS + algoritmo local
✅ Preciso — Até 3 metros de precisão
✅ Simples — Código curto + nome de bairro
✅ Partilhável — WhatsApp, SMS, email
✅ Grátis — Código aberto, sem tracking
✅ Escalável — Pronto para governo e empresas
- ✅ Geração de Plus Codes em tempo real via GPS
- ✅ Modo offline completo
- ✅ Partilha via WhatsApp, SMS, clipboard
- ✅ Mapa interativo (OpenStreetMap)
- ✅ Reverse geocoding (nome do bairro/cidade)
- ✅ Interface em Português e Inglês
- ✅ Tema claro/escuro
- 🚧 Histórico de moradas
- 🚧 Favoritos e pontos de interesse
- 🚧 Portal GIS (análise geoespacial)
- 🚧 Portal Business (integração para empresas)
- 🚧 API pública (SDKs para JavaScript, Python, Flutter)
- 🚧 Portal Government (estatísticas nacionais)
- 🚧 Integração com drones e IA
- 🚧 Dashboard de analytics
- 📲 Google Play (em breve)
- 🍎 Apple App Store (em breve)
- 🌐 Web (em desenvolvimento)
┌─────────────────────────────────────────────────────────────┐
│ Morada AO Platform │
└──────────────────┬──────────────────────────────────────────┘
│
┌──────────┼──────────┐
│ │ │
📱 Mobile 💼 Business 🏛️ Government
(Expo) Portal Portal
│ │ │
└──────────┼──────────┘
│
┌────────▼────────┐
│ API Gateway │
│ (Express.js) │
└────────┬────────┘
│
┌──────────┴──────────┐
│ │
📊 PostgreSQL 🗺️ GIS Services
+ PostGIS (PostGIS, OSM)
│ │
└──────────┬──────────┘
│
┌──────────────┼──────────────┐
│ │ │
🔐 Plus Codes 🗺️ OpenStreetMap 📍 Reverse Geo
(google-olc) (Leaflet) (Nominatim)
| Camada | Tecnologia |
|---|---|
| Frontend | React Native 0.81.5, Expo 54, TypeScript |
| Backend | Express.js, Node.js, TypeScript |
| Database | PostgreSQL 16, PostGIS 3.4, Drizzle ORM |
| GIS | PostGIS, Plus Codes, OpenStreetMap, Nominatim |
| Autenticação | JWT, Zod validation |
| Testing | Jest, React Native Testing Library, Playwright |
| CI/CD | GitHub Actions |
| Deployment | Docker, Kubernetes (pronto) |
- SETUP.md — Guia de configuração do ambiente
- CONTRIBUTING.md — Como contribuir
- Architecture — Decisões arquiteturais
- API Docs — Endpoints e exemplos
- Database — Schema e migrations
- GIS Guide — Tudo sobre PostGIS e geoespacial
- Roadmap — Plano para os próximos 12 meses
- Security Policy — Política de segurança
Visite a Wiki para:
- Architecture Deep Dive
- GIS Concepts
- Business Model
- Government Integration
- Deployment Guides
- Node.js 18+
- PostgreSQL 16
- Git
# 1. Clone o repositório
git clone https://github.com/rasgadocarlos2-jpg/morada-ao.git
cd morada-ao
# 2. Instale dependências
npm install
# 3. Configure variáveis de ambiente
cp .env.example .env
# Edite .env com a sua DATABASE_URL
# 4. Migrações da base de dados
npm run db:push
# 5. Inicie o desenvolvimento
npm run expo:dev # Terminal 1: Mobile
npm run server:dev # Terminal 2: Backend# Desenvolvimento
npm run expo:dev # Expo dev server
npm run server:dev # Express dev server
npm run lint:fix # Lint + format
npm run check:types # Type checking
# Produção
npm run expo:static:build # Build Expo
npm run server:build # Bundle backend
npm run server:prod # Run production
# Testes
npm run test # Jest
npm test:coverage # Com coveragemorada-ao/
├── client/ # React Native app
│ ├── screens/ # Telas (Map, Settings, etc)
│ ├── components/ # Componentes reutilizáveis
│ ├── hooks/ # Custom hooks
│ ├── lib/ # Utilitários (storage, query client)
│ ├── navigation/ # React Navigation
│ └── constants/ # Cores, spacing, themes
│
├── server/ # Express backend
│ ├── index.ts # Configuração do servidor
│ ├── routes.ts # Endpoints da API
│ ├── storage.ts # Database initialization
│ └── templates/ # HTML templates
│
├── shared/ # Código compartilhado
│ └── schema.ts # Drizzle ORM + Zod schemas
│
├── docs/ # Documentação
│ ├── architecture.md
│ ├── api.md
│ ├── database.md
│ ├── gis.md
│ └── roadmap.md
│
├── infra/ # Infraestrutura
│ ├── docker/
│ ├── terraform/
│ └── kubernetes/
│
└── package.json
Adoraríamos a sua contribuição! Leia CONTRIBUTING.md para:
- Como reportar bugs
- Como sugerir features
- Guia de desenvolvimento
- Padrões de código
- Processo de pull request
2025 Q1 ✅
├── MVP Mobile App
├── Plus Code Generation
├── Offline Mode
└── Basic Sharing
2025 Q2 🚧
├── History & Favorites
├── Business Portal (Beta)
├── Public API v1
└── Documentation Suite
2025 Q3 🎯
├── GIS Portal
├── Government Integration
├── Analytics Dashboard
└── SDK Releases (JS, Python, Flutter)
2025 Q4+ 🚀
├── AI-powered address suggestions
├── Drone integration
├── Mobile wallet integration
└── Enterprise features
Veja o roadmap completo com detalhes técnicos.
A sua privacidade é importante.
- ✅ Sem tracking — Nenhum dado pessoal é recolhido
- ✅ Open source — Código auditável
- ✅ Offline first — Funciona sem internet
- ✅ Responsável — Política de Segurança
Para reportar vulnerabilidades, veja SECURITY.md.
Este projeto está licenciado sob a MIT License.
Você é livre para usar, modificar e distribuir este software em projetos comerciais e pessoais.
- 🌐 Website: rasgadolabs.com
- 📧 Email: carlos@rasgadolabs.com
- 📱 Instagram: @rasgadolabs
- 💬 Discussions: GitHub Discussions
- 🐦 Twitter: @rasgadolabs
- Google Plus Codes — Algoritmo de endereçamento
- OpenStreetMap — Dados geográficos
- PostGIS — Análise geoespacial
- Expo — Plataforma React Native
- 🇦🇴 Comunidade Angolana — Inspiração e feedback
- Versão: 1.0.0-beta
- Última atualização: 2025-07-23
- Estado: Produção (Beta)
- Plataformas: iOS, Android, Web (em breve)