# 开发者中心页面规划

## 规划概述

已在之前对话中完成对 `/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
