30 lines
1.9 KiB
Markdown
30 lines
1.9 KiB
Markdown
---
|
||
title: 项目定位、技术栈与仓库结构
|
||
type: fact
|
||
permalink: main/projects/d44c219a-0b31-4de1-b160-323eb34a4c6a/项目定位、技术栈与仓库结构
|
||
stable_id: beb81aaa-8e86-4af7-a6c8-d35f7682d330
|
||
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:16.719564+00:00'
|
||
updated_at: '2026-09-23T15:08:16.719618+00:00'
|
||
tags:
|
||
- overview
|
||
- stack
|
||
- architecture
|
||
---
|
||
|
||
Artveris：面向艺术品行业的“一物一码、首次激活、多次查询”全生命周期溯源与认证平台（内部代号 artveris，与甲方品牌名解耦，品牌名走系统设置 appName）。商业闭源，单平台模式不做机构隔离。
|
||
|
||
三端一库：
|
||
- `apps/api` NestJS 11 + Prisma 5 + MySQL 8 + Redis + BullMQ（Express 5）；全局前缀 `/api`，Swagger `/api/docs`；生产单服务同端口托管 `/admin` `/trace` `/api` `/t/:code` `/uploads`。
|
||
- `apps/admin` Vue3 + Vite 6 + Naive UI + Pinia + vue-router(hash) + vue-i18n + ECharts 6；内含安装向导 `/install` 页。
|
||
- `apps/client` Vue3 + Vite 移动优先溯源页，路由 `/trace/:code` 与 `/trace/preview/:code`，PhotoSwipe v5。
|
||
- `packages/shared` 枚举/错误码/常量/类型/溯源模块契约，tsc 构建 CJS。
|
||
- `scripts/` Python：`dev.py`（本地）、`build.py`（非 Docker 发布包）、`build_docker.py`（离线 Docker 包）、`remote.py`（SSH Docker 部署）、`upgrade-remote.ps1`+`upgrade-remote-steps.sh`（宝塔一键升级）、`_lib.py`、`config.yaml`。
|
||
- `docker/` 仅 `Dockerfile.api` + `entrypoint.sh`。`docs/` 产品/技术/天河链集成说明/交接文档。
|
||
|
||
其他：图片 sharp、二维码 qrcode、表格 exceljs、ZIP archiver/unzipper、OSS 走 @aws-sdk S3 兼容；中英双语。开发直接连本机 MySQL/Redis（不用 Docker）。 |