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/关键代码地图	dcdbeb7d-dd75-4294-8853-872491043db1	project	fact	d44c219a-0b31-4de1-b160-323eb34a4c6a	7aee455b-24cc-4008-bdaf-443721e6f939	active	1	artveris-migrate-2026-09-03-fact-03	2026-09-03T03:36:59.984242+00:00	2026-09-03T03:36:59.984242+00:00	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。