🌐 ABRIR SUBMUNDO AO VIVO

SUBMUNDO é um simulador persistente de estratégia e gestão criminal, pensado para Web e com interface mobile-first. O jogador não controla uma única personagem: controla uma organização inteira, o seu Quartel-General, equipas, operacionais, frota, armamento, imóveis, dinheiro, influência, risco policial e operações em tempo real.

O mapa é o centro da experiência. O mundo nasce à volta do Quartel-General escolhido pelo jogador em território português, as oportunidades surgem dinamicamente, as equipas deslocam-se pelo mapa, as operações evoluem por fases e a economia continua a produzir consequências enquanto a organização cresce.

Projeto ficcional. SUBMUNDO é uma obra original de estratégia/gestão inspirada apenas no género de sandbox criminal. Não reutiliza personagens, missões, mapas, arte, áudio ou texto de outras propriedades intelectuais.

Compatibilidade de deployment: o caminho LusoraeCrime que ainda aparece no URL do GitHub Pages é apenas o identificador legado do repositório/deploy atual; a marca do produto é exclusivamente SUBMUNDO.

O ecrã público de entrada é parte da experiência atual: permite jogar como convidado no próprio dispositivo e apresenta Google Sign-In quando o respetivo client ID está configurado.

• Visão do jogo
• Números atuais do conteúdo
• Mundo e mapa
• Operações e equipas
• Operacionais e RH
• Frota
• Armamento
• Imóveis e QG
• Economia e risco
• Missões e progressão
• Cidade Viva
• Mastermind
• Centro de Comando e UX
• Loja
• Polícia
• Simulação interior
• Administração e legal
• Arquitetura
• Stack técnica
• Rotas do frontend
• API
• Executar localmente
• Deploy
• Segurança
• Estrutura do repositório
• Testes
• Direção futura

O loop principal combina gestão, planeamento e execução:

1. Estabelecer o QG em terra firme portuguesa.
2. Gerar o mundo operacional em redor do QG.
3. Analisar oportunidades no mapa e no painel de operações.
4. Preparar equipas, operacionais, veículos e armamento.
5. Avaliar risco e probabilidade antes do despacho.
6. Enviar a equipa, acompanhar viagem, execução e regresso.
7. Gerir dinheiro limpo e sujo, calor, salários, combustível, desgaste e propriedades.
8. Expandir a organização com melhores operacionais, frota, armamento, QG e imóveis.
9. Controlar territórios, contactos e atividades de rua.
10. Planear grandes golpes através do sistema Mastermind.

O motor usa um modelo de progressão persistente e data-driven: o conteúdo vive sobretudo em game_data.py, economy_constants.py, city_data.py, quests_data.py e mastermind_data.py.

Assalto, Roubo de Veículo, Cobrança, Transporte Ilegal, Contrabando, Hack, Lavagem de Dinheiro, Infiltração, Ataque a Território, Operação VIP, Missão Especial, Entrega Expressa, Vigilância Digital, Assalto Armado, Suborno a Oficial, Rota Internacional, Ciberataque Bancário, Roubo de Joalharia, Assalto a Licorista, Roubo de Carga, Assalto a Casa de Penhores, Assalto a Carro Blindado, Emboscada a Rival, Assalto a Casino, Sequestro Relâmpago, Assalto a Museu, Guerra de Território, Entrega Local, Recolha de Mercadoria, Transporte de Armas, Rota Costeira, Contrabando de Tabaco, Frota Fantasma, Rota da Alfândega, Carga Diplomática, Rede de Distribuição, Porto Franco, Phishing Bancário, Clonagem de Cartões, Hack de Semáforos, Fraude de Criptomoedas, Invasão de Servidor, Ciberespionagem, Ataque DDoS, Roubo de Dados, Sabotagem Industrial, Guerra Cibernética, Proteção de Comércio, Boato de Rua, Suborno a Funcionário, Chantagem a Político, Lavagem via Casino, Infiltração em Sindicato, Acordo com Autarca, Campanha de Difamação, Controlo da Imprensa, Golpe de Estado Local, Roubo de Obra de Arte, Operação Encoberta, Resgate de Refém, Leilão Clandestino, Venda de Armamento, Fuga da Prisão, Assassínio por Contrato, Golpe ao Banco Central, Tráfico de Influência Internacional e Operação Fantasma.

