websoft9/docs/PRD.md

需求

从两个主线理解 StackHub 的需求：

• 应用生命周期管理：寻找、安装、发布、停止、卸载、升级等软件全生命周期。
• 基础设施运维管理：安全、存储、文件、容器、监控等系统管理

应用生命周期

业务需求

寻找

用户可以通过两个入口寻找应用：

• 应用商店：采用一级分类的方式展现应用，并支持筛选+搜索的方式以便于用户检索
• Docker 镜像仓库：检索 Docker 镜像仓库，找到对应的应用

安装

• 用户自主安装应用，后端按顺序依次启动目标应用
• 启动应用之前先进行资源约束判断，不符合条件的目标应用不予安装
• 与安装有关的状态：安装中、运行中、安装失败、反复重启、已停止

发布

• 以域名或端口的方式，将运行中的应用发布出去，供外部用户访问。
• 自助设置 HTTPS，上传或更新证书

停止

将应用服务停止

卸载

卸载应用并删除数据

升级

升级应用，如果升级失败会自动回滚到升级之前的状态

恢复

在已有的完整备份的基础，恢复应用。

可能存在两种情况：

• 覆盖现有应用
• 恢复成一个新的应用

克隆

克隆一个已经存在的应用，命名为新应用

技术需求

模板编排

应用的底层编排 100% 以 Docker Compose 语法作为编排语言

多语言

• 前端支持 i18n
• 后端接口支持英文

用户管理

• 支持多个用户，用户角色分为普通用户和管理员用户
• 普通用户可以创建和管理自己的应用，不可以删除他人的应用

UI 自适应

UI 自适应各种屏幕尺寸

2FA

引入一种双重登录策略

商店基础设置

• 商店 Logo 可自定义
• 语言、时区可选
• 绑定域名
• SMTP 信息填写

通知

• SMTP 邮件通知

商店更新

商店支持在线更新提示和在线更新

API

支持生成 API Tokens

CLI

基于 API 的 CLI

仓库管理

默认以 DockerHub 作为镜像仓库，支持自建仓库并同步 DockerHub 镜像

安装程序

一键自动化安装程序，类似：

curl https://websoft9.github.io/StackHub/install/install.sh | bash

主要步骤包括：

1. Check 硬件、操作系统、cpu 架构
2. 安装依赖包
3. 安装 docker
4. 下载各源码包
5. 启动个源码对应服务

基础设施运维

SSH 终端

Web-Based SSH 终端

文件管理器

Web-Based 文件管理器

存储管理

• 支持接入第三方对象存储

备份

备份完整的应用数据：

• 自定义备份时间区间
• 自动备份可取消
• 备份可以管理：删除、下载等

容器管理

可视化的容器管理，包括：拉镜像、创建/删除/停止容器、SSH 进入容器、向容器上传文件等

系统监控

• 监控容器的 CPU，内存和存储消耗情况
• 监控系统的 CPU，内存和存储消耗情况