142 lines
2.7 KiB
Markdown
142 lines
2.7 KiB
Markdown
# 甲辰藏品管理系统
|
||
|
||
**版本**: v1.1.22
|
||
**代号**: 新生
|
||
**发布日期**: 2026-03-20
|
||
|
||
生肖纪念钞收藏管理系统 - 支持藏品管理、OCR 识别、统计分析等功能。
|
||
|
||
---
|
||
|
||
## 📁 项目结构
|
||
|
||
```
|
||
jiachenlong/
|
||
├── backend/ # FastAPI 后端服务
|
||
├── frontend/ # React 移动端前端
|
||
├── static/ # 静态资源（图片、图标、字体）
|
||
├── config/ # 配置文件
|
||
├── docs/ # 文档
|
||
├── scripts/ # 部署脚本
|
||
└── README.md # 本文件
|
||
```
|
||
|
||
---
|
||
|
||
## 🖥️ 环境配置
|
||
|
||
### 生产环境 (A环境) - 已锁定
|
||
| 角色 | IP | 服务 |
|
||
|------|-----|------|
|
||
| 负载均衡/Nginx | 39.106.51.77 | Nginx反向代理 |
|
||
| 前端 | 8.154.46.3 | React静态页面 |
|
||
| 后端 | 42.121.116.25:3000 | FastAPI |
|
||
| 数据库 | 47.98.171.101 | PostgreSQL |
|
||
|
||
### 测试环境 (C环境)
|
||
| 角色 | IP | 服务 |
|
||
|------|-----|------|
|
||
| 前端 | 47.103.29.111 | Nginx + React |
|
||
| 后端 | 47.103.9.192:3000 | FastAPI |
|
||
| 数据库 | 本地 | PostgreSQL |
|
||
|
||
### 运维信息
|
||
- **负载均衡密码**: Jiachenlong123
|
||
- **C环境SSH密码**: Passwd1@3
|
||
- **Gitea仓库**: http://47.253.189.47:3000/coolbot/jiachenlong.git
|
||
|
||
---
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 后端启动
|
||
|
||
```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
|
||
```
|
||
|
||
### 部署流程
|
||
1. C环境测试 → B环境灰度 → A环境发布
|
||
2. 每次发布需更新 config/VERSION 文件
|
||
3. 提交代码到Gitea
|
||
|
||
---
|
||
|
||
## 📋 核心功能
|
||
|
||
- ✅ 用户管理（管理员/普通用户）
|
||
- ✅ 藏品管理（CRUD）
|
||
- ✅ OCR 识别（阿里云DashScope）
|
||
- ✅ 统计分析
|
||
- ✅ 图片上传（阿里云OSS）
|
||
- ✅ 移动端适配
|
||
- ✅ 操作日志记录
|
||
- ✅ 管理页面查看用户藏品
|
||
|
||
---
|
||
|
||
## 🔧 技术栈
|
||
|
||
**后端**:
|
||
- FastAPI + SQLAlchemy
|
||
- PostgreSQL 15+
|
||
- JWT 认证
|
||
- DashScope OCR (阿里云)
|
||
- 阿里云OSS存储
|
||
|
||
**前端**:
|
||
- React + Vite
|
||
- 移动端适配（PWA）
|
||
- 暗色主题
|
||
|
||
---
|
||
|
||
## 📊 数据库表
|
||
|
||
- `users` - 用户表
|
||
- `collections` - 藏品表
|
||
- `collection_images` - 藏品图片表
|
||
- `operations` - 操作日志表
|
||
- `custom_fields` - 自定义字段表
|
||
|
||
---
|
||
|
||
## 📝 字段命名规范
|
||
|
||
采用 fXX_XX_XXX 格式：
|
||
- f01 - 基本信息
|
||
- f02 - 详细字段
|
||
- f03 - 评级信息
|
||
- f04 - 特殊信息
|
||
- f05 - 价格信息
|
||
- f06 - 其他
|
||
- f99 - 系统字段
|
||
|
||
---
|
||
|
||
**开发团队**: 酷博特 + 菜鸟生产 🤖
|