Files
jczxw-pc/app/pages/developer/.workbuddy/memory/MEMORY.md
2026-04-23 16:30:57 +08:00

4.2 KiB
Raw Blame History

开发者中心页面规划

规划概述

已在之前对话中完成对 /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.vueisActive() 使用 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
通用 ModelAppResourceresourceType 字段区分类型

同时修复了所有页面:

  • row-key"id" 改为 "resourceId"
  • popconfirm 参数从 record.id 改为 record.resourceId
  • 去除重复的 definePageMeta/useHead

更新日期

2026-03-31