# 收银台sy项目打包说明

## 📦 打包方式

### Linux/macOS 系统

使用 `package.sh` 脚本：

```bash
cd sy
bash package.sh
```

打包完成后，会在项目根目录生成 `sy_cashier_YYYYMMDD_HHMMSS.zip` 文件。

### Windows 系统

使用 `package.bat` 脚本：

```cmd
cd sy
package.bat
```

**注意**：Windows系统需要安装以下工具之一：

- 7-Zip（推荐）
- WinRAR

如果没有安装压缩工具，脚本会提示手动打包。

## 📋 打包包含的文件

### HTML文件

- `login.html` - 登录页
- `home.html` - 商品列表页
- `settlement.html` - 收银台（核心功能）
- `member.html` - 会员管理
- `orders.html` - 订单记录
- `from.html` - 其他功能页

### 资源目录

- `css/` - 样式文件
- `js/` - JavaScript库（Vue.js, jQuery等）
- `images/` - 图片资源

### 文档文件

- `README.md` - 项目说明
- `QUICK_START.md` - 快速开始指南
- `API_CONFIG.md` - API配置说明
- `SETUP_CHECKLIST.md` - 设置检查清单
- `LAUNCH_QUICK_REFERENCE.txt` - 快速参考

### 启动脚本

- `start.sh` - Linux/macOS启动脚本
- `start.bat` - Windows启动脚本
- `start_3001.sh` - 指定端口启动脚本
- `start_server.py` - Python服务器脚本

## 🚫 排除的文件

以下文件**不会**被打包：

- `*.bak` - 备份文件
- `home copy.html` - 副本文件
- `axios-1.x/` - 开发依赖（已包含在js目录中）
- `.git/` - Git版本控制文件
- `node_modules/` - Node.js依赖（如果有）

## 📊 打包文件信息

- **文件大小**：约 500KB
- **文件数量**：约 57 个文件
- **格式**：ZIP压缩包

## 🚀 使用打包文件

### 解压部署

1. 解压zip文件到目标目录
2. 确保所有文件结构完整
3. 使用任意HTTP服务器启动（Python、Node.js、Nginx等）

### 快速启动

```bash
# 解压后进入目录
cd sy_cashier

# 使用Python启动（推荐）
python3 -m http.server 8888

# 或使用Node.js http-server
npx http-server . -p 8888 -c-1
```

### 访问地址

- 登录页：`http://localhost:8888/login.html`
- 商品页：`http://localhost:8888/home.html`
- 收银台：`http://localhost:8888/settlement.html`

## ⚙️ 自定义打包

如果需要自定义打包内容，可以编辑打包脚本：

### Linux/macOS (`package.sh`)

修改以下部分：

```bash
# 添加要排除的文件
EXCLUDE_LIST=(
    "*.bak"
    "*.backup"
    # 添加更多排除规则
)
```

### Windows (`package.bat`)

修改文件复制部分：

```batch
REM 添加要复制的文件或目录
copy "your_file.txt" "%TEMP_DIR%\" >nul
```

## 📝 注意事项

1. **依赖检查**：确保所有必要的JavaScript库都已包含
2. **API配置**：部署后需要检查API地址配置
3. **浏览器兼容**：建议使用现代浏览器（Chrome、Firefox、Edge）
4. **HTTPS**：生产环境建议使用HTTPS

## 🔍 验证打包

解压后检查以下文件是否存在：

- 所有HTML文件
- `css/style.css`
- `js/vue.min.js`
- `js/jquery.min.js`
- `images/` 目录下的所有图标
- 启动脚本文件

## 📞 技术支持

如有问题，请检查：

1. 打包脚本执行权限（Linux/macOS）
2. 压缩工具是否正确安装（Windows）
3. 文件路径是否正确

---

**最后更新**：2025-12-22