SFRM - 轻量级贸易库销存与期货一体化管理系统

🎯 项目概述

SFRM (Spot and Futures Risk Management) 是一个专为单用户/小团队设计的轻量级期现业务管理系统，帮助大宗商品贸易从业者全流程管理期现套保/套利项目。

✨ 核心特性

• 🔄 一体化管理: 整合现货贸易与期货交易数据
• 📊 实时计算: 自动计算盈亏、对冲率、风险敞口等关键指标
• 📈 可视化分析: 基于ECharts的多维度图表展示
• ⚡ 轻量部署: 无需复杂配置，一键启动
• 🛡️ 风险预警: 智能监控系统风险指标
• 📋 Excel集成: 支持批量导入导出

🎬 业务场景

• 套保场景: 库存对冲、采购对冲风险
• 套利场景: 跨期、跨品种价差套利
• 期现结合: 现货与期货数据联动分析

🚀 快速开始

1. 系统验证

python verify_system.py

2. 启动系统 (推荐)

python RUN_ME.py

3. 其他启动方式

• Windows: 双击 start.bat
• Linux: ./start.sh
• 简化启动: python simple_start.py
• 独立启动: python standalone_start.py

3. 访问系统

• 前端地址: http://localhost:8080
• 后端API: http://localhost:8000
• API文档: http://localhost:8000/docs

4. 默认登录

• 用户名: admin
• 密码: admin123

📋 系统要求

• Python: 3.8+
• Node.js: 16+
• 内存: 2GB+
• 操作系统: Windows 10+ / Linux (Ubuntu 20.04+)

🏗️ 技术架构

后端技术栈

• 框架: FastAPI (Python)
• 数据库: SQLite (文件型数据库)
• 认证: JWT Token
• API文档: 自动生成的Swagger UI

前端技术栈

• 框架: Vue 3 + Composition API
• UI组件: Element Plus
• 图表库: ECharts
• 状态管理: Pinia
• 构建工具: Vue CLI

📁 项目结构

SFRM/
├── backend/                 # 后端代码
│   ├── api/                # API路由
│   │   ├── auth/          # 认证相关API
│   │   ├── projects/      # 项目管理API
│   │   ├── spot-contracts/ # 现货合同API
│   │   ├── futures-settlements/ # 期货结算API
│   │   └── analytics/     # 分析计算API
│   ├── models/            # 数据模型
│   ├── utils/             # 工具函数
│   ├── main.py           # 后端入口文件
│   └── requirements.txt   # Python依赖
├── frontend/              # 前端代码
│   ├── src/
│   │   ├── views/         # 页面组件
│   │   ├── components/    # 通用组件
│   │   ├── api/          # API调用
│   │   ├── utils/        # 工具函数
│   │   └── store/        # 状态管理
│   ├── public/           # 静态资源
│   └── package.json      # 前端依赖
├── data/                # 数据库文件
├── backup/              # 自动备份
├── docs/                # 文档
├── start.sh             # Linux启动脚本
├── start.bat            # Windows启动脚本
├── verify_system.py     # 系统验证脚本
├── test_system.py       # 功能测试脚本
└── README.md           # 项目说明

📖 核心功能

1. 项目管理

• 创建套保/套利项目
• 项目全生命周期管理
• 关联合同和期货单
• 实时指标计算

2. 现货合同管理

• 合同信息录入
• 履约状态跟踪
• 库存数量管理
• Excel批量导入

3. 期货结算单管理

• 期货交易记录
• 持仓盈亏计算
• 头寸汇总分析
• 到期预警提醒

4. 自动计算分析

• 盈亏实时计算
• 对冲率监控
• 风险敞口分析
• 压力测试模拟

5. 可视化仪表盘

• 多维度数据展示
• 盈亏趋势图表
• 风险预警面板
• 快速操作入口

🔧 管理命令

# 启动系统
./start.sh start      # Linux
start.bat             # Windows

# 查看状态
./start.sh status

# 停止服务
./start.sh stop

# 重启系统
./start.sh restart

# 仅安装依赖
./start.sh install

# 初始化数据库
./start.sh init

# 系统验证
python verify_system.py

# 功能测试
python test_system.py

📊 示例数据

系统内置完整的示例数据，包括：

• 套保项目: 螺纹钢库存对冲项目
• 套利项目: 铁矿石跨期套利项目
• 现货合同: 3个不同类型的采购合同
• 期货结算单: 4笔期货交易记录
• 交付记录: 完整的履约跟踪记录

📚 文档

• 快速开始指南 - 详细的使用说明
• API文档 - 完整的API接口文档
• 用户手册 - 功能使用教程

🔄 数据备份

系统自动进行数据备份：

• 备份时间: 每日23点
• 备份位置: backup/ 目录
• 保留策略: 最近30天
• 手动备份: 可随时手动备份数据库

⚠️ 注意事项

1. 端口占用: 确保8000和8080端口未被占用
2. 权限要求: Linux用户需要给start.sh添加执行权限
3. 网络连接: 首次运行需要网络下载依赖包
4. 数据安全: 定期备份重要数据

🆘 故障排除

常见问题

1. 端口被占用: 使用netstat查看并结束占用进程
2. 依赖安装失败: 更新pip或使用国内镜像源
3. 前端页面空白: 检查后端API是否正常
4. 数据库错误: 删除data目录重新初始化

日志查看

• 后端日志: backend/backend.log
• 前端日志: frontend/frontend.log

📈 版本信息

• 当前版本: v1.0.0
• 更新日期: 2025年10月
• 开发语言: Python 3.8+, Vue 3
• 数据库: SQLite

🤝 技术支持

如遇问题，请：

1. 查看快速开始指南和用户手册
2. 运行系统验证脚本检查完整性
3. 查看日志文件获取详细错误信息
4. 确认系统要求是否满足

---

SFRM - 轻量级贸易库销存与期货一体化管理系统 让期现业务管理更简单、更高效！

联系我们

• 邮箱: yl_zhangqiang@foxmail.com
• 微信: qianglegeng