116 lines
2.1 KiB
Markdown
116 lines
2.1 KiB
Markdown
|
# 甲辰藏品管理系统
|
|||
|
|
|
|||
|
|
**版本**: v1.0.0
|
|||
|
|
**代号**: 新生
|
|||
|
|
**发布日期**: 2026-03-16
|
|||
|
|
|
|||
|
|
生肖纪念钞收藏管理系统 - 支持藏品管理、OCR 识别、统计分析等功能。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📁 项目结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
jiachenlong/
|
|||
|
|
├── backend/ # FastAPI 后端服务
|
|||
|
|
├── frontend/ # React 移动端前端
|
|||
|
|
├── static/ # 静态资源（图片、图标、字体）
|
|||
|
|
├── config/ # 配置文件
|
|||
|
|
├── docs/ # 文档
|
|||
|
|
├── scripts/ # 部署脚本
|
|||
|
|
└── README.md # 本文件
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🚀 快速开始
|
|||
|
|
|
|||
|
|
### 后端启动
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd backend
|
|||
|
|
|
|||
|
|
# 安装依赖
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
|
|||
|
|
# 配置环境变量（修改数据库密码等）
|
|||
|
|
vi .env
|
|||
|
|
|
|||
|
|
# 启动服务
|
|||
|
|
python -m uvicorn app.main:app --port 3000 --host 0.0.0.0
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 前端启动
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd frontend
|
|||
|
|
|
|||
|
|
# 安装依赖
|
|||
|
|
npm install
|
|||
|
|
|
|||
|
|
# 开发模式
|
|||
|
|
npm run dev
|
|||
|
|
|
|||
|
|
# 生产构建
|
|||
|
|
npm run build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 配置文件
|
|||
|
|
|
|||
|
|
所有配置文件在 `config/` 目录：
|
|||
|
|
|
|||
|
|
- `config/VERSION` - 版本号配置
|
|||
|
|
- `config/docker-compose.yml` - Docker 部署配置
|
|||
|
|
- `.gitignore` - Git 忽略配置（根目录）
|
|||
|
|
|
|||
|
|
### 静态资源
|
|||
|
|
|
|||
|
|
所有静态资源在 `static/` 目录：
|
|||
|
|
|
|||
|
|
- `static/images/` - 图片资源（Logo、背景图等）
|
|||
|
|
- `static/icons/` - 图标资源（favicon、应用图标等）
|
|||
|
|
- `static/fonts/` - 字体文件
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📋 文档
|
|||
|
|
|
|||
|
|
所有文档都在 `docs/` 目录下：
|
|||
|
|
|
|||
|
|
- `docs/DEPLOYMENT_v1.0.0.md` - 部署指南
|
|||
|
|
- `docs/RELEASE_v1.0.0.md` - 发布说明
|
|||
|
|
- `docs/ERROR_CODES.md` - 错误码
|
|||
|
|
- `docs/部署手册.md` - 完整部署手册
|
|||
|
|
- `docs/BACKEND_SERVICE_GUIDE.md` - 后端服务指南
|
|||
|
|
- `docs/TEST_REPORT.md` - 测试报告
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🛠️ 技术栈
|
|||
|
|
|
|||
|
|
**后端**:
|
|||
|
|
- FastAPI + SQLAlchemy
|
|||
|
|
- PostgreSQL
|
|||
|
|
- JWT 认证
|
|||
|
|
- DashScope OCR
|
|||
|
|
|
|||
|
|
**前端**:
|
|||
|
|
- React + Vite
|
|||
|
|
- 移动端适配
|
|||
|
|
- 暗色主题
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📊 核心功能
|
|||
|
|
|
|||
|
|
- ✅ 用户管理（管理员/普通用户）
|
|||
|
|
- ✅ 藏品管理（CRUD）
|
|||
|
|
- ✅ OCR 识别
|
|||
|
|
- ✅ 统计分析
|
|||
|
|
- ✅ 图片上传
|
|||
|
|
- ✅ 移动端适配
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**开发团队**: 酷博特 + 菜鸟小 D 🤖
|