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

---

🚀 快速开始

后端启动

cd backend

# 安装依赖
pip install -r requirements.txt

# 配置环境变量（修改数据库密码等）
vi .env

# 启动服务
python -m uvicorn app.main:app --port 3000 --host 0.0.0.0

前端启动

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 - 系统字段

---

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