Uma conta nova começa sem Quartel-General. O jogador escolhe o primeiro QG diretamente no mapa.

A validação é feita no servidor:

• apenas em terra firme portuguesa;
• Continente, Madeira e Açores são suportados;
• mar e grandes corpos de água interiores são rejeitados;
• existe proteção adicional junto a costa/fronteira;
• a posição é validada com geometria GeoJSON real de Portugal;
• o QG é uma decisão permanente no fluxo atual.

Depois da colocação:

• são geradas aproximadamente 16 zonas;
• as zonas distribuem-se por 3 anéis de distância;
• zonas próximas tendem a suportar operações mais rápidas;
• zonas mais afastadas alimentam maior distância, risco e recompensa;
• todos os pontos são novamente validados em terra;
• as zonas recebem nomes reais através de reverse geocoding;
• o sistema evita mostrar zonas ainda sem nome confirmado.

• React Leaflet + Leaflet.
• Base CartoDB Dark Matter.
• Marcadores de oportunidades, equipas, imóveis, QG e polícia.
• Movimento interpolado em tempo real.
• Legenda, filtros e tooltips.
• Interface desenhada para desktop e toque/mobile.
• Colocação de imóveis e QG em modo focado para evitar UI sobreposta.

Existem quatro especializações base de equipa:

O sistema operacional inclui:

• preview de despacho;
• decomposição da probabilidade de sucesso;
• recomendação de oportunidade;
• recomendação de equipa;
• recomendação para repetir operações;
• favoritos por tipo de oportunidade;
• requisitos por nível;
• requisitos de veículos;
• categorias e especializações adequadas;
• efeitos de distância;
• trânsito;
• chuva;
• noite/discrição;
• fadiga;
• moral;
• lealdade;
• experiência da equipa;
• compatibilidade do veículo;
• compatibilidade do armamento;
• condição do veículo;
• proficiência das armas;
• liderança e composição da equipa;
• calor policial;
• presença policial local;
• efeitos de propriedades;
• cooldown após missões e alterações de roster;
• recall de equipas em trânsito;
• bónus por presença local;
• eventos excecionais e saque adicional;
• progressão por fases: viagem, operação, regresso e conclusão.

O motor mantém um piso de chance e risco residual: nenhuma operação é garantida a 100%.

Assaltante, Motorista, Hacker, Mecânico, Informador, Médico Clandestino, Lavador de Dinheiro, Advogado, Negociador, Segurança, Contrabandista, Falsificador, Espião, Gestor de Empresa, Franco-Atirador, Arrombador, Piloto de Fuga, Estafeta, Engenheiro Social, Criptógrafo, Relações Públicas, Chantagista, Químico e Recrutador.

Força, Inteligência, Discrição, Condução, Tiro, Hack, Negociação, Sangue-frio e Resistência.

• 4 raridades: Comum, Raro, Elite e Lendário;
• 7 ranks: Recruta → Membro → Especialista → Veterano → Tenente → Chefe de Equipa → Braço-Direito;
• 10 talentos;
• XP e level individual;
• promoções pagas;
• salários;
• histórico por operacional;
• bónus e passivos de especialização.

Cada operacional pode ser afetado por:

• moral;
• lealdade;
• fadiga;
• ausência;
• treino;
• descanso;
• ferimentos;
• prisão;
• missão ativa;
• risco de traição.

A organização pode sofrer roubo interno, fuga de informação, sabotagem ou abandono quando o risco de traição cresce.

Fontes: Rua, Bares, Empresas, Prisões, Mercado Negro e Contactos.

Cursos: Combate, Condução Evasiva, Hacking, Discrição, Negociação, Primeiros Socorros, Logística, Gestão, Liderança e Treino Físico.

A frota tem:

