产品使用文档与部署教程，持续更新中
index.php，路由与安全在 app/Router / app/Security，控制器在 app/Controllers，插件体系在 app/Plugin；PHP 7.4~8.1 / MySQL 5.7+；plugins/）、主题（themes/）、标签/钩子（app/Tags，模板里用标签调用数据）；themes/default-mobile，另含微信小程序（miniprogram/）；cron/ 下有 order_expire.php（订单超时）、order_auto_confirm.php（自动确认）、low_stock_alert.php（低库存提醒）、baidu_push.php（SEO 推送），用计划任务定时跑。程序根/ ├── index.php # 入口（站点根即程序根） ├── install.php # 安装向导（装完删除） ├── app/ │ ├── Controllers/ # 控制器（Admin 下 19 个后台控制器） │ ├── Plugin/ Security/ Router/ Services/ # 框架层 │ ├── Tags/ # 模板标签 │ └── routes/ # 路由定义（web.php 等） ├── plugins/ # 插件（affiliate 分销 / coupon 优惠券 / crowdfunding 众筹 / │ # epay 易支付 / groupbuy 拼团 / points 积分 / qqbot 机器人…） ├── themes/ # 主题（default / default-mobile / mir） ├── cron/ # 定时任务脚本 ├── miniprogram/ # 微信小程序源码 ├── database/ # 建库与迁移 SQL ├── storage/ # 运行数据（缓存/日志/上传，要可写） ├── config/app.example.php # 配置示例（复制为 app.php） ├── docs/ # 随包文档（install.md / overview.md / tags.md） └── xj_panel.php # 授权验证 / 在线更新维护页
vshop_，共 60+ 张，主要分组：vshop_products / vshop_product_types / vshop_type_attrs / vshop_categories / vshop_product_cards（卡密池）/ vshop_orders / vshop_order_items / vshop_refunds / vshop_reviews / vshop_carts / vshop_favorites；vshop_users / vshop_user_transactions / vshop_user_recharges / vshop_user_withdraws / vshop_user_realname / vshop_login_logs / vshop_verify_codes / vshop_sms_logs；vshop_vip_levels / vshop_vip_logs / vshop_vip_product_rules / vshop_vip_member_day_logs；积分：vshop_points_accounts / vshop_points_logs / vshop_points_products / vshop_points_product_rules / vshop_points_exchanges / vshop_points_sign_ins；vshop_plugins / vshop_plugin_settings / vshop_plugin_migrations / vshop_admin_plugin_permissions；vshop_themes / vshop_theme_settings / vshop_diy_blocks（可视化装修）/ vshop_nav_items / vshop_banners / vshop_pages；vshop_epay_settings / vshop_epay_payments；微信：vshop_wx_users / vshop_wx_messages / vshop_wx_replies / vshop_wx_tokens；vshop_tw_*（悬赏/任务模块）、vshop_seller_applies（商家入驻）、vshop_messages / vshop_conversations（会话）、vshop_settings / vshop_migrations / vshop_version_history / vshop_operation_logs。插件目录自带 plugin.json（或等价声明）与迁移脚本；启用时写 vshop_plugins，配置存 vshop_plugin_settings，升级跑 vshop_plugin_migrations。加插件 = 复制 plugins/epay 之类现成插件改逻辑。
前台页面全部由 themes/<主题>/ 渲染，模板里用「标签」取数据（见 app/Tags/ 与随包 docs/tags.md）。换主题/改版式只动主题目录，不动控制器。
商品卡密存 vshop_product_cards，支付成功后自动取一张写进订单；批量导入卡密在后台商品管理里。
宝塔/系统计划任务里加：php /站点路径/cron/order_expire.php（每分钟）等，否则订单不会自动过期/自动确认。
app/Controllers/ 加控制器 + app/routes/web.php 加路由 + 主题里加模板；vshop_admin_plugin_permissions（插件权限）配合；database/ 下的迁移 SQL 里（可重复执行），并在 app/ 里建对应模型/服务；storage/ 要可写；install.php 装完必须删除；升级前备份 plugins/、themes/ 与 config/app.php。站点根 xj_panel.php 支持「验证授权 / 在线更新」（授权码在 xj_auth.php）。更新不覆盖 storage/、config/、themes/ 与上传数据；改过 app/ 或 plugins/ 的文件请先备份。