应用截图
详细介绍
一、产品一句话定位
**多台电脑共享数据的进销存，局域网或云端部署，收银仓管老板实时协作。**
---
## 二、为什么选择桌面联网版
### 2.1 三大核心优势
| 优势 | 说明 |
|------|------|
| **多人协作** | 多台电脑同时连一台服务器，收银、仓管、财务、老板各端实时共享数据 |
| **灵活部署** | 局域网（店内 WiFi 即可）或云服务器（远程管理），按需选择 |
| **数据安全** | 数据存在您自己的服务器上，不经过任何第三方，支持定时自动备份 |
### 2.2 与同类产品对比
| 对比项 | 当糠桌面联网版 | 桌面单机版 | SaaS 第三方平台 | Excel 协作 |
|--------|--------------|-----------|----------------|-----------|
| 多人协作 | 多电脑同时操作 | 仅单机 | 多设备 | 文件共享 |
| 数据共享 | 实时同步 | 不互通 | 实时同步 | 手动合并 |
| 网络要求 | 局域网/云端 | 无 | 必须公网 | 局域网 |
| 部署方式 | 自建服务器 | 双击即用 | 注册账号 | 文件服务器 |
| 数据归属 | 100% 自有 | 100% 本地 | 依赖服务商 | 本地 |
| 年费/订阅 | 无（买断） | 无（买断） | 按年付费 | — |
| 离线能力 | 支持离线收银 | 完全离线 | 断网不可用 | — |
| 收银体验 | 条码扫描+一键结算 | 同左 | 同左 | 手录 |
| 报表统计 | 自动生成 | 自动生成 | 自动生成 | 手工汇总 |
| 定制性 | 高（OpenAPI） | 高 | 低 | — |
---
## 三、适用场景与目标用户
### 3.1 典型适用场景
- **多收银台门店** — 2-3台收银电脑同时收银，数据实时汇总
- **前后台协作** — 前台收银 + 后台管库存开单，实时联动
- **财务独立操作** — 收银员忙收银，财务在另一台电脑对账结算
- **老板远程查看** — 老板在家/出差，通过云端看经营数据
- **连锁多店** — 各店连同一云服务器，总部统一管理
- **仓库+门店** — 仓管电脑入库，前台实时看到库存变化
- **批发企业** — 多人同时开单，库存实时扣减不超卖
### 3.2 目标用户画像
| 角色 | 使用位置 | 核心诉求 |
|------|----------|----------|
| 收银员 | 收银台电脑 | 快速扫码收银，挂单取单 |
| 仓管 | 仓库电脑 | 扫码入库出库，实时查库存 |
| 财务 | 办公室电脑 | 查报表，对账结算 |
| 老板/店长 | 任意电脑/远程 | 经营看板，审批单据 |
### 3.3 部署模式选择
| 模式 | 适用场景 | 网络要求 | 成本 |
|------|----------|----------|------|
| **局域网模式** | 单店多人协作 | 同一 WiFi/网段 | 零（用现有电脑做服务器） |
| **云端模式** | 多店/远程管理 | 公网 | 云服务器约 50 元/月 |
---
## 四、功能亮点
### 4.1 核心业务闭环
```
采购入库 → 库存实时增加 → 多台POS收银 → 库存实时扣减 → 报表实时汇总
```
### 4.2 完整功能清单
**商品管理**
- 商品 CRUD（编码/名称/规格/价格/库存上下限）
- 商品编码自动生成、多条码管理
- 支持数量品/称重品/计价品/服务项
- 保质期 & 批次管理、分类与品牌管理
- **多端同步** — A电脑录入商品，B电脑立即可见
**POS 收银**
- 条码扫描 + 商品搜索 + 一键结算
- 购物车管理（增/减/改价/删除）
- 多支付方式（现金/微信/支付宝）
- 挂单/取单、仓库选择
- **多收银台并行** — 每台电脑独立收银，数据实时汇总
- **库存实时扣减** — 卖出即减，不会超卖
**采购管理**
- 采购订单 → 采购入库，审核自动增库存
- **多端协作** — 仓管开单，老板审批，流程闭环
**销售管理**
- 销售订单 → 销售出库，审核自动减库存
**库存管理**
- 按仓库库存查询、库存流水日志
- 库存上下限预警，**多端同步预警提醒**
- **实时库存** — 任何端入库/出库，其他端即时可见
**会员管理**
- 会员 CRUD、等级、积分、充值、消费记录
- **跨端共享** — 任意收银台可查会员信息
**财务管理**
- 账户管理、收支记录
- 供应商/客户结算单
- **多端对账** — 各收银台流水统一汇总
**报表中心**
- 经营看板（今日销售/订单/客单价/库存预警）
- 销售趋势 & 热销商品
- 销售/采购/库存/POS/财务/会员 全维度报表
- **多端数据汇总** — 所有收银台数据统一报表，不再逐台统计
**系统与安全**
- JWT 认证 + 角色权限管理（47项权限）
- **专属角色** — 收银员只能收银，仓管只能管库存，财务只能看报表
- 审计日志（谁在什么时间做了什么操作）
- 数据备份（服务器统一备份，不怕单台电脑故障）
- Excel 数据导入/导出、OpenAPI 开放接口、Webhook 通知
### 4.3 联网版独有能力
| 能力 | 说明 |
|------|------|
| **多端实时同步** | 所有电脑连同一服务器，数据零延迟 |
| **角色权限隔离** | 收银员只能收银，仓管只能管库存，老板全权限 |
| **离线降级收银** | 断网时仍可本地收银，联网后自动同步 |
| **多仓库管理** | 各收银台可绑定不同仓库，库存隔离 |
| **数据集中备份** | 服务器统一备份，不怕单台电脑丢失 |
| **审计追踪** | 记录每笔操作的操作人、时间、内容，责任可追溯 |
| **Webhook 通知** | 库存预警、单据审核等事件自动推送通知 |
---
## 五、离线降级 — 断网不停业
联网版具备离线能力，收银台断网时自动降级为本地模式：
```
🟢 在线 — 数据实时同步，多端协作
🟡 离线 — 自动切换本地缓存，照常收银
🔄 恢复 — 联网后自动同步，数据无缝衔接
```
**离线时可用功能：**
- POS 扫码结算（本地商品缓存）
- 库存查询（标注"离线数据"）
- 创建单据（联网后上传）
**同步冲突解决：**
- 商品信息：最后修改优先
- 库存数量：增量合并（各端变化量累加）
- POS 订单：不冲突（含设备前缀的唯一编号）
---
## 六、快速上手
### 6.1 系统要求
**服务器端：**
| 项目 | 最低要求 | 推荐配置 |
|------|----------|----------|
| 操作系统 | Windows 7 (x64) / Linux | Windows Server / Ubuntu |
| 内存 | 4 GB | 8 GB+ |
| 磁盘 | 500 MB（软件）+ 数据空间 | SSD + 定期备份 |
| MySQL | 5.7+ | 8.0+ |
**客户端（各收银台/办公电脑）：**
| 项目 | 最低要求 | 推荐配置 |
|------|----------|----------|
| 操作系统 | Windows 7 (x64) | Windows 10/11 |
| 浏览器 | Chrome / Edge | 最新版 Chrome |
| 网络 | 能访问服务器 | 稳定局域网/专线 |
### 6.2 局域网部署（推荐起步，三步开始）
**第一步：准备服务器**
在店内选一台电脑做服务器（可用现有收银台电脑，不影响其收银）：
1. 安装 MySQL 8.0（免费）
2. 运行 `dangkang-server.exe`
3. 修改 `config.yaml`：
```yaml
app:
mode: server
port: 9527
database:
driver: mysql
dsn: "root:密码@tcp(127.0.0.1:3306)/dangkang?charset=utf8mb4&parseTime=true"
```
**第二步：各电脑连接**
其他电脑打开浏览器，输入服务器地址：
- `http://192.168.1.100:9527`（局域网 IP）
- 首次访问创建管理员账号
**第三步：开始使用**
各电脑登录不同账号，按角色操作：
- 收银台 → POS 收银
- 仓库 → 入库出库
- 办公室 → 报表对账
### 6.3 局域网部署示例
```
路由器 (192.168.1.1)
│
├── 电脑A (192.168.1.100) → 服务器: dangkang-server.exe + MySQL
│ 同时也可做收银台使用
│
├── 电脑B (收银台1) → 浏览器打开 192.168.1.100:9527
│
├── 电脑C (收银台2) → 浏览器打开 192.168.1.100:9527
│
├── 电脑D (仓库) → 浏览器打开 192.168.1.100:9527
│
└── 电脑E (财务) → 浏览器打开 192.168.1.100:9527
```
> 提示：在路由器设置 DHCP 保留，固定服务器 IP，避免重启后 IP 变化。
### 6.4 云端部署
需要远程访问或多店管理时：
1. 购买云服务器（华为云/阿里云，约 50 元/月）
2. 安装 MySQL + `dangkang-server`
3. 配置域名 + HTTPS 证书（Let's Encrypt 免费）
4. 各门店电脑通过域名访问
```nginx
# Nginx 反向代理配置
server {
listen 443 ssl;
server_name dk.yourcompany.com;
ssl_certificate /etc/letsencrypt/live/dk.yourcompany.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/dk.yourcompany.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:9527;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
```
---
## 七、从单机版升级 — 无缝衔接
如果您已经在使用当糠 PC 单机版，升级到联网版非常简单：
### 7.1 升级步骤
1. **安装 MySQL** — 在服务器电脑上安装 MySQL 8.0
2. **数据迁移** — 使用迁移工具将单机版 SQLite 数据导入 MySQL
```
单机版数据目录: ./data/dangkang.db
迁移工具: dangkang-migrate sqlite2mysql
```
3. **切换配置** — 修改 `config.yaml`：
```yaml
app:
mode: server # standalone → server
database:
driver: mysql # sqlite → mysql
dsn: "root:xxx@tcp(127.0.0.1:3306)/dangkang?charset=utf8mb4&parseTime=true"
```
4. **重启服务** — 运行 `dangkang-server.exe`
5. **其他电脑访问** — 浏览器输入服务器地址
### 7.2 升级保障
| 保障项 | 说明 |
|--------|------|
| **数据完整** | 所有历史数据迁移后完整保留 |
| **操作不变** | 界面和操作习惯 100% 一致 |
| **同一后端** | 单机版与联网版使用完全相同的 Go 后端代码 |
| **可回退** | 保留 SQLite 备份，必要时可切回单机模式 |
---
## 八、角色权限 — 各司其职
联网版支持精细的角色权限控制，让每个人只看到该看的功能：
| 角色 | 典型权限 | 说明 |
|------|----------|------|
| **超级管理员** | 全部 47 项权限 | 系统管理、用户管理 |
| **老板/店长** | 看板+报表+审批+全部查看 | 不需要操作收银和单据 |
| **收银员** | POS 收银 + 挂单取单 | 只能收银，看不到成本和利润 |
| **仓管** | 入库+出库+库存查询 | 只管库存相关 |
| **财务** | 报表+结算+收支 | 只看财务相关 |
> 可自定义角色，灵活组合 47 项权限，满足各种管理需求。
---
## 九、产品形态总览
当糠进销存提供完整的产品矩阵，按需选择、平滑升级：
| 产品形态 | 部署方式 | 网络要求 | 适用规模 |
|----------|----------|----------|----------|
| PC 单机版 | exe + SQLite | 无需 | 1人/1店 |
| **桌面联网版** ← 本文档 | exe + MySQL | 局域网/云 | 多人/多店 |
| 安卓单机版 | APK + 内嵌Go + SQLite | 无需 | 1人/移动 |
| 安卓联网版 | APK + MySQL(远程) | 局域网/云 | 多人/移动协作 |
| 鸿蒙单机版 | HAP + 内嵌Go + SQLite | 无需 | 1人/华为设备 |
| 鸿蒙联网版 | HAP + MySQL(远程) | 局域网/云 | 多人/华为设备协作 |
| SaaS 云端版 | 云服务器 + MySQL | 需公网 | 连锁/多租户 |
> 所有形态共享同一套 Go 后端和 API 接口，学会一种，全部掌握。
> 桌面联网版 + 移动联网版可同时使用，收银台用电脑，仓管用平板，老板用手机。
---
## 十、常见问题
**Q：必须要有服务器吗？**
A：是的，联网版需要一台电脑运行服务端 + MySQL。推荐用店内一台电脑做服务器（可同时做收银台），零额外硬件成本。
**Q：局域网模式需要公网吗？**
A：不需要。只要所有电脑在同一 WiFi/网段内即可，无需公网。
**Q：几台电脑可以同时用？**
A：没有硬性限制。局域网模式下 5-20 台电脑同时使用毫无压力。
**Q：客户端需要安装软件吗？**
A：不需要。客户端只需浏览器，输入服务器地址即可使用，零部署。
**Q：断网了怎么办？**
A：联网版支持离线降级，收银台断网时自动切换本地缓存模式，照常收银，联网后自动同步。
**Q：和单机版有什么区别？**
A：单机版用 SQLite 只能一台电脑用；联网版用 MySQL 支持多台电脑同时操作。功能完全一致，界面和操作习惯不变。
**Q：服务器电脑关机了还能用吗？**
A：服务器关机后所有客户端无法连接。建议设置服务器自动开机，或使用低功耗 NAS/云服务器 24 小时运行。
**Q：数据安全吗？**
A：数据存在您自己的服务器上，不经过任何第三方。MySQL 支持定时自动备份，可备份到本地或云端。支持 JWT 认证和角色权限控制。
**Q：支持外网远程访问吗？**
A：支持。部署到云服务器并配置域名+HTTPS后，任何有网络的电脑都可访问。老板出差在外也能看经营数据。
**Q：和移动端可以一起用吗？**
A：可以。桌面联网版和安卓/鸿蒙联网版连同一服务器，电脑收银+平板入库+手机看报表，完美协作。
**Q：各端数据会冲突吗？**
A：POS 订单各端独立编号不会冲突；库存和会员余额采用增量合并策略，自动处理多端变化。
**Q：MySQL 难维护吗？**
A：日常几乎无需维护。安装后自动创建数据库和表结构，升级时自动迁移。只需定期备份即可。
---
## 十一、联系方式与获取方式
- **产品名称**：当糠进销存（桌面联网版）
- **当前版本**：v1.0
- **服务端**：`dangkang-server.exe` + MySQL 8.0
- **客户端**：浏览器访问服务器地址
- **联系电话**：18865957520
- **官方网站**：www.wenyaoyu.com
- **技术支持邮箱**：1115084741@qq.com
> 一套系统，多种形态，从一台电脑到多端协作，从局域网到云端，当糠陪你一路成长。