jiachenlong/README.md

# 甲辰藏品管理系统

**版本**: 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 - 系统字段

---

**开发团队**: 酷博特 + 菜鸟生产 🤖