Overview Técnico

Objetivo

Concentrar uma visão executiva de engenharia com o estado atual do ecossistema (backend, web e mobile), fontes de verdade e leitura sugerida.

Snapshot atual (2026-03-10)

• Backend (billings-ease-backend)
• Go 1.25 + Echo + GORM + PostgreSQL
• API versionada em paralelo: /api, /api/v1, /api/v2
• Controle de módulos efetivos ativo (/users/me/modules) com catálogo canônico

• Marketplace com deleção lógica de cursos e processamento assíncrono de remoção de vídeos

• Frontend Web (billings-ease-web)

• React 18 + Vite 5 + TypeScript + pnpm
• Arquitetura modular em src/modules/**
• Rotas compostas por public/shared/client/professional/admin
• Layout persistente no router, sidebar em árvore colapsável e hubs por perfil

• Busca rápida global por command palette (⌘K/Ctrl+K) com índice por permissão

• Mobile (billings-ease-mobile)

• Expo 54 + React Native 0.81 + React 19
• Navegação por stack + tabs em src/navigation
• Estrutura por telas em src/screens/**
• Camada de API central em src/services/api.ts + serviços por domínio

Fontes de verdade por camada

1. Backend:
2. internal/http/bootstrap/routes.go
3. internal/modules/**

4. openapi.v1.yaml e openapi.v2.yaml

5. Frontend Web:

6. src/routes/*.tsx
7. src/modules/**

8. scripts/check-modules-architecture.sh

9. Mobile:

10. src/navigation/AppNavigator.tsx
11. src/navigation/MainTabs.tsx
12. src/screens/**
13. src/services/**

Leitura recomendada

1. Arquitetura Geral
2. C4 - Contexto
3. C4 - Containers
4. Backend - Estado Atual
5. Frontend - Estado Atual
6. Mobile - Estado Atual
7. Quickstart Engenharia