# stock_manager

**Repository Path**: coolforv/stock_manager

## Basic Information

- **Project Name**: stock_manager
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-30
- **Last Updated**: 2025-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

库存管理系统 (Stock Management System)

基于 Qt 和 MariaDB 开发的桌面版库存管理系统，支持商品管理、入库出库操作、数据统计和导出功能。

功能特性

• ✅ 商品信息管理（增删改查）

• ✅ 商品入库/出库操作

• ✅ 库存操作记录追踪

• ✅ 数据汇总统计

• ✅ Excel 数据导出

• ✅ 中文界面支持

环境要求

• Windows 7/10/11 64位

• MariaDB 11.8 或更高版本

• Qt 5.15 或更高版本（已包含在发布版本中）

安装步骤

1. 安装 MariaDB 数据库

下载并安装 MariaDB 数据库：
• 下载地址：https://www.jb51.net/database/552904.html

• 安装时记住设置的 root 密码，或使用默认空密码

2. 配置数据库

打开 Command Prompt (MariaDB 11.8 (x64))，执行以下命令：
-- 连接数据库（初始密码为空）
-- 设置新密码（将 '112233' 替换为你自己的密码）
```
mysql -u root -p
ALTER USER 'root'@'localhost' IDENTIFIED BY '112233';
FLUSH PRIVILEGES;
```



-- 创建数据库
CREATE DATABASE stockmsdb;
USE stockmsdb;

3. 创建数据表

在 MariaDB 中执行以下 SQL 语句创建所需表结构：


```
# 创建商品信息表
CREATE TABLE IF NOT EXISTS commoditydatatable (
    StockId VARCHAR(50) NOT NULL UNIQUE COMMENT '库存编号',
    StockName VARCHAR(100) NOT NULL COMMENT '库存名称',
    StockAmount INT NOT NULL DEFAULT 0 COMMENT '库存数量',
    StockUnitprice DECIMAL(10,2) NOT NULL COMMENT '库存单价',
    Supplier VARCHAR(100) COMMENT '供应商',
    Director VARCHAR(50) COMMENT '负责人',
    WareHousetime DATETIME COMMENT '入库时间',
    DeliveryTime DATETIME COMMENT '出库时间',
    Remarks TEXT COMMENT '备注',
    created_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    updated_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
    
    INDEX idx_stock_id (StockId),
    INDEX idx_stock_name (StockName),
    INDEX idx_supplier (Supplier),
    INDEX idx_director (Director),
    INDEX idx_warehouse_time (WareHousetime),
    INDEX idx_delivery_time (DeliveryTime)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='库存管理表';
# 创建库存操作记录表
CREATE TABLE IF NOT EXISTS stock_operations (
    id INT AUTO_INCREMENT PRIMARY KEY COMMENT '自增主键',
    operation_type VARCHAR(20) NOT NULL COMMENT '操作类型',
    stock_id VARCHAR(50) NOT NULL COMMENT '商品编号',
    stock_name VARCHAR(100) NOT NULL COMMENT '商品名称',
    operation_amount INT NOT NULL COMMENT '操作数量',
    operator VARCHAR(50) COMMENT '操作人',
    operation_time DATETIME NOT NULL COMMENT '操作时间',
    remarks TEXT COMMENT '备注',
    created_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT '记录创建时间',
    
    INDEX idx_operation_type (operation_type),
    INDEX idx_stock_id (stock_id),
    INDEX idx_operation_time (operation_time),
    INDEX idx_operator (operator)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='库存操作记录表';
```

4. 下载并运行程序

从发布页面下载最新版本的程序：
• 📦 https://gitee.com/coolforv/stock_manager/releases

下载后解压并运行 StockManagementSystem.exe 即可使用。

使用说明

主界面功能

• 新增商品：添加新的商品信息

• 修改商品：编辑现有商品信息（不可修改商品ID和库存数量）

• 删除商品：删除商品（三次确认，保留操作记录）

• 商品入库：执行入库操作，更新库存数量

• 商品出库：执行出库操作，更新库存数量

• 数据汇总：查看库存操作记录和统计信息

• 导出数据：将数据导出为 Excel 格式

操作流程

1. 首次使用先添加商品信息
2. 进行入库/出库操作
3. 通过数据汇总查看操作记录
4. 定期导出数据备份

数据库配置

程序默认使用以下数据库连接配置：
• 主机：127.0.0.1

• 端口：3306

• 数据库：stockmsdb

• 用户名：root

• 密码：112233

如需修改配置，可在程序运行后通过设置界面调整。

常见问题

Q: 连接数据库失败怎么办？

A: 检查 MariaDB 服务是否启动，数据库配置信息是否正确。

Q: 中文显示乱码如何解决？

A: 确保数据库字符集为 utf8mb4，程序会自动处理中文编码。

Q: 导出 Excel 功能无法使用？

A: 请确保系统已安装 Microsoft Excel 或兼容的办公软件。

技术栈

• 前端: Qt 5.15 + C++

• 数据库: MariaDB 11.8

• 数据导出: Excel COM 组件

• 字符编码: UTF-8

许可证

本项目采用 MIT 许可证，详情见 LICENSE 文件。

更新日志

v1.0.0 (2024-08-06)

• 初始版本发布

• 实现基础库存管理功能

• 支持数据导出和统计

注意: 请定期备份数据库文件，重要数据建议导出 Excel 存档。