初始版本

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

213
docs/开发计划.md Normal file
View File

@@ -0,0 +1,213 @@
现在我有了完整的了解。让我为你梳理一下 `/console/apps``/developer` 两个模块的衔接框架设计:
---
## 当前架构分析
### 1. **控制台 (`/console`)** - 面向终端用户
- **定位**:用户购买、订阅、管理已购应用的消费端
- **核心功能**
- 查看已订阅的应用列表
- 进入应用后台管理
- 订单、账单、优惠券管理
- 账号设置
### 2. **开发者中心 (`/developer`)** - 面向开发者
- **定位**:开发者创建、开发、发布应用的生产端
- **核心功能**
- 创建企业自建应用
- API Key 管理
- 源码与仓库权限申请
- 开发教程与文档
### 3. **模板市场 (`/market`)** - 应用展示与分发
- **定位**:应用展示、浏览、购买入口
- 目前只支持"查看详情"和"立即体验",缺少购买/订阅流程
---
## 建议的衔接框架设计
```
┌─────────────────────────────────────────────────────────────────┐
│ 应用生态流转架构 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ 发布/上架 ┌──────────────┐ │
│ │ 开发者中心 │ ──────────────────> │ 模板市场 │ │
│ │ /developer │ │ /market │ │
│ │ │ │ │ │
│ │ • 创建应用 │ │ • 应用展示 │ │
│ │ • 开发插件 │ │ • 插件展示 │ │
│ │ • 提交审核 │ │ • 官方认证 │ │
│ │ • 版本管理 │ │ • 推荐排序 │ │
│ └──────────────┘ └──────┬───────┘ │
│ ^ │ │
│ │ │ 购买/订阅 │
│ │ ▼ │
│ │ ┌──────────────┐ │
│ │ │ 控制台 │ │
│ │ │ /console │ │
│ │ │ │ │
│ │ │ • 我的应用 │ │
│ │ │ • 订单管理 │ │
│ │ │ • 应用配置 │ │
│ │ └──────────────┘ │
│ │ │ │
│ └────────────────────────────────────┘ │
│ 反馈/数据回流 │
│ │
└─────────────────────────────────────────────────────────────────┘
```
---
## 具体衔接方案
### 1. **应用生命周期状态流转**
建议增加 `publishStatus` 字段来区分应用的不同阶段:
| 状态 | 说明 | 可见范围 |
|------|------|----------|
| `developing` | 开发中 | 仅开发者自己 |
| `pending_review` | 待审核 | 开发者 + 平台审核人员 |
| `rejected` | 审核未通过 | 仅开发者自己 |
| `published` | 已上架 | 公开市场可见 |
| `deprecated` | 已下架 | 已购用户仍可用 |
### 2. **开发者中心新增功能**
```typescript
// 建议在 developer-nav.ts 中增加
export const developerNav: DeveloperNavItem[] = [
// ... 现有菜单
// 新增:应用发布管理
{ key: 'developer-publish', label: '发布管理', to: '/developer/publish', icon: '🚀', group: '开发资源', badge: 'NEW' },
{ key: 'developer-versions', label: '版本管理', to: '/developer/versions', icon: '🏷️', group: '开发资源' },
{ key: 'developer-analytics', label: '数据统计', to: '/developer/analytics', icon: '📊', group: '开发资源' },
]
```
### 3. **控制台应用中心增强**
当前 `/console/apps` 只显示用户已创建/协作的应用,建议增加:
- **应用商店入口**:从控制台直接跳转到市场购买
- **已购应用管理**:区分"自建应用"和"购买的应用"
- **应用配置**:对已购插件进行启用/禁用/配置
### 4. **模板市场购买流程**
当前市场只有"查看详情"和"立即体验",需要增加:
1. **价格与订阅模式展示**
2. **购买/订阅按钮**
3. **支付流程**(跳转到控制台订单)
4. **购买后自动添加到控制台应用列表**
---
## 页面结构调整建议
### 开发者中心 (`/developer`)
```
/developer
├── / # 概览(已有)
├── /apps # 我的应用(已有)- 开发中的应用
├── /apikeys # API Key 管理(已有)
├── /source # 源码与仓库(已有)
├── /publish # 【新增】发布管理
│ ├── 提交上架申请
│ ├── 审核状态跟踪
│ └── 上下架操作
├── /versions # 【新增】版本管理
│ ├── 版本列表
│ ├── 发布新版本
│ └── 回滚操作
├── /analytics # 【新增】数据统计
│ ├── 安装量统计
│ ├── 活跃用户
│ └── 收入统计
├── /tutorial # 开发教程(已有)
├── /git # Git 账号绑定(已有)
└── /support # 支持与反馈(已有)
```
### 控制台 (`/console`)
```
/console
├── / # 控制台首页(已有)
├── /apps # 应用中心(增强)
│ ├── 我的应用Tab 1- 已有
│ ├── 应用商店Tab 2- 【新增】嵌入市场或跳转
│ └── 已购应用Tab 3- 【新增】管理购买的应用
├── /products # 已购产品(已有)
├── /orders # 订单记录(已有)
├── /invoices # 发票记录(已有)
├── /coupons # 优惠券(已有)
└── /account # 账号设置(已有)
```
---
## 数据模型建议
```typescript
// 应用表扩展字段
interface CmsWebsite {
// ... 现有字段
// 发布相关
publishStatus: 'developing' | 'pending_review' | 'published' | 'rejected' | 'deprecated'
isPublic: boolean // 是否公开到市场
isPlugin: boolean // 是否为插件(已有 plugin 字段)
priceType: 'free' | 'one_time' | 'subscription'
price: number // 价格(分)
subscriptionPeriod?: 'month' | 'year'
// 统计
installCount: number
rating: number
reviewCount: number
// 开发者信息
developerId: number
developerName: string
}
// 新增:应用订阅表
interface AppSubscription {
id: number
userId: number
websiteId: number
status: 'active' | 'expired' | 'cancelled'
startTime: string
endTime?: string
autoRenew: boolean
}
```
---
## 下一步实施建议
1. **短期1-2周**
-`/market` 增加购买按钮,跳转到 `/console/orders` 下单
-`/console/apps` 增加"应用商店"快捷入口
-`/developer/apps` 增加"提交上架"功能
2. **中期1个月**
- 开发 `/developer/publish` 发布管理页面
- 实现应用审核流程
- 完善订阅/购买数据模型
3. **长期2个月**
- 开发者收益统计
- 应用评分评论系统
- 插件依赖管理
你觉得这个框架设计符合你的预期吗?有哪些部分需要调整或优先实现?