• gasolina e gasóleo;
• consumo real por modelo;
• tamanho de depósito;
• autonomia;
• combustível;
• desgaste e condição;
• quilometragem;
• reparação;
• abastecimento;
• compra e venda;
• atribuição e transferência;
• otimização automática;
• compatibilidade por tipo de operação;
• notoriedade no sistema Cidade Viva;
• apreensão, seguro e recuperação em mecânicas de rua.

O modelo de armas considera:

• potência;
• precisão;
• alcance;
• peso;
• velocidade de utilização;
• durabilidade;
• fiabilidade;
• capacidade de carregador;
• manutenção;
• discrição;
• requisitos de atributos;
• compatibilidade com a operação;
• proficiência do operacional;
• condição;
• desgaste por missão;
• risco de encravamento;
• munição carregada e stock logístico por categoria;
• recarga a partir do inventário da organização;
• cinco linhas de modificações persistentes (fiabilidade, ergonomia, precisão, perfil discreto e reforço);
• impacto no calor e na probabilidade da missão.

• imóveis podem ser comprados, vendidos, renomeados e melhorados;
• nível máximo atual de imóvel: 3;
• propriedades influenciam economia, capacidade e operações;
• calor elevado pode criar risco de rusga;
• existe otimização de propriedades;
• cada imóvel pode desenvolver Segurança, Armazenamento e Operações;
• até quatro operacionais livres podem ser destacados para uma instalação e aumentar a sua eficiência;
• o preço regional efetivamente pago é usado também nas melhorias automáticas;
• o QG possui sistema próprio de upgrades, prioridades e cosméticos;
• os departamentos Financeiro, RH, Logística, Investigação e Comunicações têm três níveis e efeitos reais;
• nível máximo atual do QG: 10, com o tier final reservado à organização nível 100.

O jogo trabalha com duas moedas operacionais:

• dinheiro limpo;
• dinheiro sujo.

Valores de arranque definidos atualmente no motor:

• 100 000 € limpos;
• 5 000 € sujos.

Outros sistemas:

• lavagem manual;
• lavagem passiva;
• produção passiva;
• limites de dinheiro sujo;
• calor adicional por acumulação de dinheiro sujo;
• salários;
• manutenção;
• combustível;
• reparações;
• compra/venda de ativos;
• suborno policial;
• tratamento médico;
• libertação de operacionais;
• custos de recrutamento, treino e promoção;
• registo de transações;
• escalonamento de recompensas;
• distância e dificuldade;
• bónus permanentes por marcos de sucesso;
• centro financeiro de 30 dias com receitas, despesas, resultado e valor dos ativos;
• três níveis de controlo territorial com custo de defesa e rendimento passivo;
• investimentos de prestígio de late game;
• rede de proteção temporária contra rusgas.

O fecho económico acontece todas as segundas-feiras às 20:00, Europe/Lisbon. Cobra salários brutos, TSU patronal, a fração semanal dos custos fixos da frota, manutenção imobiliária e defesa territorial. Combustível e reparações continuam a ser custos variáveis. Os valores são centralizados em backend/economy_constants.py.

A organização tem agora 100 níveis. Os níveis 1–10 preservam os thresholds históricos para manter compatibilidade com saves existentes; os níveis 11–100 usam uma curva progressiva própria.

O conteúdo deixa de ficar concentrado no early game: operações, veículos, armas, imóveis, recrutamento, território, prestige, especializações, QG e Mastermind distribuem desbloqueios ao longo da carreira. Marcos estruturais incluem território no 20/45/75, contactos no 75, infraestrutura soberana no 85 e o capstone Império SUBMUNDO no nível 100.

O frontend mostra o próximo desbloqueio relevante e revela módulos avançados progressivamente para reduzir carga visual no início.

Existem 102 definições de quests:

A história principal está organizada em 6 capítulos:

1. Começo
2. Expansão
3. Organização
4. Domínio
5. Consolidação
6. Legado

O sistema suporta:

• objetivos de estado e de contagem;
• recompensas escaladas;
• dificuldade;
• streaks;
• escolhas;
• eventos contextuais;
• missões dinâmicas geradas pelo estado atual;
• reclamar individualmente ou em massa;
• decisões com consequências.

