AGENTS.md — new_sdk

项目概述

游戏SDK平台 — 基于 ThinkPHP 5.0 的多模块应用，涵盖游戏渠道SDK对接、支付回调、公会管理和官网。PHP 7.0–7.2。

仓库根目录 (D:\web\composer\new_sdk\new_sdk) 只有 www/，所有应用代码在 www/new_sdk/ 下。以下路径均相对于 www/new_sdk/。

架构

多模块 ThinkPHP 应用，通过域名路由将子域名映射到模块（application/route.php）：

子域名前缀	模块	用途
`admin`	`admin/`	后台管理
`sdkapi` / `t`	`api/`	支付回调 + SDK API
`cpsapi` / `sdkcpsapi`	`guildapi/`	公会API
`mcpsapi`	`mcpsapi/`	MCPS API
`jhgame`	`complex/`	渠道SDK对接
`www`	`home/`	官网 (PC)
`m`	`mobile/`	手机端

核心目录：

application/common/ — 共享代码：model/（151个模型）、logic/、library/、controller/Base.php
application/service/ — 顶层服务类（PayService、GamePayService 等）
application/crontab/ — 定时任务，注册在 application/command.php，通过 php think <command> 调用
application/extra/ — 扩展配置：queue.php（Redis队列）、kafka.php、operatelog.php
extend/ — 第三方SDK：alipay、alipay_wap、DouYinGameOpen、LdzfPay、XiTaiYouPay、Obs（华为）、tree
public/ — Web根目录，入口文件 index.php
think — CLI入口（类似 artisan）

入口文件

Web: public/index.php — 加载 constants.php → constants/<APP_STATUS>.php → thinkphp/start.php
CLI: think — 加载 public/constants.php → public/constants/<APP_STATUS>.php → thinkphp/console.php

环境配置

环境变量通过 .env_dev / .env_pro 文件加载（ThinkPHP 的 Env::get()）。APP_STATUS 常量（dev、stable 或默认值）决定使用哪个环境文件和路由配置。

仓库中缺失：public/constants.php 和 public/constants/*.php — 定义 APP_STATUS 等平台常量，属于部署配置，已 gitignore。

开发命令

# 安装依赖
composer install
# 如果系统没有 composer，可以用仓库中已提交的 composer.phar
php composer.phar install

# 运行定时任务（注册在 application/command.php）
php think <CommandName>

# 示例：
php think PolyChannelFlowStats
php think ChannelSettleMonth
php think AutoPackage

# PHPUnit（tests/ 目录目前不存在）
vendor/bin/phpunit

没有配置 lint、typecheck 或 codegen 命令，没有 CI 工作流。

关键约定

PSR-4 自动加载：app\ 命名空间映射到 application/（composer.json）
模型命名：application/common/model/ 下使用 ThinkPHP 约定（如 app\common\model\Members）
控制器模式：每个模块有独立的 controller/、model/、validate/、view/ 目录
配置加载：模块级配置通过各模块目录下的 config.php；扩展配置在 application/extra/
队列：Redis 驱动（application/extra/queue.php），使用 db select 3
Kafka：用于事件流（application/extra/kafka.php、application/command/KafkaConsumer.php）
Session：API 模块使用 Redis 存储
CORS：public/index.php 中完全开放（Access-Control-Allow-Origin: *）
响应码：100=登录失效, 110=参数有误, 120=处理提示, 130=执行异常, 200=正常

外部服务

MySQL 7, Redis 5.2.1
阿里云OSS / 华为云OBS（文件存储）
支付宝（SDK 在 extend/alipay/、extend/alipay_wap/）
微信支付（application/common/library/WeixinPay.php）
钉钉机器人（告警）
阿里云短信
抖音游戏开放平台（extend/DouYinGameOpen/）
Kafka（事件流）
GatewayWorker/WebSocket（application/common/logic/Websocket.php）

关联仓库

本仓库是五个仓库之一，其余不在本目录内：

new_sdk_cps-admin — CPS后台
new_sdk_cps-py — CPS打包（Python，被 application/common/logic/SubPackage.php 引用）
new_sdk_ws — 通知服务（WebSocket）
new_sdk_go — Excel导出 & 游戏礼包发放（Go，被 application/common/library/MakeReportGo.php 引用）

注意事项

public/constants.php 和 public/constants/*.php 已 gitignore — 没有它们应用无法启动，需要为你的环境创建。
application/common.php 约2000行全局辅助函数（auth_code、curl_post 等）— 所有模块都在用。
.env_dev 和 .env_pro 包含真实凭据。.gitignore 列的是 .env，但这两个文件名不在其中。
composer.phar 已提交到仓库 — 系统没有 composer 时可以直接用。
phpunit.xml 引用的 tests/ 目录在仓库中不存在。
application/service/ 中有 _bak 文件（GamePayService_bak.php、MemberCoinService_bak.php）。

禁止操作

禁止启动定时任务 — 不要创建、启动或修改任何 cron / scheduled task（包括 crontab、systemd timer、Windows 计划任务、PHP 定时脚本等）。
禁止执行 php think 命令 — 不要运行仓库内的任何 php think <command>。涉及定时任务、队列消费、数据迁移等操作一律禁止。需要调试或了解某命令行为时，只能阅读源码，不可实际执行。

AGENTS.md 5.2 KB História Raw