RFG-03 — RFG-DTI v1.0
Dicionário de Dados
Camadas RAW, INPUT, SIGNAL, REALIZED e EVALUATED — a linguagem de dados comum da série documental.
1.Finalidade
Padronizar nomes, tipos, camadas, obrigatoriedade, acesso e versionamento dos dados do RFG-DTI v1.0.
2.Camadas de dados
| Camada | Função | Acesso |
|---|---|---|
| RAW | Dados originais de mercado | Interno |
| INPUT | Dados efetivamente usados na geração | Confidencial/Interno |
| SIGNAL | Saída RFG e timestamp | Interno/Público conforme divulgação |
| REALIZED | OHLC, intraday e classe realizada | Interno |
| EVALUATED | Hits, métricas e relatórios | Interno/Público conforme publicação |
3.Campos principais
| Campo | Camada | Obrigatório | Acesso |
|---|---|---|---|
| observation_id | todas | TRUE | Interno |
| asset | INPUT/SIGNAL | TRUE | Público |
| trade_date | SIGNAL | TRUE | Público |
| model_version | SIGNAL | TRUE | Público |
| signal_timestamp | SIGNAL | TRUE | Interno/Público |
| predicted_d1 | SIGNAL | TRUE | Público |
| predicted_d2 | SIGNAL | TRUE | Público |
| predicted_class | SIGNAL | TRUE | Público |
| open/high/low/close | REALIZED | TRUE | Público/Interno |
| realized_d1 | REALIZED | TRUE | Interno |
| realized_d2 | REALIZED | TRUE | Interno |
| realized_class | REALIZED | TRUE | Interno |
| hit_d1/hit_d2/hit_full | EVALUATED | TRUE | Interno/Público |
4.Convenção booleana
A única convenção booleana oficial é TRUE/FALSE. Valores 1/0 podem existir apenas em rotinas internas de cálculo, devendo ser convertidos para TRUE/FALSE na camada documental.
5.Versionamento
Todos os registros devem indicar RFG-DTI v1.0 quando pertencentes à versão original. Qualquer mudança material deverá produzir novo identificador de versão.
6.Campos reservados
Campos não existentes no algoritmo não deverão aparecer como se fossem variáveis reais. Quando houver necessidade de expansão futura, usar explicitamente a marcação RESERVED, sem inferir conteúdo.
7.Campos obrigatórios por camada
RAW: data/hora, fonte e valores originais. INPUT: observation_id, asset, input_date, source/version e campos efetivamente usados. SIGNAL: timestamp, versão, D1, D2 e classe. REALIZED: OHLC, intraday quando requerido, D1/D2 realizados. EVALUATED: hit_d1, hit_d2, hit_full, elegibilidade e motivo de exclusão quando aplicável.
8.Integridade
Dados originais não devem ser sobrescritos. Correções devem criar nova versão ou novo registro, preservando origem, responsável e timestamp.
9.Conclusão
O RFG-03 cria a linguagem de dados comum para toda a série documental e estabelece as camadas RAW, INPUT, SIGNAL, REALIZED e EVALUATED.
Como citar este documento
Desenvolvedor: Rodrigo Facundes Gonçalves.