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

title, type, permalink, stable_id, scope, memory_type, project_id, usage_profile_id, status, revision, request_id, created_at, updated_at, tags

title	type	permalink	stable_id	scope	memory_type	project_id	usage_profile_id	status	revision	request_id	created_at	updated_at	tags
核心数据模型与业务流程	fact	main/projects/d44c219a-0b31-4de1-b160-323eb34a4c6a/核心数据模型与业务流程	7e83a02d-9eb6-4e97-9f23-102f34ae8b1e	project	fact	d44c219a-0b31-4de1-b160-323eb34a4c6a	7aee455b-24cc-4008-bdaf-443721e6f939	active	1	artveris-migrate-2026-09-03-fact-02	2026-09-03T03:36:11.667015+00:00	2026-09-03T03:36:11.667015+00:00	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=）。