zatca-phase-2-agent-integration

# ⚡ ZatcaOracle v2.0 **超快速ZATCA第二阶段电子发票引擎** ZatcaOracle是一款高性能的TLV编码和加密验证引擎，专为沙特阿拉伯的**ZATCA第二阶段（集成阶段）**而设计。该引擎基于**.NET 10 原生AOT**架构，通过**Zero-Shell 无依赖**容器部署，提供无与伦比的速度、安全性和绝对的数据驻留合规性。 --- ## 📊 企业性能指标 * **逻辑延迟：** 通过原生AOT验证，P99内部执行时间仅为**0.76毫秒**。 * **数据驻留：** 100%托管在**谷歌云（me-central2, Dammam, KSA）**，以严格遵守沙特网络安全法规。 * **吞吐量能力：** 每实例**3,300+ TPS**，可处理高流量计费周期。 * **资源密度：** 运行在最小的**11MB占用**，比行业平均值高效20倍。 * **安全加固：** **Zero-Shell 无依赖（Chiseled）**环境消除了95%的常见攻击面。 --- ## 📶 性能与网络架构 虽然我们的内部引擎在**<1毫秒**内执行，但用户通过RapidAPI Hub测试可能会看到平均往返时间（RTT）约为400毫秒。这是由于RapidAPI代理位于eu-west-1。 * **生产环境：** 需要真正**<10毫秒端到端延迟**的企业客户可以请求**直接访问**。这绕过了代理，直接命中我们的**基于Dammam的集群**，确保最大性能和符合沙特数据驻留法。 --- ## 🚀 集成路径 我们提供两条不同的路径，以确保无缝接入和高频生产扩展： ### 1. 神奇路径（零摩擦接入） 适用于初始测试和SME实施。传递原始证书，Oracle会自动提取**标签8（公钥）**和**标签9（签名）**。 * **执行时间：** 约1.2毫秒。 * **输入要求：** `certificate`字符串。 ### 2. 专业路径（高频生产） 专为企业规模设计。绕过提取逻辑，直接将缓存的标签传递给引擎。 * **执行时间：** **0.76毫秒**。 * **输入要求：** `publicKey`和`certificateStamp`字符串。 --- ## 🤖 AI代理集成（MCP） ZatcaOracle是**MCP原生**的。如果您正在使用**Cursor**、**Claude**或**GitHub Copilot**构建，请使用此提示自动集成： > *"读取位于`https://abdelghani-moussaid.github.io/zatca-phase-2-agent-integration/llms.txt`的API规范。实施一个服务，使用'神奇路径'提取公钥和证书戳，然后缓存这些值，以便在后续请求`/api/v1/generate`时使用'专业路径'。确保时间戳遵循No-Z规则。"* --- ## 🛡️ 严格验证与合规规则 为了避免**400 错误请求**并确保您的二维码根据官方ZATCA文档合法有效： 1. **15位增值税规则：** 卖方的增值税编号必须 exactly 为15个数字字符。 2. **No-Z规则（时间戳）：** 时间戳必须严格匹配`YYYY-MM-DDTHH:mm:ss`。**不要**包含'Z'（Zulu）后缀或时区偏移。 3. **签名验证：** `SIGNATURE_INVALID`错误表示哈希和公钥之间的加密不匹配。请交叉引用标签6、7和8。 --- ## 🔗 快速链接 * **[企业技术简介（PDF）](https://abdelghani-moussaid.github.io/zatca-phase-2-agent-integration/ZatcaOracle_v2.0_Enterprise_Technical_Brief.pdf)** * **[AI可读规范（llms.txt）](https://abdelghani-moussaid.github.io/zatca-phase-2-agent-integration/llms.txt)**