Documentação Plataforma Ingoo

1. Visão geral

A Ingoo é uma rede de aluguel de power banks portáteis distribuídos em comércios — bares, hotéis, casas de festa, eventos. O usuário escaneia um QR Code na máquina, retira um power bank, leva consigo, e devolve em qualquer outra máquina da rede. A tarifação é por hora, com 30 minutos grátis no primeiro uso.

Proposta de valor

2. Métricas em produção

Snapshot do banco de produção em Maio de 2026:

3. Stack tecnológico

4. Arquitetura

┌─────────────────────────────────────────────────────────────┐
│                    USUÁRIOS / USERS / 用户                  │
├─────────────────┬───────────────────┬───────────────────────┤
│   App Cliente   │   Máquina (APK)   │   Painéis Admin       │
│   (PWA mobile)  │   Android kiosk   │   (Web)               │
└────────┬────────┴─────────┬─────────┴───────────┬───────────┘
         │ HTTPS            │ MQTT/HTTPS          │ HTTPS
         ▼                  ▼                     ▼
┌─────────────────────────────────────────────────────────────┐
│         TRAEFIK 3.5 (HTTPS, Let's Encrypt)                 │
└────────┬────────────────────────────────────────────────────┘
         │
┌────────▼────────┐  ┌──────────────┐  ┌────────────────┐
│   API REST      │◄─┤  Mosquitto   │  │ Static Next.js │
│  (Fastify TS)   │  │    MQTT      │  │  (3 apps)      │
└────────┬────────┘  └──────┬───────┘  └────────────────┘
         ▼                  ▼
   ┌──────────┐         ┌──────────┐
   │PostgreSQL│         │  Redis   │
   │   16     │         │   7      │
   └──────────┘         └──────────┘

Princípios de design

• Type-safe end-to-end — Prisma → Fastify → Next.js, todos TypeScript
• Eventos primeiro — máquinas publicam heartbeat e eventos via MQTT; API consome e materializa estado
• Idempotência em pagamentos — toda transação MP/Stripe carrega correlation key
• Observabilidade — heartbeat watcher, audit log, alertas proativos

5. App cliente (PWA)

O cliente é uma PWA mobile-first em ingooapp.com.br. Instalação direta pelo navegador (Add to Home Screen). Funciona como app nativo no iOS e Android.

6. Sistema de pagamentos

7. Carteira (Ingoo Coin · IC)

A moeda interna é Ingoo Coin (IC). Conversão fixa: 1 IC = R$ 1,00. A UI usa apenas IC para reforçar identidade própria.

Tipos de transação

8. Comunidade e Ranking

Sistema de amizade

• Adicionar via QR Code do perfil ou pelo ranking
• Status: PENDING, ACCEPTED, BLOCKED
• Notificação push quando recebe pedido

Transferência de IC

• QR Code + valor; transferência instantânea entre amigos confirmados
• Limite anti-fraude: 100 IC/dia entre o mesmo par

Ranking Anual

• Soma todas as recargas (DEPOSIT_PIX + DEPOSIT_CARD) do ano corrente
• Top 50 público; modo anônimo opt-in (aparece como "Anônimo #N")
• Pódio com medalhas 🥇🥈🥉 e coroa flutuante no 1º
• Prêmios: 1º Smartphone · 2º Smartwatch · 3º Boné Oficial

9. Sistema de Indicação

Mecanismo de crescimento viral construído pra o aplicativo se espalhar organicamente.

Link único: ingooapp.com.br/r/{displayId}

10. Máquinas (kiosk Android)

Hardware atual: ZC-H133 (Allwinner), Android 9+ em modo kiosk.

Funcionalidades v4.2.x

• LED inteligente — slots indicam estado
• Watchdog em pen-drive — reinicia o kiosk se travar
• OTA via MQTT — superadmin push de APK
• Anúncios em vídeo
• Voz de devolução — TTS confirma devolução

11. Comunicação MQTT

Toda comunicação assíncrona entre máquinas e backend usa Mosquitto MQTT (porta 1883). Permite comandos em tempo real sem polling.

12. Painel Superadmin

Acesso em superadmin.ingooapp.com.br. Visão global da operação.

Liderança Global

13. Dashboard Regional (RJ)

Acesso em rj.ingooapp.com.br. Operação Rio de Janeiro.

14. Segurança e LGPD

15. Infraestrutura

Containers ativos

• ingoo-api — API REST + MQTT + jobs
• ingoo-client — PWA
• ingoo-dashboard — Admin RJ
• ingoo-superadmin — Admin global
• ingoo-db — PostgreSQL 16
• ingoo-redis — Redis 7
• traefik — HTTPS + reverse proxy
• mosquitto — MQTT broker
• ingoo-docs — esta documentação

16. Roadmap

Q2 2026 (em desenvolvimento)

• Expansão SP e BSB
• Apps nativos iOS/Android
• Integração com sistemas de hotel

Q3 2026 (planejado)

• Carregamento sem fio (Qi)
• Ingoo Pay
• Marketplace de comerciantes

Q4 2026 (visão)

• Expansão internacional
• Programa de franquia
• API pública