# 云智开单工具V1.0 - 宝塔部署说明

## 系统介绍

云智开单工具是一套基于 `PHP 7.4 + MySQL` 的轻量级网页开单系统，页面风格仿针式打印机单据，适合用于销货单、送货单、客户开单、单据分享、单据打印和客户档案管理。

系统支持多用户使用，不同用户之间的单据和客户档案相互隔离。管理员可以管理用户账号、密码、状态和删除用户。

## 主要功能

- 用户注册、登录、退出
- 管理员后台
- 用户启用/禁用
- 修改用户账号、密码、角色
- 删除用户及其关联数据
- 单据新建、修改、保存
- 单据删除
- 单据状态：草稿、正常、已结单、红冲
- 单据分类
- 客户档案管理
- 客户新增、编辑、删除
- 客户分类、备注、筛选
- 开单页拉取客户档案并自动填入客户信息
- 客户调档开单
- 明细默认 15 行，可增加行、删除行
- 打印/分享页自动隐藏空白明细行
- 二维码分享只读单据页面
- 浏览器打印或另存为 PDF
- 单据顶部名称和单据类型可修改并记忆

## 环境要求

- 宝塔面板
- PHP：7.4 或以上
- MySQL：5.7 或 8.0
- Web 服务：Nginx 或 Apache
- 浏览器：Chrome、Edge、Firefox 等现代浏览器

## 默认数据库信息

安装页默认会填入以下参数，可按实际服务器修改：

```text
数据库名：kaidan
数据库用户：kaidan
数据库密码：123123
数据库主机：127.0.0.1
数据库端口：3306
```

## 默认管理员账号

执行安装后，系统会自动创建或修复默认管理员：

```text
账号：admin
密码：123456
```

上线后建议尽快进入管理后台修改管理员密码。

## 文件上传

把本目录所有文件上传到宝塔网站根目录，例如：

```text
/www/wwwroot/你的域名/
```

建议保留完整目录结构，不要只上传部分文件。

主要文件说明：

```text
install.php              数据库安装/升级页面
auth.php                 登录/注册/退出页面
admin.php                管理员后台
index.php                开单入口，带登录校验
index.html               单据页面模板
dashboard.php            单据管理页面
customers.php            客户档案页面
view.php                 单据分享只读页面
save_bill.php            保存单据接口
get_bill.php             读取单据接口
delete_bill.php          删除单据接口
update_bill_status.php   更新单据状态接口
customers_api.php        客户档案下拉接口
schema.sql               数据库表结构
style.css                页面样式
script.js                前端交互逻辑
lib/                     公共数据库和登录库
config/database.php      数据库配置文件
```

下载地址：https://gcyled.lanzouu.com/inE5N3rknibi