30 lines
2.7 KiB
Markdown
30 lines
2.7 KiB
Markdown
---
|
||
title: 核心数据模型与业务流程
|
||
type: fact
|
||
permalink: main/projects/d44c219a-0b31-4de1-b160-323eb34a4c6a/核心数据模型与业务流程
|
||
stable_id: 7e83a02d-9eb6-4e97-9f23-102f34ae8b1e
|
||
scope: project
|
||
project_id: d44c219a-0b31-4de1-b160-323eb34a4c6a
|
||
memory_type: fact
|
||
status: active
|
||
revision: 1
|
||
restored_from_commit: 6a6a895eafcca6052e81a14fca103a42635dd1c2
|
||
created_at: '2026-09-23T15:08:02.229891+00:00'
|
||
updated_at: '2026-09-23T15:08:02.229956+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=`）。 |