Interface Eastmoney (eastmoney-api)
Fornece aos usuários do terminal quantitativo VAlpha obtenção de dados do mercado de ações A, troca automática entre múltiplas fontes de dados e proteção contra falhas (circuit breaker), com suporte a fallback para links Tushare/Akshare e configuração automática de limites de requisição com base na cota de crédito.
Pipeline
data_collection -> data_storage -> factor_computation -> target_selection -> trading_execution -> visualization
Principais Casos de Uso (26 no total)
Ponto de Entrada do Terminal VAlpha (UC-101)
Fornece ponto de entrada unificado para iniciar o servidor FastAPI ou executar análises pré/pós-mercado Gatilhos: start, server, run
Fábrica de Aplicação FastAPI (UC-102)
Cria e configura uma instância da aplicação FastAPI com CORS, roteadores e gerenciamento de ciclo de vida Gatilhos: application, fastapi, server
Serviço de Arquivos Estáticos e Roteamento SPA (UC-103)
Serve arquivos estáticos do frontend e implementa roteamento catch-each SPA para navegação no lado do cliente Gatilhos: static, frontend, spa
Para todos os 26 casos de uso, veja references/USE_CASES.md.
Gatilho de execução: Quando a intenção do usuário corresponder a intent_router.uc_entries[].positive_terms E o usuário usar um verbo de ação (run/execute/跑/执行/backtest/fetch/collect)
O que vou perguntar a você
- Mercado alvo: A-share (padrão), HK ou cripto? (Ações dos EUA no ZVT estão incompletas — stockus_nasdaq_AAPL existe, mas a cobertura é limitada)
- Fonte de dados / provedor: eastmoney (gratuito, sem conta), joinquant (conta + pago), baostock (gratuito, bom histórico), akshare ou qmt (corretora)?
- Tipo de estratégia: MACD golden-cross, cruzamento de MA, breakout de volume, seleção fundamental ou fator personalizado?
- Período de tempo: start_timestamp e end_timestamp para o período de backtest
- IDs das entidades alvo: ações específicas (stock_sh_600000) ou componentes de índice (SZ1000)?
Travas Semânticas (Fatais)
| ID | Regra | Em caso de violação |
|---|---|---|
SL-01 | Executar ordens de venda antes de ordens de compra em cada ciclo de negociação | parar |
SL-02 | Sinais de negociação DEVEM usar execução na próxima barra (sem look-ahead) | parar |
SL-03 | IDs de entidade DEVEM seguir o formato entity_type_exchange_code | parar |
SL-04 | O índice do DataFrame DEVE ser MultiIndex (entity_id, timestamp) | parar |
SL-05 | TradingSignal DEVE ter EXATAMENTE UM de: position_pct, order_money, order_amount | parar |
SL-06 | Semântica da coluna filter_result: True=COMPRAR, False=VENDER, None/NaN=SEM AÇÃO | parar |
SL-07 | Transformer DEVE ser executado ANTES do Accumulator no pipeline de fatores | parar |
SL-08 | Parâmetros MACD fixos: fast=12, slow=26, signal=9 | parar |
Definições completas das travas: references/LOCKS.md
Principais Anti-Padrões (14 no total)
AP-DATA-SOURCING-001: Cabeçalhos User-Agent ausentes ou inválidos para requisições à API da SECAP-DATA-SOURCING-002: Ignorar limites de taxa de APIs externas, causando bloqueio de IPAP-DATA-SOURCING-003: Nenhuma configuração de timeout HTTP, causando esperas indefinidas
Todos os 14 anti-padrões: references/ANTI_PATTERNS.md
Aviso de Qualidade da Evidência
[AVISO DE QUALIDADE] Este cristal foi compilado a partir do blueprint finance-bp-084. Taxa de verificação de evidências = 36,8% e total de falhas de auditoria = 26. Os resultados gerados podem conter lacunas de requisitos não capturadas. Verifique decisões críticas em relação aos arquivos fonte (LATEST.yaml / LATEST.jsonl).
Arquivos de Referência
| Arquivo | Conteúdo | Quando Carregar |
|---|---|---|
| references/seed.yaml | Fonte da verdade V6+ completa (source-of-truth) | Leitura obrigatória em caso de disputa de comportamento/decisão |
| references/ANTI_PATTERNS.md | 14 anti-padrões entre projetos | Antes de começar a implementação |
| references/WISDOM.md | Ideias valiosas entre projetos | Durante decisões arquiteturais |
| references/CONSTRAINTS.md | Restrições de domínio + fatais | Em caso de conflito de regras |
| references/USE_CASES.md | Cenários de negócio KUC-* completos | Quando precisar de exemplos completos |
| references/LOCKS.md | SL-* + pré-condições + dicas | Antes de gerar código de backtest/negociação |
| references/COMPONENTS.md | Mapa de componentes AST (dividido por módulo) | Ao consultar a API |
Compilado por Doramagic crystal-compilation-v6.1 a partir do blueprint finance-bp-084 em 2026-04-22T13:00:34.071788+00:00.
Veja human_summary.md para uma visão geral não técnica.