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

projects/d44c219a-0b31-4de1-b160-323eb34a4c6a/关键代码地图.md

@@ -0,0 +1,36 @@
+---
+title: 关键代码地图
+type: fact
+permalink: main/projects/d44c219a-0b31-4de1-b160-323eb34a4c6a/关键代码地图
+stable_id: dcdbeb7d-dd75-4294-8853-872491043db1
+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-03
+created_at: '2026-09-03T03:36:59.984242+00:00'
+updated_at: '2026-09-03T03:36:59.984242+00:00'
+tags:
+- code-map
+- navigation
+---
+
+apps/api/src/
+- `public-trace/` 公开溯源：trace（激活/计数/日志）+ preview（零副作用）+ `/t/:code` 302；`mapTraceLayout` 输出已审核布局（过滤隐藏模块、key→URL）。
+- `trace-code/` 生码/批次/分组/导出 ZIP/二维码/预览令牌；`trace-code-generator.service.ts` 随机六码+全局流水。
+- `artwork/` 建档+审核快照流（`applySnapshot`、`hasSnapshotChanged`），媒体归位 `relocateArtworkMedia`（含 `relocateTraceLayoutMedia`）。
+- `outbound/` OutboundRecord/OutboundImage、单件编辑、异步批量登记、图片分页、ZIP 高级导入（`outbound-import.util.ts` 边界）。
+- `blockchain/` `blockchain.service.ts`（动态 mock/tianhe）、`tianhe.provider.ts`（publish/confirm/registerUser/updateUserKey，带脱敏日志）、原生批量发行分片、UNKNOWN 恢复、`attestation.service.ts`。
+- `settings/` 动态配置中心、密钥加密/掩码/揭示（POST reveal 带审计）、天河身份注册/校验/轮换。
+- `storage/` Local/OSS(S3) 驱动、`relocateMedia` 归位、迁移/切换接口；`getUrl` key→URL。
+- `backup/` 创建/下载/恢复（预校验+自动快照+CAS）；`common/utils/preview-token.util.ts` 类 TOTP；`common/utils/bigint.util.ts` `parseBigId`。
+- `config/runtime-config.ts`（`envFilePath`/`preloadRuntimeEnv`/`isInstallMode`）、`install/`（安装向导写 .env+迁移+建超管）、`operation-log/`（写操作拦截器）、`certificate/`（水印队列）。
+- `assets/templates/outbound-import-template.zip` 静态导入模板。
+
+packages/shared/src/：`enums.ts`、`constants.ts`（`SHORT_CODE_LENGTH=12`、`TRACE_CODE_PATTERN`）、`error-codes.ts`、`response.ts`、`trace-modules.ts`（布局契约/校验/默认布局）。
+
+apps/admin/src/：`views/` Dashboard、Templates、Artworks/ArtworkEdit/ArtworkTraceCodes、TraceCodes、Onchain、OutboundManagement、Audit、QueryLogs、OperationLogs、Users、Settings、Install；`components/` TraceCodePanel、TraceCodeOperationTable、TraceModuleEditor（模板/作品共用，`templateMode`）、MediaUpload、MediaSorter、ArtworkShowcaseEditor、BackupRestorePanel；`composables/useTablePage.ts`、`utils/mediaUrl.ts`、`api/index.ts`。
+
+apps/client/src/：`views/Trace.vue` + `components/trace/TraceModuleRenderer.vue` 分发 9 个模块组件（Hero/Authenticity/ProductIntro/Showcase/Certificates/Timeline/Blockchain/ImageText/HorizontalGallery）+ `media.ts`；`composables/openMediaViewer.ts`。