24kycj
88c6ce8ccc
- 迁移为 frontend-web、frontend-electron、backend-web 与 docker 部署结构 - 网页端：订阅门禁二次弹窗、套餐/支付组件化、顶栏分组对齐 - 首页：最近文件与模板库布局优化，缩略图对齐，下载与删除操作 - 新增管理后台、支付与云端文件 API，更新 README 与项目规范 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 :: 同步 API 地址到 deploy-config.js 与 backend local.php（改端口后必跑）
|
||
scripts\start.bat :: 启动
|
||
scripts\start.bat stop :: 停止（保留数据库）
|
||
scripts\start.bat reset :: 停止并清空数据库卷
|
||
```
|
||
|
||
`frontend-web/assets/deploy-config.js` 由 `docker/sync-config.ps1` 根据 `docker/.env` 端口生成，请勿手改 localhost 后提交；生产环境在部署时写入实际 API 地址。
|
||
|
||
| 服务 | 默认地址 |
|
||
|------|----------|
|
||
| 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/assets/deploy-config.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` 为准。
|