甲辰收藏系统 - 全量代码
Go to file
酷博特 06a0fa6440 v1.0.1 Logo 显示修复 + 图片代理修复
主要修复:
1. Logo 显示规范化 - 仅在登录页、首页显示,详情页显示'无图片'占位符
2. Nginx 图片代理修复 - 调整 location 优先级,/uploads 优先级最高
3. 后端图片数据加载 - get_collections() API 返回图片数据
4. 前端图片路径修复 - 直接使用 path 字段,避免路径重复

技术细节:
- Nginx location 优先级调整 (config/nginx.conf)
- 前端 Detail.jsx 图片路径和 onError 处理
- 后端 collections.py 图片数据加载
- 前端 Login.jsx/Home.jsx Logo 引用统一

影响范围:
-  藏品列表图片显示
-  藏品详情图片显示
-  图片预览弹窗
-  Logo 使用规范化

测试验证:
- 所有图片功能正常
- Logo 显示规范
- API 返回图片数据
2026-03-16 11:39:39 +08:00
backend v1.0.1 Logo 显示修复 + 图片代理修复 2026-03-16 11:39:39 +08:00
config v1.0.1 Logo 显示修复 + 图片代理修复 2026-03-16 11:39:39 +08:00
docs v1.0.1 Logo 显示修复 + 图片代理修复 2026-03-16 11:39:39 +08:00
frontend v1.0.1 Logo 显示修复 + 图片代理修复 2026-03-16 11:39:39 +08:00
scripts v1.0.1 Logo 显示修复 + 图片代理修复 2026-03-16 11:39:39 +08:00
static v1.0.1 Logo 显示修复 + 图片代理修复 2026-03-16 11:39:39 +08:00
.gitignore v1.0.1 Logo 显示修复 + 图片代理修复 2026-03-16 11:39:39 +08:00
README.md v1.0.1 Logo 显示修复 + 图片代理修复 2026-03-16 11:39:39 +08:00

README.md

甲辰藏品管理系统

版本: v1.0.0
代号: 新生
发布日期: 2026-03-16

生肖纪念钞收藏管理系统 - 支持藏品管理、OCR 识别、统计分析等功能。


📁 项目结构

jiachenlong/
├── backend/           # FastAPI 后端服务
├── frontend/          # React 移动端前端
├── static/            # 静态资源(图片、图标、字体)
├── config/            # 配置文件
├── docs/              # 文档
├── scripts/           # 部署脚本
└── README.md          # 本文件

🚀 快速开始

后端启动

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

配置文件

所有配置文件在 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 🤖