O núcleo urbano está integrado no estado do jogador e influencia diretamente operações, economia e competição. A simulação usa o horário de Lisboa e janelas globais partilhadas, para que clima e acontecimentos sejam previsíveis e não um bónus escondido lançado por missão.

• procurado de 0 a 5 estrelas e camada policial no mapa;
• conquista de zonas operacionais a partir do nível 5;
• 3 níveis de consolidação territorial;
• pressão rival e defesa persistentes;
• custo semanal de defesa territorial;
• rendimento passivo territorial;
• bónus local de recompensa por controlo;
• 18 stocks consumíveis com capacidade de armazenamento;
• loadouts de equipa consumidos no despacho;
• notoriedade persistente por veículo;
• pneus, revisões, seguro e inspeção;
• apreensão temporária de veículos com recuperação mais rápida quando segurados;
• doutrinas de equipa: Equilibrada, Segurança Máxima, Baixo Perfil e Impacto;
• clima global persistente em janelas de 2 horas, com efeitos em deslocação, calor, recompensa e chance;
• ciclo horário madrugada/manhã/tarde/noite ligado a trânsito, polícia e operações;
• eventos urbanos globais em janelas de 6 horas e calendário dos próximos acontecimentos;
• notícias automáticas construídas a partir do estado da cidade e dos eventos reais da organização;
• 10 tipos de negócios urbanos com compra, níveis, condição, segurança, rendimento limpo/sujo e calor;
• bónus sistémicos da rede empresarial aplicados às categorias de operação relevantes;
• 5 organizações rivais NPC persistentes com poder, hostilidade, inteligência e pressão territorial;
• rivais autónomos em janelas de 3 horas: podem sabotar negócios, aumentar calor, pressionar território ou ajudar quando aliados;
• reconhecimento, sabotagem, pressão, tréguas e acordos com rivais, com custos e cooldowns;
• temporadas de 30 dias, leaderboard e prémios automáticos de pódio com claim atómico;
• PvP opt-in, desafios com consentimento e consequências persistentes;
• alianças entre jogadores por código de convite;
• chat/frequência da cidade com limitação de spam;
• casino clandestino com roleta e blackjack, usando exclusivamente moeda do jogo;
• saúde/stress do chefe, hospitalização e detenção com impacto real e visível na liderança das operações;
• modo convidado local com uma simulação equivalente de Cidade Viva para o GitHub Pages.

A Cidade Viva não substitui a preparação das equipas: os seus multiplicadores são deliberadamente limitados e ficam visíveis no preview do despacho.

O sistema Mastermind representa operações de grande escala com planeamento em várias fases.

• Leilão da Meia-Noite — organização nível 10;
• Reserva do Estuário — nível 25;
• Nó Soberano — nível 40;
• Cofre do Freeport — nível 55;
• Bolsa do Consórcio — nível 70;
• Arquivo Soberano — nível 85;
• Operação SUBMUNDO — capstone de nível 100.

1. Reconhecimento.
2. Criação do plano.
3. Seleção da equipa.
4. Seleção do veículo de fuga.
5. Escolha de abordagem.
6. Escolha do recetor.
7. Preparações obrigatórias.
8. Preparações opcionais.
9. Lançamento do final.
10. Complicação dinâmica.
11. Recolha do resultado.

• Silencioso;
• Infiltração;
• Choque;
• Fantasma;
• Distribuído.

Dez estatutos: Planeador, Coordenador, Arquiteto, Mastermind, Estratega, Diretor, Soberano, Arquiteto Nacional, Lenda e SUBMUNDO.

Também inclui:

• XP separado;
• percentagem configurável para a equipa;
• lista de prontidão;
• alvo em cooldown;
• recompensas rivais;
• caçadores;
• caches de sinal territoriais;
• mercado negro;
• oito mercadorias, desde Microchips Selados até Chaves Soberanas;
• preços dinâmicos em janelas de 15 minutos.

O frontend funciona como um cockpit tático sobre o mapa.

