# fabu

**Repository Path**: zhouzhu_code/fabu

## Basic Information

- **Project Name**: fabu
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-19
- **Last Updated**: 2026-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Fabu · AI 智能发版平台

深色科技感（Linear/Vercel 风）的全栈智能发布管理平台：Git 仓库接入、SSH 真实部署、AI 驱动发版说明生成 / 风险分析 / 部署脚本生成与安全检测 / 智能回滚建议 / AI 发版助手，内置 RBAC 用户与项目权限体系。

## 功能总览

- **权限体系**：管理员/成员两级角色；按项目授权（DEPLOYER 可发版 / VIEWER 只读）；服务端全链路鉴权
- **发版向导**：选择提交 → AI 生成 Release Notes + 风险分析 → 审批 → AI 生成部署脚本 + 双层安全检测 → 确认发布
- **真实部署**：SSH 远程执行（base64 脚本注入）、SSE 实时日志终端、环境级部署锁、一键回滚
- **AI 能力**：发版说明、风险评估、脚本生成、脚本安全复审、异常检测与回滚建议、对话式 AI 助手
- **看板**：成功率 / 发布频次 / 耗时指标、14 天趋势图、最近发布动态（均按权限过滤）

## 技术栈

Next.js 16 (App Router) · TypeScript · Tailwind CSS v4 · shadcn/ui (Base UI) · Framer Motion · Prisma 6 + PostgreSQL 16 · jose (JWT) · bcryptjs · simple-git · node-ssh · OpenAI 兼容 LLM API

## 快速开始

```bash
# 1. 启动 PostgreSQL（需要 Docker）
docker compose up -d

# 2. 配置环境变量
cp .env.example .env   # 按需修改

# 3. 建表 + 种子数据
npm run db:migrate
npm run db:seed

# 4. 启动开发服务
npm run dev
```

打开 http://localhost:3000 ，默认账号：

| 账号 | 密码 | 角色 |
|------|------|------|
| admin | admin123456 | 管理员 |
| zhangwei | fabu123456 | 成员（电商中台可发版） |
| lina | fabu123456 | 成员（只读） |

## 环境变量

| 变量 | 说明 |
|------|------|
| DATABASE_URL | PostgreSQL 连接串 |
| LLM_BASE_URL / LLM_API_KEY / LLM_MODEL | OpenAI 兼容 LLM 端点（兜底方式；推荐在「设置 → AI 引擎」页面配置，即时生效且优先于环境变量；不配置则 AI 功能降级为模板） |
| APP_SECRET | SSH 凭证 AES-256-GCM 加密密钥 |
| JWT_SECRET | 会话签名密钥 |
| ADMIN_INITIAL_PASSWORD | 种子管理员初始密码 |
| REPOS_DIR | Git 仓库本地缓存目录（默认 ./.repos） |

## 安全说明

- SSH 私钥/密码入库前 AES-256-GCM 加密，任何 API 不返回明文
- 密码 bcrypt 哈希；登录失败不区分用户不存在/密码错误
- 所有写接口逐一经 requireAuth / requireAdmin / requireProjectAccess 鉴权
- AI 生成的部署脚本执行前经「静态黑名单扫描 + AI 复审」双层检测，需人工确认
- 部署/回滚等破坏性操作需二次确认；同环境部署互斥