═══════════════════════════════════════════════════════════════
          彤宸工坊 · 本地部署造价师工作台
          安装部署说明 & 免责声明
          版本：1.0.6 更新日期2026.7.30
═══════════════════════════════════════════════════════════════


📌 重要声明（请务必阅读）

本软件为「本地部署」PHP + SQLite 架构的造价管理工具，
所有数据均存储在您本地电脑中，不上传任何云端服务器。

您对本软件的使用、数据安全、数据备份负全部责任。
作者（彤宸工坊，www.xazjs.com）不对因数据丢失、泄露、
误操作、硬件故障、系统崩溃等造成的任何直接或间接损失
承担法律责任。

您下载、安装、使用本软件即表示您已阅读并同意本声明。


───────────────────────────────────────────────────────────────
一、系统环境要求
───────────────────────────────────────────────────────────────

操作系统：Windows 7 / 10 / 11（64位或32位）
运行环境：PHP 7.3 + Nginx / Apache（推荐使用小皮面板）
数据库：SQLite（无需额外安装）
硬盘空间：至少 500MB
内存要求：至少 2GB


───────────────────────────────────────────────────────────────
二、安装小皮面板（PHP运行环境）
───────────────────────────────────────────────────────────────

本软件需要 PHP 运行环境，推荐使用「小皮面板(phpStudy)」，
完全免费，一键安装，无需任何技术基础。

▶ 根据您的操作系统版本，下载对应安装包：

  64位系统下载：
  https://public.xp.cn/upgrades/phpStudy_64.zip

  32位系统下载：
  https://public.xp.cn/upgrades/phpStudy_32.zip

▶ 安装步骤：
  1. 将下载的 zip 压缩包解压
  2. 双击运行 phpStudy_64.exe（或 phpStudy_32.exe）
  3. 安装路径选择 D 盘（推荐 D:/phpstudy_pro）
  4. 一路“下一步”完成安装
  5. 启动小皮面板，点击「启动」按钮（Apache 和 MySQL 均启动）


───────────────────────────────────────────────────────────────
三、部署本软件（覆盖 WWW 目录）
───────────────────────────────────────────────────────────────

▶ 将您收到的「造价工作台」源码文件夹内的所有内容，
   完整覆盖到小皮面板的 WWW 目录：

  默认路径：D:/phpstudy_pro/WWW/

  操作步骤：
  1. 解压您收到的源码压缩包
  2. 复制里面所有文件和文件夹
  3. 粘贴到 D:/phpstudy_pro/WWW/ 目录下
  4. 选择「全部覆盖」（如提示）

▶ 确认目录结构是否正确：
  D:/phpstudy_pro/WWW/
  ├── index.php
  ├── login.php
  ├── auth.php
  ├── data/
  ├── uploads/
  ├── pages/
  ├── includes/
  └── ...（其他文件）


───────────────────────────────────────────────────────────────
四、启动访问
───────────────────────────────────────────────────────────────

▶ 打开浏览器，在地址栏输入：
  http://localhost

▶ 首次访问将自动跳转到授权激活页面。
   请复制页面显示的「机器码」，联系管理员获取授权码。

▶ 输入授权码后，系统自动激活，进入登录页面。

▶ 默认管理员账号：
  用户名：admin
  密　码：admin888

▶ 首次登录后，请立即修改默认密码（右上角「个人中心」）。


───────────────────────────────────────────────────────────────
五、开机自启设置（推荐）
───────────────────────────────────────────────────────────────

▶ 打开小皮面板 → 点击右上角「设置」→「开机自启」
▶ 勾选「开机自启小皮面板」
▶ 这样每次开机后，Web 服务会自动启动，无需手动操作。


───────────────────────────────────────────────────────────────
六、数据安全与备份（非常重要）
───────────────────────────────────────────────────────────────

本软件所有数据存储在以下两个目录中：

  📁 D:/phpstudy_pro/WWW/data/        ← 数据库文件（xazjs.db）
  📁 D:/phpstudy_pro/WWW/uploads/     ← 所有上传的文件

⚠️ 请务必定期备份这两个文件夹！
   建议每周备份一次，或每次重要数据录入后备份。

备份方式：
  1. 直接复制 data/ 和 uploads/ 文件夹到其他磁盘或U盘
  2. 或使用系统内置的「数据备份」功能（登录后左侧菜单）

⚠️ 重装系统或更换电脑前，请务必备份这两个目录！
   没有备份将导致所有数据丢失，无法恢复。


───────────────────────────────────────────────────────────────
七、常见问题
───────────────────────────────────────────────────────────────

Q：访问 localhost 显示“403 Forbidden”？
A：检查 WWW 目录下是否有 index.php 文件。

Q：访问 localhost 显示空白页？
A：检查 PHP 版本是否≥7.3，可在小皮面板切换 PHP 版本。

Q：授权码输入后提示无效？
A：请确认机器码是否复制完整，或联系管理员重新生成。

Q：登录后部分功能报错？
A：检查 data/ 目录是否有读写权限（通常无需手动设置）。

Q：端口 80 被占用怎么办？
A：在小皮面板中点击「Apache」→「端口」改为 8080，
   然后访问 http://localhost:8080。


───────────────────────────────────────────────────────────────
八、版权与联系方式
───────────────────────────────────────────────────────────────

本软件由「彤宸工坊」开发，保留所有权利。
未经书面授权，禁止私自复制、篡改、分发商用源码。

📞 官网：https://www.xazjs.com
📞 公众号/客服：请见系统内「联系客服」板块

═══════════════════════════════════════════════════════════════
            感谢您使用彤宸工坊 · 造价工作台
═══════════════════════════════════════════════════════════════