开发文档

本地开发

后端、前端与本地网关在开发机上的启动方式。

运行前提

当前仓库包含 PHP、Node、Go 和 Python 组件，本地开发前建议先确认：

PHP 8.1+
Node 20+
pnpm
MySQL / Redis
Docker（如需跑本地网关容器）
Go 与 Python 3.11（如需脱离 Docker 调试网关）

云端后台

常用命令：

composer install
cp .env.example .env
php bin/hyperf.php start

开发态可用：

composer dev

前端

cd web
pnpm install
pnpm dev

本地网关

推荐先使用 Docker Compose：

cd local-gateway
cp .env.example .env
docker compose up -d --build

如果要分进程调试：

cd local-gateway/worker-py
python3 run_server.py

另开终端：

cd local-gateway/gateway-go
LOCAL_GATEWAY_WORKER_BASE_URL=http://127.0.0.1:9802 go run ./cmd/server

测试入口

composer test
cd web && pnpm test:e2e
cd local-gateway/gateway-go && go test ./...
cd local-gateway && python3 -m unittest discover -s worker-py/tests