Files
tiantian-system/docs/开发计划.md
2026-04-08 17:10:58 +08:00

214 lines
8.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

现在我有了完整的了解。让我为你梳理一下 `/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个月**
- 开发者收益统计
- 应用评分评论系统
- 插件依赖管理
你觉得这个框架设计符合你的预期吗?有哪些部分需要调整或优先实现?