24kycj
152228d41f
- 页面直接引用 local.js 设置 SOON_DEPLOY_CONFIG，移除 deploy-config - Docker sync-config 生成 local.js；更新 README 与 agent-core 说明 - 模板库自动扫描 .soon；新增后端部署/种子/排查脚本 - 完善支付配置、订阅弹窗与后台支付管理页 Co-authored-by: Cursor <cursoragent@cursor.com>
52 lines
2.1 KiB
Markdown
52 lines
2.1 KiB
Markdown
# SoonDesign
|
||
|
||
卡片/光盘设计工具：Electron 桌面端 + Web 端 + PHP 后端。
|
||
|
||
## 目录
|
||
|
||
| 目录 | 说明 |
|
||
|---|---|
|
||
| [frontend-electron/](frontend-electron/) | 桌面程序 |
|
||
| [frontend-web/](frontend-web/) | Web 前端 |
|
||
| [backend-web/](backend-web/) | PHP API |
|
||
| [docker/](docker/) | 本地 Docker 编排（非生产部署） |
|
||
|
||
## 本地开发
|
||
|
||
需 [Docker Desktop](https://www.docker.com/products/docker-desktop/)。
|
||
|
||
```bat
|
||
docker\sync-config.ps1 :: 同步 local.js 与 backend local.php（改端口后必跑）
|
||
scripts\start.bat :: 启动
|
||
scripts\start.bat stop :: 停止（保留数据库）
|
||
scripts\start.bat reset :: 停止并清空数据库卷
|
||
```
|
||
|
||
生产环境编辑 `frontend-web/config/local.js`（从 `config/local.js.example` 复制）；全量更新 frontend 时不要覆盖该文件。本地开发由 `docker/sync-config.ps1` 生成 `local.js`。
|
||
|
||
| 服务 | 默认地址 |
|
||
|------|----------|
|
||
| Web | http://localhost:8100/pages/index.web.html |
|
||
| Admin 登录 | http://localhost:8100/pages/admin/login.html |
|
||
| Admin 后台 | http://localhost:8100/pages/admin/index.html |
|
||
| Electron 静态 | http://localhost:8101/pages/index.html |
|
||
| API | http://localhost:8102/health |
|
||
|
||
端口在 `docker/.env` 修改（默认 8100/8101/8102）。测试管理员：`admin@local.test` / `admin123`（仅 `role=admin` 可进入管理后台）。
|
||
|
||
管理后台模块：概览、用户（详情/启停）、订单筛选、套餐、系统设置、审计日志、支付密钥上传。
|
||
|
||
桌面窗口（可选）：`cd frontend-electron && npm install && npm start`
|
||
|
||
## 生产部署
|
||
|
||
- Web 根目录：`frontend-web/`
|
||
- PHP 根目录：`backend-web/public/`
|
||
- 数据库：导入 `backend-web/schema.sql`
|
||
- 后端：`backend-web/config/local.php.example` → `local.php`
|
||
- 前端 API：`frontend-web/config/local.js`（生产配置，勿覆盖）
|
||
|
||
支付与 notify 说明见 [docs/PAYMENT.md](docs/PAYMENT.md)。列表分页契约见 [docs/API-PAGINATION.md](docs/API-PAGINATION.md)。
|
||
|
||
`frontend-electron/js/design1-back.js`、`design2-back.js` 等为历史参考快照，页面勿引用；功能对齐请以当前 `frontend-web` / `frontend-electron` 为准。
|