# SSE-Deploy

**Repository Path**: xindonhub/sse-deploy

## Basic Information

- **Project Name**: SSE-Deploy
- **Description**: 软工基建项目，部署测试平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-09
- **Last Updated**: 2026-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# devhub · 软工集市统一开发者平台

部署台（deploy）+ 开发者平台（developer）+ AI API 平台（platform）三平台合并重构，运行于腾讯云集市机，域名沿用 **deploy.ssemarket.cn**。底层算力由集市云 SSEINFRA（cloud.ssemarket.cn，本次不动）提供。

设计与迁移方案见 [docs/三平台整合设计文档.md](docs/三平台整合设计文档.md)。

## 当前状态：M0 骨架

已落地：

- 统一登录：集市 OAuth（一步换票 code+state → JWT）
- 权限核心：全局角色 admin/developer/user（admin 全权限零阻挡）+ 资源三档 owner/maintainer/member + 例外直授（仅 allow）
- 项目域最小闭环：创建（developer 自助）、列表、详情、申请加入（一人可加入多项目）、成员展示
- 统一审批中心：`applications` 单表多 type，当前接入 `join_project`（项目 owner/maintainer 或 admin 审批；admin 发起的动作免审）
- 双界面壳：开发者界面 + 管理台界面（同一账号切换）
- 管理台：总览 / 用户与角色 / 审计日志
- SQLite 基座（`devhub.db`，WAL），schema v1

M2-M3 待迁入：模块统一实体与部署流水线、域名与网关、Gitee 代建仓库、项目密钥（sk-proj-，默认 qwen）、模型网关、SM2 机器身份、需求平台、运维域。

## 结构

```
apps/api    Express + TS + better-sqlite3   （端口 3010，M2 切换时接管 3002）
apps/web    Vue3 + Vite + Element Plus + Pinia + TanStack Query
docs/       设计文档
```

## 开发

```bash
npm install                # 根目录（workspaces）
npm run dev:api            # API  :3010，读 apps/api/.env
npm run dev:web            # Web  :5173，/api 代理到 :3010
```

`apps/api/.env` 参考 `.env.example`：集市 OAuth 应用凭证（可复用原 deploy 应用，redirect
`https://deploy.ssemarket.cn/oauth/callback` 不变）、`JWT_SECRET`、`SEED_ADMIN_OAUTH_IDS`（初始管理员集市 id，逗号分隔，登录自动抬权）。

## 构建与部署（集市机）

```bash
npm run build              # api → dist/，web → dist/
cd apps/api && DATA_DIR=... STATIC_DIR=../web/dist node dist/index.js
```

生产入口：nginx `deploy.ssemarket.cn` → 本服务（当前 sdpy-api 仍占用 :3002，devhub 开发期跑 :3010，M2 割接时切换）。

## 约定

- API 响应统一 `{code, message, data}`；鉴权 `Authorization: Bearer <JWT>`
- 权限判定一律走 `core/permissions.ts` 的 `permit()`，不在路由里散写角色判断
- 所有状态变更写 `audit_logs`
- 审批流一律入 `applications`（type 区分），admin 发起免审并记 `auto_approved_by_role`
- 历史：本仓库保留旧部署台全部 git 历史（基线 b7c116c 清空提交之前），需要旧代码随时可 checkout