PACKAGE_README.md 3.19 KB

收银台sy项目打包说明

📦 打包方式

Linux/macOS 系统

使用 package.sh 脚本:

cd sy
bash package.sh

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

Windows 系统

使用 package.bat 脚本:

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等)

快速启动

# 解压后进入目录
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)

修改以下部分:

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

Windows (package.bat)

修改文件复制部分:

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