35 lines
2.9 KiB
Markdown
35 lines
2.9 KiB
Markdown
---
|
||
title: 关键代码地图
|
||
type: fact
|
||
permalink: main/projects/d44c219a-0b31-4de1-b160-323eb34a4c6a/关键代码地图
|
||
stable_id: dcdbeb7d-dd75-4294-8853-872491043db1
|
||
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:07:16.727937+00:00'
|
||
updated_at: '2026-09-23T15:07:16.728014+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`。 |