minishouyin/README.md

85 lines
2.2 KiB
Markdown
Raw Normal View History

2025-11-12 11:35:57 +08:00
# 迷你收银台系统
一个基于Electron + React + SQLite的迷你收银台系统支持完全本地化部署离线运行。
## 功能特点
- 🖥️ 桌面应用基于Electron支持Windows平台
- 📦 一键安装:所有组件打包在一个安装包中
- 📱 离线运行:完全本地数据存储,不依赖网络
- 🛒 商品管理:商品录入、分类管理、库存管理
- 💰 收银功能:扫码录入、购物车、多种支付方式
- 🧾 小票打印:支持热敏打印机
- 📊 报表统计:销售统计、订单管理
- 🔧 系统设置:店铺信息、硬件配置
## 技术栈
- **前端**React 18 + Ant Design
- **后端**Node.js + Express
- **数据库**SQLite
- **桌面框架**Electron
- **打包工具**electron-builder
## 开发环境要求
- Node.js 14+
- npm 6+
## 安装依赖
```bash
npm install
```
## 开发运行
```bash
# 启动开发环境
npm run dev
```
## 构建打包
```bash
# 构建前端和主进程
npm run build
# 打包为可执行文件
npm run dist
```
## 默认账号
- 管理员admin / admin123
- 收银员cashier1 / cashier123
## 项目结构
```
minishouyin/
├── src/
│ ├── main/ # Electron主进程
│ │ ├── main.js # 主进程入口
│ │ └── preload.js # 预加载脚本
│ ├── renderer/ # 渲染进程(前端)
│ │ ├── components/ # React组件
│ │ ├── pages/ # 页面组件
│ │ ├── services/ # API服务
│ │ ├── styles/ # 样式文件
│ │ ├── App.js # 应用入口
│ │ └── index.js # 渲染进程入口
│ └── server/ # 本地服务
│ ├── app.js # Express应用
│ ├── routes/ # API路由
│ ├── models/ # 数据模型
│ └── database/ # 数据库配置
├── assets/ # 静态资源
├── build/ # 构建输出
├── dist/ # 打包输出
└── package.json
```
## 许可证
MIT