O PersonaDB é um motor determinístico de geração de dados sintéticos e relacionais para personas fictícias brasileiras, cobrindo 25 domínios da vida humana (257 tabelas no PostgreSQL 16). Todos os registros são 100% fictícios e reproduzíveis a partir de uma única semente mestre (SeededRNG / PCG64 com derivação criptográfica BLAKE2b).
00_hub.sql a 26_metadata.sql).persona_db/engines/): RNG determinístico, mobilidade social, genética, saúde, família, geografia e criminalidade.persona_db/generators/) orquestrados em ordem topológica estrita.persona_db/validators/): genealogia, temporal, finanças, saúde, jurídico-eleitoral e social.# 1. Instalar pacote e dependências de desenvolvimento/Parquet
python3 -m pip install -e "persona_db[dev,parquet]"
# 2. Gerar um dataset sintético completo (257 tabelas) com validação automática
python3 -m persona_db.scripts.generate --personas 200 --seed 42 --output dataset.json --html-report report.html
# 3. Executar a suíte de validadores de consistência diretamente
python3 -m persona_db.validators.run_validators --personas 200 --seed 42
# 4. Rodar todos os testes (unitários, integração e estatísticos)
pytest persona_db/tests -v
Para o passo a passo completo, incluindo o fluxo com PostgreSQL via Docker Compose, consulte a documentação.