--- kit_version: "1.0.0" doc_id: "UMAY-DOC-10" project_name: "UmayShop" module: "10" prepared_by: "示例编写角色" content_owner: "待指派" document_date: "2026-10-01" status: "example" language: "zh-CN" revision_id: "example-r1" source_revision_id: null translation_status: "not_requested" classification: "internal" reference_eligibility: "example_only" --- # UmayShop — 10. 数据库与数据模型 > **虚构示例**：下文用于演示填写方法，不是 UmayShop 的实际实现、权限、部署或批准结论。虚构样例不能进入正式参考资料。 定义数据模型、约束、关系和迁移证据，不将代码迁移视作生产已执行。 [返回总目录](../README.md) · [统一填写与核验规则](../AUTHORING-GUIDE.md) ## 目录 - [文档信息](#文档信息) - [适用范围与核验结论](#适用范围与核验结论) - [数据库用途与责任](#数据库用途与责任) - [实体与字段字典](#实体与字段字典) - [实体关系与一致性](#实体关系与一致性) - [数据流、来源与保留](#数据流-来源与保留) - [迁移、回填与回退](#迁移-回填与回退) - [备份恢复与数据质量](#备份恢复与数据质量) - [可视化图表](#可视化图表) - [来源、最终决策与代码核验](#来源-最终决策与代码核验) - [附件与图片资源](#附件与图片资源) - [人工维护区](#人工维护区) - [语言与下载检查](#语言与下载检查) - [修改历史](#修改历史) - [相关文档](#相关文档) ## 文档信息 | 字段 | 填写内容 | | --- | --- | | 内容负责人 / 确认人 | 待指派 / 未确认；编写人不是自动批准者 | | 技术负责人 / 目标期限 | 阿宗 / 2026-10-19；模板须经其确认后生效 | | 模板版本 / 当前状态 | 1.0.0 / example；未发布 | | 项目 / 编写人 | UmayShop / 示例编写角色 | | 适用版本 / 环境 | 示例数据集 r1 / 虚构测试环境 | | 代码仓库 / 采集分支 / 完整 SHA | 未取得真实快照；虚构样例不填假 SHA | | 最近确认时间 / 确认依据 | 未确认 / 未取得确认记录 | | 访问分级 | internal：内部；涉及受限信息时提高分级，继承源权限 | | 语言 / 原文修订 | zh-CN / example-r1；英文和俄文尚未生成 | ## 适用范围与核验结论 | 项目 | 结论 | | --- | --- | | 覆盖范围 | 定义数据模型、约束、关系和迁移证据，不将代码迁移视作生产已执行。 | | 采集排除项 | umay/cis-mep 及其全部子树不采集、不翻译、不导出、不计验收 | | 已验证范围 | 仅提供虚构填写示例，未核验私有代码 | | 已核验参考资料数量 | 0；本文未执行真实 Issue/源码核验 | | 证据可信程度 | 真实系统结论：低/未知；已确认需求范围：高（用户单一来源，非代码证明） | | 限制 / 缺口 | 需补最终决策、确认权限、精确 SHA、实现位置和验证记录；不把前端静态检查扩展为后端或生产结论 | ## 数据库用途与责任 > 填写说明：实例地址只引用目录 02；此处维护数据职责和版本。 | 库 / 模型 | 用途 | 技术 / 版本 | 环境引用 | 负责人 | 数据分级 | | --- | --- | --- | --- | --- | --- | | DB-DEMO | 订单与发运摘要 | 关系数据库示例，版本未定 | 目录 02 DB-NODE-DEMO | 示例数据角色 | 内部；个人数据另分级 | ## 实体与字段字典 > 填写说明：逐字段列类型、空值、默认、约束、索引、含义与来源；PII 指能识别个人的信息。 | 实体.字段 | 类型 / 可空 / 默认 | 约束 / 索引 | 含义 | 敏感性 | 证据 | | --- | --- | --- | --- | --- | --- | | OrderDemo.id | string / 否 / 无 | 主键 | 订单标识 | 内部 | EXAMPLE-E10 | | OrderDemo.customerRef | string / 否 / 无 | 仅引用示例身份 | 客户引用，不记录个人明文 | 受限引用 | EXAMPLE-E10 | | ShipmentDemo.orderId | string / 否 / 无 | 外键至 OrderDemo.id；索引 | 所属订单 | 内部 | EXAMPLE-E10 | | ShipmentDemo.status | string / 否 / CREATED | 示例状态枚举 | 物流状态，仓储状态单独记录 | 内部 | EXAMPLE-E10 | | ProcessedEventDemo.eventId | string / 否 / 无 | 唯一键 | 防止重复事件重复写入 | 内部 | EXAMPLE-E10 | | ShipmentDemo.id | string / 否 / 无 | 主键 | 发运标识 | 内部 | EXAMPLE-E10 | | ProcessedEventDemo.shipmentId | string / 否 / 无 | 外键至 ShipmentDemo.id | 事件所属发运记录 | 内部 | EXAMPLE-E10 | ## 实体关系与一致性 > 填写说明：标明一对多、外键是否真实存在、事务与最终一致边界。 | 起点 | 终点 | 关系 | 一致性保障 | 删除行为 | 证据 | | --- | --- | --- | --- | --- | --- | | OrderDemo | ShipmentDemo | 一对多示例 | 示例数据库外键 + 业务校验 | 有发运记录禁止直接删订单 | EXAMPLE-E10 | | ShipmentDemo | ProcessedEventDemo | 一对多事件示例 | 同一事务登记结果与去重键 | 按批准保留策略归档 | EXAMPLE-E10 | ## 数据流、来源与保留 > 填写说明：保留期不明确时填写未知；不要复制用户、手机号或地址作为样例。 | 数据 | 来源 | 使用方 | 保留期 / 删除规则 | 脱敏规则 | 负责人 | | --- | --- | --- | --- | --- | --- | | 订单摘要 | API-DEMO | 多端只读查询 | 待批准；本例不设实际期限 | 客户信息用引用 ID | 示例数据角色 | | 配送轨迹 | CARRIER-DEMO | 物流展示 | 待批准 | 隐藏收件人和精确地址 | 示例物流角色 | ## 迁移、回填与回退 > 填写说明：每次变更记录脚本版本、兼容、验证、运行记录与不可逆风险。 | 迁移 ID | 变化 | 前置 / 回填 | 应用兼容 | 运行证据 | 回退边界 | | --- | --- | --- | --- | --- | --- | | MIG-EX-01 | 增加事件去重记录 | 回填策略示例未定 | 新旧版本并存需验证 | 没有真实执行记录 | 未批准前不得删除已有列/数据 | ## 备份恢复与数据质量 > 填写说明：目标 RPO（允许丢失的时间范围）和 RTO（恢复时间上限）必须由演练支持。 | 检查 | 目标 | 证据 | 结果 | 缺口 | | --- | --- | --- | --- | --- | | 恢复演练 | RPO/RTO 待批准 | 无真实演练 | 未验证 | 提供备份与恢复记录 | | 重复 eventId | 唯一约束生效 | EXAMPLE-TEST-10 | 示例断言 | 需实际数据库验证 | ## 可视化图表 图表只表达已核验范围；每条关键连线应关联来源。当前为虚构示例，不证明真实部署。 ### 数据模型关系 ![数据模型关系（虚构示例）](../assets/data-model.svg) [可维护图源](../assets/data-model.mmd) · [独立图片](../assets/data-model.svg) ## 来源、最终决策与代码核验 **引入规则**：先确认“最终决定是什么”，再验证“目标版本实际做了什么”。Issue 关闭、最后一条评论、标题或“已处理”均不足以通过。同期只表示候选关联，不表示已实现。 | 证据 ID | 来源类型 / 定位 | 读取快照 / 时间 | 独立性与完整性 | 当前状态 | | --- | --- | --- | --- | --- | | EXAMPLE-E10 | 虚构需求说明 + 虚构代码线索 | 无真实快照 | 同一来源的转载不算独立来源；缺附件需标出 | example_only | | 决策 ID | Issue / 评论 ID / 时间 | 最终决定与适用范围 | 确认者及权限依据 | 替代/冲突记录 | 决策状态 | | --- | --- | --- | --- | --- | --- | | EXAMPLE-D10 | EXAMPLE-ISSUE / EXAMPLE-NOTE / 虚构时点 | 显示未知配送状态，不推定已交付（虚构） | 未取得真实有权确认记录 | 真实冲突未知 | unresolved | | 决策 ID | 仓库 / 分支 / 完整 SHA | 实现文件:行号 / 符号 | 测试或核验方法 / 结果 | 代码状态 / 范围 | 核验人 / 时间 | 差异与正式引入结论 | | --- | --- | --- | --- | --- | --- | --- | | EXAMPLE-D10 | 未取得，不使用假 SHA | 未取得真实实现位置 | 未执行真实核验 | unverified / 无 | 未核验 / 未确认 | 不得引入；补证后复核 | 决策状态：`unresolved`（未定）、`confirmed`（有效确认）、`superseded`（已被替代）。代码状态：`unverified`（未验证）、`partial`（仅部分）、`code_verified`（固定版本代码支持）、`runtime_verified`（目标环境实测支持）。**静态代码支持不等于生产运行通过。** 需要同时满足：决策已有效确认、无未解决冲突、相关代码覆盖完整、证据可定位、人工核验记录齐全，才可在其验证范围内列为正式参考。涉及部署、权限或外部服务真实行为的断言，另需对应环境的运行证据。旧决策保留为历史，不冒充当前规则。 | 缺口 ID | 缺失证据 | 影响 | 补充负责人 / 期限 | 解决条件 | | --- | --- | --- | --- | --- | | GAP-10-01 | 真实决策与代码快照 | 不能生成已核验业务结论 | 待指派 / 待确认 | 补齐并记录核验人、时间、范围与结果 | ## 附件与图片资源 | 资源 ID | 来源 / 权属 | 本地相对路径 | 完整性 / 读取状态 | 权限边界 | 语言处理 | | --- | --- | --- | --- | --- | --- | | data-model | 本包 tools/diagram_assets.py（本地图结构定义） | ../assets/data-model.svg + .mmd | 本地生成；XML 可校验 | internal / 无外部下载 | 图片内中文未译；当前只有中文图 | 附件应记录原文件 URL、文件名、内容校验值、读取时间与访问分级；不得保存访问令牌或带签名的临时 URL。链接可打开不等于正文已读。重定向到登录页、损坏、加密、扫描件未识别，均标记未读取。转换后的正文必须链接原件与图片，不覆盖原件。 ## 人工维护区 待填写：负责人确认的解释、例外和运维提示。后续自动更新须保留本区；与新证据冲突时提交差异，不能静默删除。本初始化脚本不会更新已有内容。 ## 语言与下载检查 | 检查项 | 当前状态 / 要求 | | --- | --- | | 中文原文 | 本页为中文；按 revision_id 固定修订 | | 英文 / 俄文 | 未生成。后续自动翻译绑定中文 source_revision_id；原文更新后旧译文标 stale（已过期） | | 内容结构 | 翻译保留标题层级、目录、表格、代码、链接、字段和数值；术语按项目词汇表 | | 图片与图内文字 | 原图和本地资源保留；图内中文单独重制或附译文说明，不把未译图算完整译文 | | Markdown 下载 | 含图片时以 Markdown + assets + 资源清单的 ZIP 下载；不得只提供失效的远程链接 | | PDF 下载 | 平台需实现分页、目录/书签、表格、中文/英文/俄文字体与本地图片嵌入；缺图应阻断完整成功 | | 导出与权限 | 绑定文档修订、语言、图像版本与模板版本；继承源权限，不公开受限内容 | | 本包能力边界 | 仅生成 Markdown 文档树与本地图源/SVG；不执行翻译、PDF 渲染、登录或平台发布 | ## 修改历史 | 修订 | 日期 | 编写人 | 变更 | 确认 / 依据 | | --- | --- | --- | --- | --- | | example-r1 | 2026-10-01 | 示例编写角色 | 初始化虚构示例 | 未确认 / 模板 1.0.0 | ## 相关文档 - [02. 基础设施、域名、IP及访问权限](../02-infrastructure/README.md) - [03. Backend / 后端服务](../03-backend/README.md) - [09. API / 接口与系统集成](../09-api-integrations/README.md) - [11. 安全与访问权限管理](../11-security-access/README.md) - [13. 部署与版本发布说明](../13-deployment-releases/README.md)