• Ctrl/Cmd + K abre pesquisa global;
• / também pode abrir pesquisa;
• pesquisa tolerante a acentos e termos parciais;
• navegação por teclado;
• histórico de comandos;
• pesquisa de equipas, operacionais, veículos, imóveis, armas e oportunidades;
• ações rápidas;
• navegação direta para painéis.

Os painéis principais suportam atalhos numéricos 1–9.

• sincronização manual;
• último painel memorizado;
• deep links via ?panel=;
• exportação CSV de transações;
• briefing operacional copiável;
• descanso em massa;
• abastecimento em massa;
• reparações em massa;
• recolha de recompensas em massa;
• otimização global da organização;
• avisos de dados desatualizados;
• notificações desktop opcionais;
• focus mode;
• HUD compacto;
• perfil de alto contraste;
• redução de movimento.

A loja usa dinheiro do jogo e inclui:

• aceleração de temporizadores;
• cosméticos;
• VIP;
• slots extra;
• pinturas de veículos;
• emblemas de equipa;
• skins do QG.

Não existe dependência de pagamentos reais no fluxo documentado do projeto.

A camada policial é uma simulação própria integrada no mapa e nas missões.

• PSP em centros urbanos configurados;
• GNR como força territorial/rural por omissão;
• zonas de patrulhamento ligadas aos ativos do jogador;
• diferentes raios, densidade e resposta;
• viaturas no mapa;
• reforços;
• deteção;
• perseguição;
• interceção;
• resposta dependente da força competente;
• pressão crescente com o calor.

A configuração atual inclui centros PSP em várias cidades portuguesas, entre elas Lisboa, Porto, Braga, Coimbra, Faro, Setúbal, Aveiro, Viseu, Leiria, Évora, Santarém, Funchal e Ponta Delgada.

As operações podem ser acompanhadas numa Câmara da Operação.

O sistema interior é executado no frontend e inclui:

• geração procedural de edifícios;
• plantas/blueprints;
• segmentos e obstáculos;
• pathfinding A*;
• NPCs;
• atribuição de papéis com base no roster real;
• fases interiores sincronizadas com os timestamps da missão;
• aproximação, entrada, progressão, execução, retirada e saída;
• diálogo/rádio contextual;
• simulação destruída quando a operação termina ou o overlay é fechado.

Existe painel para administradores/moderadores com:

• dashboard;
• lista de utilizadores;
• detalhe de utilizador;
• estatísticas do servidor;
• logs;
• concessão de recursos;
• reset de progresso;
• ban/unban;
• gestão de roles;
• grant/revoke de admin.

Moderadores têm acesso de leitura às áreas previstas; mutações administrativas exigem role de administrador.

Rotas e páginas para:

• Termos de Serviço;
• Política de Privacidade;
• RGPD;
• Changelog;
• disclaimer ficcional.

A aceitação do disclaimer é auditada no backend com versão e registo temporal.

┌────────────────────────────────────────────────────────────────┐
│                        Browser / Mobile Web                    │
│  React 19 · CRACO · Tailwind · React Router · Leaflet         │
└──────────────────────────────┬─────────────────────────────────┘
                               │ HTTPS / REST
                               ▼
┌────────────────────────────────────────────────────────────────┐
│                          FastAPI                               │
│ Auth · Game · Organization · City · Mastermind · Admin · Legal│
│ Engine · Economy Director · Quests · World · City · Live Ops  │
└──────────────────────────────┬─────────────────────────────────┘
                               │ Motor/PyMongo
                               ▼
┌────────────────────────────────────────────────────────────────┐
│                           MongoDB 7                            │
│ users · players · teams · employees · vehicles · missions ... │
└────────────────────────────────────────────────────────────────┘

