初始版本

This commit is contained in:
2026-04-23 16:30:57 +08:00
commit 0d0683a6e6
538 changed files with 113042 additions and 0 deletions

View File

@@ -0,0 +1,102 @@
# 开发者中心页面规划
## 规划概述
已在之前对话中完成对 `/developer` 开发者中心页面的完整分析。
## 页面结构13个页面
| 页面 | 文件 | 功能定位 |
|------|------|----------|
| 概览 | `index.vue` | 首页仪表盘 ✅ |
| 应用管理 | `apps.vue` | 创建/管理企业应用 ✅ |
| 发布管理 | `publish.vue` | 应用上架审核 ✅ |
| API Key | `apikeys.vue` | API密钥管理 ✅ |
| 源码与仓库 | `source.vue` | 仓库权限流程 ✅ |
| Git绑定 | `git.vue` | Gitea账号绑定 ✅ |
| 权限申请 | `requests.vue` | 仓库访问申请 ✅ |
| 版本管理 | `versions.vue` | 应用版本发布 ✅ |
| 数据统计 | `analytics.vue` | 数据分析面板 ✅ |
| 支持与反馈 | `support.vue` | 工单/客服 ✅ |
| 开发教程 | `tutorial.vue` | 文档/教程 ✅ |
| 工单系统 | `tickets.vue` | 工单列表 ✅ |
| 应用配置 | `config/[id].vue` | 单个应用配置 ⚠️ |
## 已完成功能增强
1. **统一UI/UX规范** - 所有页面使用统一的 stat-card、panel、page-header 样式
2. **首页(index.vue)** - 已包含欢迎横幅、统计数据、快捷入口、开发者公告、快速帮助、SDK状态
3. **应用管理(apps.vue)** - 完整的创建应用功能和列表展示
4. **数据统计(analytics.vue)** - 核心指标、安装量趋势、收入概览、应用排行、用户活跃、API统计
5. **页面间导航** - 使用统一的导航组件
## 导航分组建议
```
├── 📊 概览 (/developer)
├── 📦 应用
│ ├── 应用管理 (apps)
│ ├── 发布管理 (publish)
│ └── 版本管理 (versions)
├── 🔑 开发资源
│ ├── API Key (apikeys)
│ └── 数据统计 (analytics)
├── 💻 源码
│ ├── 源码与仓库 (source)
│ ├── Git绑定 (git)
│ └── 权限申请 (requests)
└── 🆘 支持
├── 支持与反馈 (support)
├── 工单系统 (tickets)
└── 开发教程 (tutorial)
```
## 资源中心页面resources/
| 页面 | 文件 |
|------|------|
| 资源总览 | `resources/index.vue` |
| 服务器 | `resources/servers.vue` |
| 数据库 | `resources/databases.vue` |
| 云存储 | `resources/storage.vue` |
| 域名管理 | `resources/domains.vue` |
| SSL 证书 | `resources/ssl.vue` |
**注意**resources/ 子页面全部需要 `definePageMeta({ layout: 'developer' })` 才能显示左侧菜单(已修复)。
## Bug 记录
- **2026-03-31 修复**`resources/` 下所有子页面index/servers/databases/storage/domains/ssl缺少 `definePageMeta({ layout: 'developer' })`导致没有左侧导航菜单域名和SSL页面也因此无法正常访问。已全部补齐。
- **2026-03-31 修复**`layouts/developer.vue``isActive()` 使用 `startsWith` 导致父路径 `/developer/resources` 在访问子页面时被同时高亮。改为 `path === to || path.startsWith(to + '/')` 精确匹配。
## 当前状态
所有页面(含 resources/ 6个子页面均已完成开发功能完善layout 正确。
## 资源中心后端 API 接入2026-03-31
所有 resources/ 页面已完整对接后端,使用统一的 `app/appResource` 模块:
| 文件 | resourceType | API 接入 |
|------|-------------|---------|
| `resources/index.vue` | - | `statsAppResource()` + `pageAppResource()` 展示统计与最近资源 |
| `resources/servers.vue` | `server` | CRUD 全部对接 |
| `resources/databases.vue` | `database` | CRUD 全部对接 |
| `resources/storage.vue` | `storage` | CRUD 全部对接 |
| `resources/domains.vue` | `domain` | CRUD 全部对接 |
| `resources/ssl.vue` | `ssl` | CRUD 全部对接 |
**API 位置**`app/api/app/appResource/index.ts`
**后端路径**`/api/app/app//developer-resource/...`
**分页参数**`page` + `limit`(继承自 PageParam
**分页结果**`result.list` + `result.count`
**主键字段**`resourceId`(非 `id`
**通用 Model**`AppResource``resourceType` 字段区分类型
同时修复了所有页面:
- `row-key``"id"` 改为 `"resourceId"`
- `popconfirm` 参数从 `record.id` 改为 `record.resourceId`
- 去除重复的 `definePageMeta/useHead`
## 更新日期
2026-03-31