三类基台出入库系统

一个基于 Flask + SQLite 的现代化库存管理系统，专为三类基台的出入库管理而设计。

🚀 快速使用（打包版）

Windows 用户

1. 双击运行 build.py（推荐）或 build_windows.bat
2. 等待打包完成
3. 进入 dist\BaseStationSystem 目录
4. 双击 BaseStationSystem.exe 运行
5. 浏览器自动打开系统界面

Mac 用户

python3 build.py
cd dist/基台出入库系统
./基台出入库系统

功能特点

• 📊 数据看板 - 实时展示库存统计、出入库趋势、预警信息
• 📦 基台管理 - 管理基台信息，支持多种类型分类
• 📥 入库管理 - 记录入库操作，自动更新库存
• 📤 出库管理 - 记录出库操作，库存实时扣减
• ⚠️ 库存预警 - 低库存自动预警，支持快速入库
• 📝 操作日志 - 完整记录所有操作，便于追溯

技术栈

• 后端: Python Flask + Flask-SQLAlchemy
• 数据库: MySQL 8.0+
• 前端: 原生 HTML/CSS/JavaScript
• UI设计: 现代深色主题，响应式布局

快速开始

1. 环境要求

• Python 3.8+
• MySQL 8.0+

2. 安装依赖

cd 三类基台出入库系统
pip install -r requirements.txt

3. 配置数据库

1. 创建 MySQL 数据库：

CREATE DATABASE base_station_inventory 
CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

2. 导入数据库结构：

mysql -u root -p base_station_inventory < database/schema.sql

3. 配置数据库连接（二选一）：

方式一: 创建 .env 文件（推荐）

# 复制示例配置
cp .env.example .env

# 编辑 .env 文件，修改数据库密码
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASSWORD=your_password
DB_NAME=base_station_inventory

方式二: 直接修改 config.py 中的配置

4. 启动应用

python app.py

应用将在 http://localhost:5000 启动。

项目结构

三类基台出入库系统/
├── app.py              # Flask 主应用
├── config.py           # 配置文件
├── models.py           # 数据库模型
├── requirements.txt    # Python 依赖
├── README.md           # 项目说明
├── database/
│   └── schema.sql      # 数据库结构
└── static/
    ├── index.html      # 前端页面
    ├── css/
    │   └── style.css   # 样式文件
    └── js/
        ├── api.js      # API 封装
        └── app.js      # 前端主逻辑

API 接口

统计

• GET /api/dashboard/stats - 获取仪表盘统计数据

基台类型

• GET /api/types - 获取所有类型
• POST /api/types - 添加类型

基台管理

• GET /api/stations - 获取基台列表（分页）
• GET /api/stations/all - 获取所有正常状态基台
• POST /api/stations - 添加基台
• PUT /api/stations/:id - 更新基台
• DELETE /api/stations/:id - 删除基台

入库管理

• GET /api/stock-in - 获取入库记录
• POST /api/stock-in - 新增入库

出库管理

• GET /api/stock-out - 获取出库记录
• POST /api/stock-out - 新增出库

其他

• GET /api/warnings - 获取库存预警列表
• GET /api/logs - 获取操作日志

默认数据

系统初始化时会创建：

• 3种基台类型：A类基台、B类基台、C类基台
• 6个示例基台数据

界面预览

系统采用现代深蓝科技风格设计：

• 深色主题，护眼舒适
• 渐变强调色，视觉突出
• 响应式布局，支持多种屏幕
• 流畅动画效果

注意事项

1. 生产环境请修改 config.py 中的 SECRET_KEY
2. 建议定期备份数据库
3. 删除基台前请确保无出入库记录关联

License

MIT License