将安装包 membercard-server-v1.0.0.tar.gz 上传到服务器，解压到站点根目录（宝塔：网站 → 根目录）。解压后站点根应包含：

index.php  install.php  admin.html  admin/  assets/  site/  h5/
app/  config/  cli/  docs/  data/  uploads/  README.md

宝塔面板：网站 → PHP 版本选 7.4+；无需伪静态。仅建议在配置中追加以下保护规则（</server> 前的任意 location 区域）：

location ~ ^/(app|config|cli|data)/ { return 404; }
location = /admin { return 301 /admin/; }
location = /h5   { return 301 /h5/; }
location ^~ /wxopen/ { rewrite ^/wxopen/(.*)$ /wxopen.php?appid=$1 last; }

nginx 原生：server 块中确保 index index.php index.html; 且 php 通过 fastcgi 处理，随后追加以上三行并 nginx -s reload。

Apache：无需额外配置（PHP 模块处理 .php；入口别名由前端控制器兜底，直接访问 /install.php）。若使用微信开放平台（第三方平台）功能，需加一行 RewriteRule ^wxopen/(.*)$ wxopen.php?appid=$1 [L,QSA]。

1. 浏览器打开 http://你的域名/ → 自动跳转安装向导（或直接访问 /install.php）。
2. 环境检测：确认全部通过（SQLite/MySQL 驱动二选一即可）。
3. 数据库：
   • SQLite（默认）：零配置，单文件库在 data/membercard.sqlite，适合单机与中小规模。
   • MySQL：填主机/端口/库名/账号密码，库不存在会自动创建（utf8mb4）。
4. 管理员：设置平台管理员账号与密码（用于登录 /admin）。
5. 演示数据：生产环境建议不勾选（勾选会写入演示商家/套餐/订单）。
6. 点击「开始安装」→ 提示安装完成。

推荐方式（防呆包装，自动寻找 PHP 8.2/8.4，自动定位站点根与日志）：

bash /www/wwwroot/你的站点/cli/cron.sh

原始方式（手动指定 PHP 8.2 解释器，整行）：

/www/server/php/82/bin/php /www/wwwroot/你的站点/cli/cron.php >> /www/wwwroot/你的站点/data/logs/cron.log 2>&1

宝塔面板操作：计划任务 → 添加任务 → 任务类型「Shell 脚本」→ 执行周期「N 分钟 1 分钟」→ 脚本内容仅填上面其中一行（把「你的站点」替换为真实根目录路径）→ 保存后点「执行」测试一次。

不使用宝塔时，直接 crontab -e 添加同一行（crontab 里行首加 * * * * * ）。

后台「概览 → 执行定时任务」按钮等价手动触发（分账即时生效）。日志见 data/logs/cron.log，正常输出 JSON。

1. / 打开官网；/admin 用管理员账号登录成功。
2. 后台 → 商家管理 → 门店二维码：生成并下载 PNG，手机扫码能进店。
3. /h5 登录（任意手机号）→ 扫门店码 → 套餐购买 → 模拟支付 → 卡包出现会员卡。
4. 后台 → 台账 / 订单 / 分账单能看到对应数据；cron 日志正常滚动。
5. 商家中心（我的 → 商家中心）：提交申请 → 平台后台可见申请商家与执照。