//! # XTZH AI汇率定价模型系统
//!
//! XTZH AI汇率定价模型是NAC公链的核心价值稳定机制，通过双层嵌套注意力机制
//! 实现基于50维宏观状态向量的汇率预测。系统采用可验证计算架构，确保链上
//! 汇率的可信性与透明性。
//!
//! ## 架构层级
//!
//! 本模块属于NAC四层架构中的**L1协议层（Protocol Layer）**，与NVM、CBPP、
//! ACC-20等核心协议处于同一层级。
//!
//! ## 核心模块
//!
//! - [`data`]: 数据工程层 - 50维宏观状态向量的采集、清洗、对齐、标准化
//! - [`model`]: AI模型层 - 双层嵌套注意力机制的汇率预测模型
//! - [`training`]: 训练系统 - 模型训练、验证与评估
//! - [`export`]: ONNX导出 - 模型导出为ONNX格式，支持zkML编译与TEE部署
//! - [`oracle`]: 预言机集成 - 混合预言机网络，提供可验证的汇率数据
//!
//! ## 设计原则
//!
//! 遵循NAC记忆系统中的核心原则：
//!
//! - **ARCH_001**: 四层架构体系（本模块属于L1协议层）
//! - **ARCH_003**: Blake3哈希统一（所有哈希计算使用Blake3）
//! - **ARCH_004**: 代码保留原则（永远不要删除代码）
//! - **ARCH_005**: NAC原生设计（不模仿任何其他公链）
//! - **ARCH_006**: 测试驱动开发（单元测试覆盖率 > 80%）
//!
//! ## 快速开始
//!
//! ```rust,no_run
//! use xtzh_ai::model::XTZHModel;
//! use xtzh_ai::data::MacroFeatures;
//!
//! # async fn example() -> Result<(), Box<dyn std::error::Error>> {
//! // 1. 加载模型
//! let model = XTZHModel::load("xtzh_model_v1.0.onnx")?;
//!
//! // 2. 准备50维宏观特征
//! let features = MacroFeatures::fetch_latest().await?;
//!
//! // 3. 执行推理
//! let result = model.infer(&features)?;
//!
//! println!("XTZH汇率: {} SDR", result.rate_sdr);
//! println!("货币层权重: {}%", result.w_fx / 100.0);
//! println!("黄金层权重: {}%", result.w_au / 100.0);
//! println!("商品层权重: {}%", result.w_com / 100.0);
//! # Ok(())
//! # }
//! ```
//!
//! ## 性能指标
//!
//! | 指标 | 目标 |
//! |------|------|
//! | 宏观预测R² | ≥ 0.65 |
//! | 模型推理时间 | < 100ms |
//! | ZK证明生成时间 | < 10秒 |
//! | TEE推理时间 | < 500ms |
//! | 单元测试覆盖率 | > 80% |

#![deny(missing_docs)]
#![deny(unsafe_code)]
#![warn(clippy::all)]

// ============================================================================
// 公开模块
// ============================================================================

/// 数据工程层 - 50维宏观状态向量的采集、清洗、对齐、标准化
pub mod data;

/// AI模型层 - 双层嵌套注意力机制的汇率预测模型
pub mod model;

/// 训练系统 - 模型训练、验证与评估
pub mod training;

/// ONNX导出 - 模型导出为ONNX格式，支持zkML编译与TEE部署
// pub mod export;  // 将在Phase 6实现

/// 预言机集成 - 混合预言机网络，提供可验证的汇率数据
// pub mod oracle;  // 将在Phase 8实现

// ============================================================================
// 内部模块
// ============================================================================

/// 错误类型定义
mod error;

/// 常量定义
mod constants;

/// 工具函数
mod utils;

// ============================================================================
// 公开导出
// ============================================================================

pub use error::{Error, Result};
pub use constants::*;

// ============================================================================
// 版本信息
// ============================================================================

/// 模块版本
pub const VERSION: &str = env!("CARGO_PKG_VERSION");

/// 模块名称
pub const NAME: &str = env!("CARGO_PKG_NAME");

/// 模块描述
pub const DESCRIPTION: &str = env!("CARGO_PKG_DESCRIPTION");

// ============================================================================
// 测试
// ============================================================================

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_version() {
        assert_eq!(VERSION, "1.0.0");
    }

    #[test]
    fn test_name() {
        assert_eq!(NAME, "xtzh-ai");
    }

    #[test]
    fn test_description() {
        assert!(!DESCRIPTION.is_empty());
    }
}