Canonical Data Map

🗂️ 希腊会计系统的单一数据源规范

希腊会计系统的权威目录结构与命名规范参考文档,为所有OpenClaw希腊会计技能提供统一的数据路径标准和文件组织规范。

收藏
6k
安装
1.6k
版本
0.1.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用途

canonical-data-map 是 OpenClaw 希腊会计系统的单一数据源(Single Source of Truth),定义了完整的文件系统架构、目录结构、命名约定和数据格式标准。所有其他技能必须严格遵循此文档规定的路径和规范,禁止擅自引入新的顶级目录或偏离既定命名规则。

显著优点

1. 高度规范化:涵盖 16 个顶级目录(incoming, processing, clients, compliance, banking, ocr, efka, reports, exports, imports, dashboard, auth, backups, gdpr-exports, memory, system),每个目录都有明确的用途和子结构定义

2. 严格的命名标准

  • AFM 格式强制为 EL + 9 位数字(如 EL123456789)
  • 文件名采用 {AFM}_{YYYY-MM}_{type}_{detail}.{ext} 模式
  • 禁用希腊字符和空格,强制 ASCII 安全
  • 日期格式统一为 ISO 8601(存储)或 DD/MM/YYYY(显示)

3. 完善的版本管理:v1.1 新增 /data/memory/ 目录用于代理 episodic memory 和反馈循环

4. 明确的技能责任矩阵:清晰界定每个目录的写入所有者(Owner Skill)和读取权限

5. 强制性安全规范

  • 加密静态数据要求(AES-256-GCM)
  • GDPR 合规的数据分类标签
  • 10 年审计日志保留期
  • 统一的审计事件 Schema

潜在局限

  • 刚性约束:过于严格的规范可能限制边缘场景的灵活性
  • 版本同步成本:任何目录结构调整都需要更新此文档版本
  • 遗留路径兼容:存在大量 deprecated 路径需要维护别名映射
  • 本地化限制:专为希腊会计系统设计,不适用于其他司法管辖区

适合人群

  • 开发 OpenClaw 希腊会计系统的技能开发者
  • 需要理解数据流向的系统架构师
  • 审计合规团队进行技术审查
  • 实施 Greek Accounting 工作流的 DevOps 工程师

常规风险

1. 数据泄漏风险compliance/clients/efka/ 包含敏感 PII 和财务数据,必须加密
2. 处理数据污染/data/processing/ 为临时空间,禁止作为最终数据源引用

3. 命名违规导致故障:AFM 格式错误或希腊字符入文件名可能引发下游技能错误

4. 权限越界:非 Owner Skill 写入受保护目录(如 client-data-management 独占的 clients/

5. 审计缺失:未按统一 Schema 记录审计事件可能导致合规缺口

Canonical Data Map 内容

手动下载zip · 14.5 kB
skill-card.mdtext/markdown
请选择文件