CARDBOARD PROTOCOL / DOSSIER DO PROJETO
AFRICAN BUSINESS NETWORK
Infraestrutura operacional partilhada para empresas africanas.
Capítulo 01
O Gatilho
As operações existiam em ferramentas desligadas, sem identidade ou contexto comum.
A empresa continuava a ser uma só entidade. As suas operações estavam divididas por sistemas sem relação entre si.
Uma secretária fragmentada
folha de cálculo faturação chat
banco inventário formulário público
pagamento logística documentosOBSERVAÇÃO
O problema não era a ausência de software. Cada ação operacional vivia num sistema diferente, com identidade e modelo de dados próprios.
Uma empresa africana não deveria reconstruir a sua identidade digital sempre que entra noutro fluxo, rede de parceiros ou país.
Capítulo 02
A Suposição Oculta
O software empresarial é desenhado como produtos isolados, enquanto a empresa continua a ser uma entidade única.
SUPOSIÇÃO
O software fragmenta a empresa
ERP, CRM, pagamentos e marketplaces resolvem áreas separadas.
A questão arquitetural tornou-se: o que precisa de permanecer comum em todas as operações?
- Identidade da organização
- Membros, papéis e permissões
- Confiança e documentos
- Eventos e auditoria
- Integrações
- Contexto nacional e financeiro
Capítulo 03
O Primeiro Modelo
A primeira implementação precisava de fronteiras fundacionais, não da superfície da visão final.
REJEITADO — SUPERFÍCIE EXCESSIVA
- CRM
- Faturas
- Inventário
- Pagamentos
- Marketplace
- Documentos
- Automação
- IA
- Logística
RETRABALHADO
Fundação primeiro
Identidade, Organização, Membros, papéis e permissões tornaram-se a fronteira inicial.
Contratos, eventos, dados e APIs comuns definem aquilo de que os módulos futuros dependerão.
Capítulo 04
A Fricção
A visão atravessa países e fornecedores, mas implementar esse futuro de imediato destruiria a clareza.
Pressão de longo prazo
- Países e regimes fiscais
- Moedas, idiomas e fusos horários
- Bancos, governos e operadoras
- Logística, seguros e plataformas globais
- Conectividade instável
O perigo não era pensar pequeno.
O perigo era implementar a arquitetura de 15 anos na primeira versão.
- Microsserviços prematuros
- Consistência distribuída
- Deploys fragmentados
- Responsabilidade pouco clara
- Infraestrutura sem casos validados
Capítulo 05
A Viragem
Começar com um monólito modular bem particionado e extrair apenas sob pressão mensurável.
FRONTEIRA DO SISTEMA
Monólito modular primeiro
A simplicidade transacional mantém-se enquanto domínios e contratos ficam isolados.
Microsserviços devem surgir por extração controlada, não por ideologia.
PRÓXIMA EXTRAÇÃO
- Escala independente
- Equipa dedicada
- Isolamento regulatório ou de segurança
- SLA diferente
- Carga computacional especial
- Integração externa crítica
Capítulo 06
O Sistema
Uma plataforma em camadas, com bounded contexts baseados em capacidades de negócio.
Camadas da plataforma
- 01Experiência
- 02API
- 03Aplicação
- 04Domínio
- 05Infraestrutura
- 06Plataforma
Monorepo
apps/ api (NestJS) web (Next.js)
packages/ domain events permissions validation
docs/ journeys model contracts ADRs diagrams
infra/ Docker Kubernetes Helm TerraformPadrões seletivos
Eventos descrevem factos depois de mudanças válidas, não comandos disfarçados.
CQRS e event sourcing só entram onde modelos divergentes ou verdade histórica completa justificam o custo.
Capítulo 07
Trade-offs
O desenho protege o modelo de longo prazo e restringe a superfície implementada.
Visão ampla / MVP estreito
Preservar o modelo de longo prazo na documentação; limitar a implementação aos domínios fundacionais.
Documentar antes de expandir
Definir jornadas, domínio, permissões, eventos e contratos antes de multiplicar funcionalidades.
Prontidão multinacional e IA
Modelar extensões sem fingir cobertura regulatória nem forçar IA em cada operação.
Capítulo 08
Limites Atuais
A fundação implementada e os módulos futuros permanecem claramente separados.
VERIFICADO
Implementado
- Monorepo pnpm e Turborepo
- Bootstrap web Next.js
- Bootstrap API NestJS
- PostgreSQL e Redis
- Documentação Enterprise MVP
- Fundação inicial de Identidade e Organização
LIMITE ATUAL
Não implementado
- Faturas e pagamentos
- Inventário e contactos
- Documentos e automação
- Workflows de IA em produção
- Integrações externas
Capítulo 09
O Que Mudaria
A evolução permanece ligada a pressão arquitetural observável.
PRÓXIMA EXTRAÇÃO
- Testes executáveis de arquitetura
- Outbox e versionamento de eventos
- Testes de isolamento tenant e simulação de políticas
- Registo de capacidades por país
- Fluxos tolerantes a offline
- Fronteiras regionais e de ledger
- Sandbox de integrações e SDK público
- Extração de módulos apenas sob pressão mensurável
Capítulo 10
Ficheiro Técnico
A fundação atual da plataforma e as suas fronteiras explícitas.
VERIFICADO
web: Next.js + TypeScript
api: NestJS
dados: PostgreSQL + Redis
workspace: pnpm + Turborepo
arquitetura: monólito modular
domínios: fundação Identity + Organization
evidência: requisitos, jornadas, contratos, ADRsAfrican Business Network foi desenhada como uma fundação da qual podem surgir sistemas operacionais sem fragmentar a empresa que existe por baixo.
Contracapa
Muitos sistemas operacionais podem surgir sem fragmentar a empresa que existe por baixo.