Referência de API
Documentação extraída por análise estática (ast) de 67 módulos Python (12831 linhas) do pacote persona_db. Assinaturas, docstrings e links para o código-fonte são regenerados a cada build.
:::note Como regenerar
cd website && npm run gen:docs
:::
Pacotes
| Pacote | Módulos | Linhas | Descrição |
|---|---|---|---|
persona_db/engines/ | 10 | 1386 | Motores matemáticos e probabilísticos. |
persona_db/generators/ | 25 | 6492 | Geradores por domínio do schema. |
persona_db/validators/ | 8 | 1318 | Validadores de consistência do dataset. |
persona_db/scripts/ | 6 | 984 | CLIs de geração, carga, exportação e documentação. |
persona_db/seeds/ | 3 | 1138 | Catálogos determinísticos e tabelas de probabilidade. |
persona_db/tests/ | 15 | 1513 | Suíte de testes unitários, de integração e estatísticos. |
Todos os módulos
| Módulo | Resumo |
|---|---|
persona_db.engines.__init__ | PersonaDB engines package. |
persona_db.engines.constants | Shared constants and anchors for all engines. |
persona_db.engines.criminal | Motor criminal e jurídico — envolvimento, impacto e reincidência. |
persona_db.engines.family | Relacionamentos, família e fecundidade — engine probabilístico. |
persona_db.engines.genetics | Genetic trait inheritance engine. |
persona_db.engines.geography | Geografia ficcional: cidades, bairros e mobilidade espacial. |
persona_db.engines.health | Health engine — survival, diagnoses, chronic impact, mental risk. |
persona_db.engines.rng | Deterministic seeded RNG wrapper for all PersonaDB engines. |
persona_db.engines.root | Root bootstrap shared by trainers and generators. |
persona_db.engines.socio | Socioeconomic engine — social class, education, salary, family influence. |
persona_db.generators.__init__ | Geradores de domínio do PersonaDB (gen_00 a gen_23). |
persona_db.generators.gen_00_pessoa | gen_00_pessoa — gera a persona base (tabela pessoa, domínio 00). |
persona_db.generators.gen_01_identidade | gen_01_identidade — domínio 01: documentos, biometria, fenótipos, idiomas. |
persona_db.generators.gen_02_genealogia | gen_02_genealogia — domínio 02: família, parentesco, herança e ancestralidade. |
persona_db.generators.gen_03_saude | gen_03_saude — domínio 03: saúde. |
persona_db.generators.gen_04_educacao | gen_04_educacao — domínio 04: trajetória educacional, notas, bolsas e estágios. |
persona_db.generators.gen_05_carreira | gen_05_carreira — domínio 05: empresas, cargos, contratos, salários e carreira. |
persona_db.generators.gen_06_financas | gen_06_financas — domínio 06: contas bancárias, transações, investimentos e patrimônio. |
persona_db.generators.gen_07_residencia | gen_07_residencia — domínio 07: endereços, residências, condomínios, aluguéis e vizinhos. |
persona_db.generators.gen_08_relacionamentos | gen_08_relacionamentos — domínio 08: relacionamentos afetivos, casamentos, divórcios e filhos. |
persona_db.generators.gen_09_rede_social | gen_09_rede_social — domínio 09: amizades simétricas, grupos sociais, eventos e clubes. |
persona_db.generators.gen_10_digital | gen_10_digital — domínio 10: dispositivos, contas digitais, redes sociais e streaming. |
persona_db.generators.gen_11_juridico | gen_11_juridico — domínio 11: processos judiciais, ocorrências, sentenças e antecedentes. |
persona_db.generators.gen_12_eleitoral | gen_12_eleitoral — domínio 12: partidos, eleições, candidaturas, filiações e votos. |
persona_db.generators.gen_13_viagens | gen_13_viagens — domínio 13: destinos, viagens, hospedagens, passagens e documentos de viagem. |
persona_db.generators.gen_14_pets | gen_14_pets — domínio 14: animais de estimação, raças, clínicas veterinárias e vacinação. |
persona_db.generators.gen_15_consumo | gen_15_consumo — domínio 15: produtos, lojas, compras, avaliações e fidelidade. |
persona_db.generators.gen_16_timeline | gen_16_timeline — domínio 16: consolidação da linha do tempo, marcos pessoais e luto. |
persona_db.generators.gen_17_comportamento | gen_17_comportamento — domínio 17: personalidade Big Five, hábitos, rotina e estilo de aprendizagem. |
persona_db.generators.gen_18_religiao | gen_18_religiao — domínio 18: crenças, instituições religiosas, rituais, conversões e dízimos. |
persona_db.generators.gen_19_esporte | gen_19_esporte — domínio 19: esportes praticados, clubes esportivos, competições e hobbies. |
persona_db.generators.gen_20_militar | gen_20_militar — domínio 20: alistamento militar obrigatório, incorporação, patentes e baixas. |
persona_db.generators.gen_21_imigracao | gen_21_imigracao — domínio 21: vistos, naturalizações, residências permanentes e travessias. |
persona_db.generators.gen_22_comunicacao | gen_22_comunicacao — domínio 22: telefones, e-mails únicos, correspondências e registros de comunicação. |
persona_db.generators.gen_23_midia | gen_23_midia — domínio 23: notícias, menções na mídia, prêmios, entrevistas e reputação. |
persona_db.scripts.__init__ | Command-line entry points for generating and exporting PersonaDB data. |
persona_db.scripts.benchmark | Small reproducible benchmark for the in-memory generation pipeline. |
persona_db.scripts.bulk_insert | Stream JSON table rows into PostgreSQL using bounded insert batches. |
persona_db.scripts.document_schema | Gera documentação Markdown (docs/SCHEMA.md) do schema PostgreSQL do PersonaDB (TASK-100). |
persona_db.scripts.export | Export a generated JSON dataset to portable archive formats. |
persona_db.scripts.generate | Orchestrator CLI para geração determinística em lote do PersonaDB (TASK-040 / TASK-080). |
persona_db.seeds.__init__ | Reference seed data package. |
persona_db.seeds.lookup_data | Dados estáticos de referência: nomes, cidades, profissões, etc. |
persona_db.seeds.probability_tables | Tabelas de probabilidade calibradas usadas pelos motores. |
persona_db.tests.__init__ | Test package for PersonaDB. |
persona_db.tests.integration.test_full_generation | Teste de integração completo do pipeline de 25 domínios (TASK-094). |
persona_db.tests.integration.test_pipeline | — |
persona_db.tests.statistical.__init__ | Testes de aderência estatística do PersonaDB. |
persona_db.tests.statistical.test_distributions | Testes de aderência estatística para N = 1000 personas (TASK-095). |
persona_db.tests.unit.test_base_engines | Unit tests for Agent 2 engines: rng, socio, health. |
persona_db.tests.unit.test_criminal | Testes do Agent 4: motor criminal. |
persona_db.tests.unit.test_exports | — |
persona_db.tests.unit.test_genetics | Testes unitários do motor genético GeneticEngine (TASK-091). |
persona_db.tests.unit.test_genetics_family_geo | Testes do Agent 3: genetics, family e geography engines. |
persona_db.tests.unit.test_health_criminal_family | Testes unitários combinados para HealthEngine, CriminalEngine e FamilyEngine (TASK-093). |
persona_db.tests.unit.test_review_regressions | Regression coverage for generator, validator and schema review findings. |
persona_db.tests.unit.test_rng | Testes unitários do motor de aleatoriedade determinística SeededRNG (TASK-090). |
persona_db.tests.unit.test_socio | Testes unitários do motor socioeconômico SocioeconomicEngine e histórico salarial (TASK-092). |
persona_db.tests.unit.test_validators | Testes unitários dos 6 validadores de domínio e CLIs (TASK-070 a TASK-076). |
persona_db.validators.__init__ | Módulos de validação de consistência do PersonaDB. |
persona_db.validators.run_validators | Runner de validação de consistência do PersonaDB (TASK-076). |
persona_db.validators.val_financas | val_financas — validador de consistência financeira e patrimonial (TASK-072). |
persona_db.validators.val_genealogia | val_genealogia — validador de consistência genealógica e genética (TASK-070). |
persona_db.validators.val_juridico | val_juridico — validador de consistência jurídica, penal e eleitoral (TASK-074). |
persona_db.validators.val_saude | val_saude — validador de consistência médica, hospitalar e fisiológica (TASK-073). |
persona_db.validators.val_social | val_social — validador de consistência social e relacional (TASK-075). |
persona_db.validators.val_temporal | val_temporal — validador de consistência temporal transversal (TASK-071). |