Produção:
Internet → Caddy → React estático
                 └→ /api/* → FastAPI → MongoDB

O backend usa um tick lazy: o estado avança durante leituras/ações relevantes em vez de depender de um game loop permanente para tudo. Entre outras coisas, o motor trata de spawn, expiração, progresso de missões, calor, RH, economia e eventos persistentes.

O tick é serializado por jogador através de uma lease atómica, para que polling concorrente em várias tabs/dispositivos não duplique rendimento, salários, raids ou automações. A recuperação offline usa uma janela única de 28 dias tanto para produção como para custos fixos. Rotas resolvidas no despacho ficam persistidas e são tratadas como geometria canónica da missão.

A progressão 1–100 usa um contrato de desbloqueios versionado: alterar preços ou recompensas não desloca silenciosamente conteúdo entre níveis. Operações, quests, Mastermind e temporadas passam ainda pelo economy_director.py, que aplica guardrails globais contra multiplicadores ou farms que escapem ao balanceamento normal.

• React 19
• React DOM 19
• React Router 7
• CRACO / react-scripts
• Tailwind CSS
• Radix UI
• React Leaflet / Leaflet
• TanStack Query
• Axios
• Framer Motion
• Sonner
• Recharts
• React Hook Form
• Zod
• Lucide React

• Python
• FastAPI 0.110
• Uvicorn
• Motor
• PyMongo
• Pydantic
• PyJWT
• bcrypt
• HTTPX
• python-dotenv

• MongoDB 7
• Docker / Docker Compose
• Caddy
• Let's Encrypt
• GitHub Actions
• GitHub Pages
• Autoheal container
• health checks
• volumes persistentes
• script de backup MongoDB

O BrowserRouter usa process.env.PUBLIC_URL, permitindo funcionar corretamente em /LusoraeCrime no GitHub Pages.

A API é organizada por domínio.

• POST /register
• POST /check-availability
• POST /login
• POST /logout
• GET /me
• POST /claim-admin
• POST /change-password
• POST /delete-account
• POST /refresh

Estado e operações

• GET /catalog
• GET /state
• POST /dispatch/preview
• POST /dispatch
• POST /dispatch/recommend_opportunity
• POST /dispatch/recommend_team
• POST /dispatch/recommend_repeat
• POST /opportunities/favorite
• POST /missions/recall

Equipas e RH

• POST /teams/create
• POST /employees/recruit
• POST /recruitment/refresh
• POST /employees/assign
• POST /employees/train
• POST /employees/rest
• POST /employees/promote
• POST /employees/bonus
• POST /employees/heal
• POST /employees/release
• POST /employees/fire
• POST /employees/rename
• POST /employees/optimize

Frota

• POST /vehicles/buy
• POST /vehicles/sell
• POST /vehicles/refuel
• POST /vehicles/repair
• POST /vehicles/assign
• POST /vehicles/transfer
• POST /vehicles/rename
• POST /vehicles/optimize

Armamento

• POST /weapons/buy
• POST /weapons/sell
• POST /weapons/repair
• POST /weapons/assign
• POST /weapons/unassign
• POST /weapons/auto_assign
• POST /weapons/optimize

Imóveis e QG

• POST /properties/buy
• POST /properties/sell
• POST /properties/upgrade
• POST /properties/rename
• POST /properties/optimize
• POST /hq/validate
• POST /hq/place
• POST /hq/upgrade
• POST /hq/priority

Economia, quests e loja

• POST /police/bribe
• POST /launder
• GET /transactions
• POST /settings
• POST /quests/claim
• POST /quests/claim_all
• POST /quests/choose
• POST /shop/speedup
• POST /shop/buy_slot
• POST /shop/vip
• POST /shop/cosmetic
• POST /vehicles/equip_paint
• POST /teams/equip_emblem
• POST /hq/equip_skin

• GET /catalog
• GET /finance/summary
• POST /inventory/buy
• POST /inventory/sell
• POST /teams/rename
• POST /teams/doctrine
• POST /teams/policies
• POST /teams/loadout
• POST /teams/dissolve
• POST /weapons/reload
• POST /weapons/upgrade
• POST /vehicles/service
• POST /vehicles/tires
• POST /vehicles/insurance
• POST /vehicles/inspection
• GET /vehicles/{vehicle_id}/lifecycle
• POST /properties/module
• POST /properties/staff
• POST /departments/upgrade
• POST /territories/claim
• POST /territories/consolidate
• POST /territories/defend
• POST /prestige/buy
• POST /governance/protection

Todas as mutações deste router aceitam request_id e usam recibos idempotentes com TTL para impedir cobrança duplicada em retries de rede.

• GET /state
• POST /heists/intel
• POST /heists/create
• POST /heists/prep/start
• POST /heists/prep/claim
• POST /heists/launch
• POST /heists/claim
• POST /heists/abort
• POST /market/trade
• POST /bounty
• POST /cache/scan

• GET /dashboard
• GET /users
• GET /user/{user_id}
• POST /user/{user_id}/grant-resources
• POST /user/{user_id}/reset-progress
• POST /user/{user_id}/ban
• POST /user/{user_id}/unban
• POST /user/{user_id}/role
• POST /user/{user_id}/grant-admin
• POST /user/{user_id}/revoke-admin
• GET /logs
• GET /server-stats

• GET /meta
• GET /documents/{doc_id}
• GET /changelog
• POST /disclaimer-ack

• Node.js 20+
• Yarn 1.22
• Python 3.11+ recomendado
• MongoDB

Cria backend/.env com valores teus:

MONGO_URL=mongodb://localhost:27017
DB_NAME=submundo
JWT_SECRET=trocar-por-um-segredo-forte
CORS_ORIGINS=http://localhost:3000
ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=trocar-esta-password

Depois:

cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn server:app --host 0.0.0.0 --port 8001 --reload

cd frontend
yarn install
REACT_APP_BACKEND_URL=http://localhost:8001 yarn start

Para mostrar a autenticação localmente, não definas REACT_APP_AUTH_UI_ENABLED=false.

O workflow .github/workflows/pages.yml:

1. corre em pushes para main que alterem frontend/workflow;
2. instala Node 20;
3. instala dependências com yarn install --frozen-lockfile;
4. faz build de produção;
5. gera fallback SPA em 404.html;
6. adiciona .nojekyll;
7. envia o artefacto;
8. publica com actions/deploy-pages.

A pasta deploy/ contém:

• docker-compose.yml;
• Dockerfile do frontend;
• Dockerfile do backend;
• Caddyfile;
• setup para Ubuntu/VPS;
• auto-deploy;
• requirements de produção;
• backups do MongoDB.

Topologia:

Internet :80/:443
        │
        ▼
      Caddy
      ├── /        → React
      └── /api/*   → FastAPI
                       │
                       ▼
                    MongoDB

O Caddy trata de HTTPS automático e serve a SPA; o MongoDB não é exposto diretamente à Internet na configuração Docker fornecida.

Consulta deploy/HOSTINGER.md para o guia operacional completo.

O projeto já inclui várias medidas:

• hashing de passwords com bcrypt;
• JWT;
• access + refresh token;
• Bearer token no frontend;
• lockout após 5 tentativas falhadas;
• bloqueio durante 15 minutos;
• política mínima de password com 8 caracteres, maiúscula, minúscula e número;
• validação de email;
• validação de nome de organização;
• CORS explícito;
• roles admin e moderator;
• rotas administrativas separadas;
• refresh automático de sessão;
• timeout de pedidos no frontend;
• disclaimer auditado;
• MongoDB sem porta pública na stack Docker;
• headers de segurança no Caddy;
• health checks;
• autoheal;
• backups MongoDB.

Nunca colocar segredos, passwords, JWT secrets ou credenciais reais no README ou no código versionado.

SUBMUNDO/
├── .github/
│   └── workflows/
│       └── pages.yml
├── backend/
│   ├── auth.py
│   ├── server.py
│   ├── engine.py
│   ├── game_data.py
│   ├── economy_constants.py
│   ├── economic_simulator.py
│   ├── routes_game.py
│   ├── routes_city.py
│   ├── routes_organization.py
│   ├── organization_systems.py
│   ├── organization_intelligence.py
│   ├── organization_automation.py
│   ├── organization_events.py
│   ├── economy_director.py
│   ├── routes_mastermind.py
│   ├── routes_admin.py
│   ├── routes_legal.py
│   ├── quests.py
│   ├── quests_data.py
│   ├── city_data.py
│   ├── mastermind_data.py
│   ├── live_ops.py
│   ├── live_phrases.py
│   ├── world_gen.py
│   ├── geo.py
│   ├── geocode.py
│   └── data/
├── frontend/
│   ├── public/
│   └── src/
│       ├── components/
│       │   ├── game/
│       │   ├── legal/
│       │   └── ui/
│       ├── context/
│       ├── hooks/
│       ├── lib/
│       │   └── interior/
│       └── pages/
├── deploy/
│   ├── docker-compose.yml
│   ├── Caddyfile
│   ├── HOSTINGER.md
│   ├── backend/
│   ├── frontend/
│   └── scripts/
├── docs/
│   ├── GENERAL_IMPROVEMENTS_25.md
│   └── MASTERMIND_HEISTS_25.md
├── memory/
│   └── PRD.md
└── README.md

O repositório inclui:

• testes backend com pytest;
• testes específicos de autenticação Bearer/JWT;
• testes de disclaimer/legal;
• suites de regressão;
• relatórios em test_reports/;
• testes de API em backend_test.py;
• health check opcional no frontend;
• validações de build através do GitHub Actions.

Os relatórios versionados refletem execuções passadas; devem ser novamente executados após alterações relevantes antes de serem tratados como estado atual.

A identidade visual definida no projeto segue um tactical command-center HUD:

• fundo OLED preto/cinza;
• painéis glassmorphism;
• vermelho para ação/calor;
• verde para dinheiro limpo;
• âmbar para dinheiro sujo;
• azul/ciano para sistema;
• alta densidade de informação;
• mapa como elemento principal;
• tipografia mono para métricas e timers;
• animações com suporte a prefers-reduced-motion;
• foco em contraste e acessibilidade.

O changelog público do backend mantém a série formal:

• v0.1.0 — Temporada 0
• v0.2.0 — Frota e Império Imobiliário
• v0.3.0 — Funcionários
• v0.4.0 — Centro de Comando
• v0.5.0 — Cockpit Cinemático
• v0.6.0 — Autenticação AAA e Transparência Legal

A documentação técnica também contém pacotes posteriores, incluindo:

• 25 melhorias gerais — v1.2.0
• Cidade Viva — v1.3.0
• Mastermind — 25 mecânicas

Por isso, o número mostrado no changelog público e as versões dos pacotes de funcionalidades não devem ser interpretados como uma única versão SemVer global até existir uma política de release unificada.

O projeto está preparado para distribuição Android através de Capacitor 8, com package ID legado pt.lusorae.crime (mantido para compatibilidade de atualização na Google Play), target/compile SDK 36, minSdk 24 e pipeline GitHub Actions que gera um Android App Bundle de validação.

• Google Sign-In via Credential Manager / Social Login.
• Google ID token validado no backend antes da criação da sessão.
• Política de Privacidade pública: https://pulsebreakpt.github.io/LusoraeCrime/privacy.html
• Eliminação de conta fora da app: https://pulsebreakpt.github.io/LusoraeCrime/delete-account.html
• Eliminação dentro da app em Definições → Conta.
• Guia completo de release: docs/GOOGLE_PLAY_RELEASE.md
• Workflow Android: Android / Google Play readiness

A ativação efetiva do Google Sign-In requer configurar o Web OAuth Client ID e o Android OAuth Client no mesmo projeto Google Cloud, incluindo o SHA-1 do certificado de assinatura da Play Store.

Itens ainda documentados como evolução possível:

• jogadores e alianças visíveis diretamente no mapa;
• guerras PvP territoriais assíncronas com temporadas dedicadas;
• mercado entre organizações com ordens, contratos e reputação;
• árvore de tecnologia/investigação;
• polícia e investigações ainda mais profundas;
• eventos comunitários cooperativos de servidor;
• PWA/Capacitor para Android/iOS;
• modularização adicional de rotas e motor à medida que o projeto cresce.

Neste momento o repositório não contém um ficheiro LICENSE. Não assumas que o código pode ser redistribuído, sublicenciado ou reutilizado fora dos termos definidos pelo proprietário do repositório.

SUBMUNDO
Um império não se controla com um gatilho. Controla-se com informação, logística, dinheiro e decisões.