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

index.php  install.php  admin.html  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 { rewrite ^ /admin.html last; }
location = /h5   { return 301 /h5/; }

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

Apache：无需额外配置（PHP 模块处理 .php；入口别名由前端控制器兜底，直接访问 /install.php）。

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

添加系统计划任务（每分钟），负责分账发起、超时订单关闭、卡过期、消息补发：

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

后台「概览 → 执行定时任务」按钮可手动触发（调试用）。日志见 data/logs/cron.log。

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