chore: 导入旧记忆备份供恢复

projects/d44c219a-0b31-4de1-b160-323eb34a4c6a/核心数据模型与业务流程.md

@@ -0,0 +1,31 @@
+---
+title: 核心数据模型与业务流程
+type: fact
+permalink: main/projects/d44c219a-0b31-4de1-b160-323eb34a4c6a/核心数据模型与业务流程
+stable_id: 7e83a02d-9eb6-4e97-9f23-102f34ae8b1e
+scope: project
+memory_type: fact
+project_id: d44c219a-0b31-4de1-b160-323eb34a4c6a
+usage_profile_id: 7aee455b-24cc-4008-bdaf-443721e6f939
+status: active
+revision: 1
+request_id: artveris-migrate-2026-09-03-fact-02
+created_at: '2026-09-03T03:36:11.667015+00:00'
+updated_at: '2026-09-03T03:36:11.667015+00:00'
+tags:
+- data-model
+- prisma
+- business-flow
+---
+
+模型三层：`Artwork（一款/一个档案）1:N Batch（批次）1:N TraceCode（每件实物）`，另 `Artwork 1:N TraceCode`。
+- `Artwork.archiveNo` 款级唯一档案编号，自动生成 `ARTVERIS-000001`；`TraceCode.shortCode` 件级唯一 12 位纯数字码 = 安全随机六码 + 全局流水六码（`trace_code_sequence` 单例原子分配 000001..999999，允许跳号不回收）；`serialNo` 与完整码分别唯一。无日期/Feistel/salt。
+- 旧概念“未绑定码池→绑定作品”、SKU、18 位完整码、码级 archiveNo 均已移除，文档残留仅作背景。
+- 审核：`Artwork.auditStatus`（PENDING/APPROVED/REJECTED）+ `ArtworkRevision` 快照（before/after）；新建默认 4 个时间轴骨架节点（创作/选胚、制作、仓储/托管、出库/流转）。
+- 作品内容字段：`images`（仅首屏轮播）、`showcaseImages`（JSON，作品展示图，最多 30）、`traceLayout`（JSON 模块布局）、`showOutboundTimeline`（默认 false）、动态字段（模板驱动）；`Template.defaultTraceLayout`。
+- 出库：`OutboundRecord`（1:1 TraceCode）+ `OutboundImage`（1:N）；批量任务 `Job` + `JobItem`（selectionKey+jobId 唯一）；上链 `BlockchainProof`（txHash/tokenId/contractAddress/dataHash）+ `OnchainChunk`（分片快照、operateId）。
+- 查询日志 `QueryLog`：IP/UA/浏览器/OS/结果/档案号/批次号，无地区字段（已移除）。
+- 系统设置 `system_setting` 键值表：EDITABLE_KEYS 白名单、SECRET_KEYS AES-256-GCM 加密（`enc:v1:`）、MASKED_KEYS 仅展示掩码。
+
+业务流：模板 → 建档（自动档案号）→ 审核 → 批量生码（批次+12 位码+二维码）→ 批量上链（可先于出库）/ 单件或批量登记出库（时间必填，实况图可后补）→ C 端展示/区块浏览器查验。消费者扫码：首次访问条件更新 INACTIVE→ACTIVE 激活计数=1，重复 +1，写查询日志；仅展示审核通过且未停用的作品。
+后台菜单：看板、溯源模板、艺术品档案（编辑详情 / 数据管理=批次与追溯码）、内容审核、追溯码管理、上链管理、出库管理、查询日志、操作日志、用户、系统设置（5 tab：平台/日志/区块链/存储/备份，URL `?tab=`）。