Shadow Wizard Money Gang

Sistema financeiro multiusuário para entradas, saídas e recorrências organizadas em cofres. Cada conta pode manter diversos cofres e definir qual deles é o principal da Home. A marca exibida é SHADOW WIZARD / MONEY GANG, com o bordão WE LOVE CASTING SPELLS. O sistema foi desenvolvido pela Shadow Government; o nome técnico do monorepo é shadowwizard.

O produto separa regras financeiras puras, API NestJS/Fastify, PostgreSQL e um aplicativo Expo que funciona na web e em dispositivos móveis. A interface atual adota brutalismo místico claro: fundo lavanda, superfícies lilás e creme, acentos pastéis em amarelo, coral, ciano e verde, bordas retas, sombras rígidas e texto roxo quase preto para manter contraste.

Começar localmente

Copy-Item .env.example .env
docker compose up --build

Esse único comando sobe PostgreSQL, pgAdmin, aplica as migrações, inicia a API, o Expo Web e o servidor Expo para mobile. Os serviços ficam disponíveis em:

• Web: http://localhost:8081
• API: http://localhost:3003/api/v1/health
• pgAdmin: http://localhost:5050
• Mobile: Expo/Metro na porta 8082 (abra o QR code no Android Emulator)

Na primeira execução o serviço de migração prepara as dependências Linux nos volumes Docker; por isso ela pode levar alguns minutos. Nas execuções seguintes, essa etapa só volta a instalar dependências quando o pnpm-lock.yaml mudar.

Os padrões de mobile no .env.example atendem ao Android Emulator. Para abrir em um dispositivo físico, defina MOBILE_API_URL e EXPO_PACKAGER_HOSTNAME com o IPv4 da rede local deste computador antes do comando (por exemplo, http://192.168.1.20:3003/api/v1 e 192.168.1.20).

Use docker compose down para encerrar o ambiente. Para trabalhar sem API, defina EXPO_PUBLIC_USE_MOCKS=true no .env e recrie o serviço desejado.

Documentação

• Decisões e roadmap
• Testes e validação
• Etapa 1 — domínio e infraestrutura
• Etapa 2 — persistência e API
• Etapa 3 — aplicativo universal
• Etapa 4 — autenticação
• Etapa 5 — sessão e conectividade
• Etapa 6 — experiência visual
• Etapa 7 — administração e correções operacionais
• Etapa 8 — refatoração arquitetural e qualidade
• Etapa 9 — cofres e navegação

Verificação rápida

pnpm test
pnpm exec tsc --noEmit --project tsconfig.json

Na última validação documentada, a suíte preservada concluiu com 91 testes em 19 arquivos. Consulte Testes e validação antes de alterar comportamento ou cobertura.