# Fabric 项目规划 v0.1

## 1. 项目目标
**Fabric**：一个可自部署的类 Discord 聊天系统，核心目标是提供稳定、低摩擦的 **Agent 沟通渠道**，并对 OpenClaw 友好。

### MVP 成功标准
- 支持多人频道聊天 + 私聊
- 支持接入 OpenClaw Agent 并在频道内对话
- 支持基础权限与审计日志
- 提供 Docker Compose 一键部署
- 单机可稳定服务 50~200 并发在线（MVP 目标）

## 2. 项目定位（一句话）
> 一个可自部署、类 Discord 的实时聊天系统，原生支持 OpenClaw/Agent 双向协作。

## 3. MVP 必要功能
1. **账号与组织**
   - 用户注册/登录
   - 工作区（Workspace，对标 Discord Guild）
2. **聊天模型（明确范围）**
   - Guild（工作区）
   - Channel（公开/私有频道）
   - DM（1v1 私聊）
   - 消息回复、编辑、删除、@提及
   - **不做 Thread（明确排除）**
3. **实时通信**
   - WebSocket 实时消息推送
   - 在线状态、输入中、消息同步
4. **OpenClaw 集成（核心差异化）**
   - Agent 绑定与配置
   - 可配置路由：频道消息 -> OpenClaw session
   - 消息回写与工具状态展示
   - “工具调用卡片”与审批流（approve/reject）
   - Webhook + Gateway 双模式（MVP 先做 Webhook）
5. **权限与审计**
   - 基础角色（admin/member）
   - 审计日志（关键操作留痕）

## 4. 建议技术栈（v0.1）
- **API**：NestJS（REST + WS）
- **Realtime**：WebSocket Gateway
- **DB**：PostgreSQL
- **Cache/Queue**：Redis（会话态 + 异步任务）
- **Storage**：MinIO（附件，MVP 可选）
- **Deploy**：Docker Compose（app + pg + redis + minio）

## 5. 模块拆分（对应仓库）
- `Fabric.Backend`
  - Auth/Workspace（Guild）
  - Chat Core（Channel、DM、消息；不含 Thread）
  - OpenClaw Integration（Webhook/Gateway、session 路由、回写）
  - Permission & Audit
- `Fabric.Frontend`
  - 工作区/频道 UI
  - 消息流、输入框、回复/编辑/删除/@
  - Agent 状态与工具卡片展示
- `Fabric.OpenclawPlugin`
  - OpenClaw 侧适配与路由配置
  - 会话映射、回执状态、错误处理
- `Fabric.Desktop`
  - Desktop 客户端壳（后续）
- `Fabric.Android`
  - Android 客户端壳（后续）

## 6. 里程碑（6 周参考）
### Week 1：需求冻结 + 架构设计
- PRD 冻结
- 架构图、数据模型、接口草案

### Week 2：基础业务 API
- 登录注册、工作区、频道、消息 REST API
- 基础前端页面（频道列表 + 消息流）

### Week 3：实时通信
- WebSocket 推送
- 在线状态、输入中、消息同步

### Week 4：OpenClaw 集成
- Agent 绑定配置
- 消息路由与回写
- 工具状态卡片（running/success/error）

### Week 5：权限与运维
- 角色权限（admin/member）
- 审计日志
- 健康检查、日志聚合、Compose 完善

### Week 6：稳定性与发布
- 压测与性能调优
- Bug 修复
- MVP 发布文档与部署指南

## 7. 仓库组织
- `Fabric`（主仓库）
  - 挂载子模块：
    - `Fabric.OpenclawPlugin`
    - `Fabric.Backend`
    - `Fabric.Frontend`
    - `Fabric.Desktop`
    - `Fabric.Android`

## 8. 当前状态
- 所有仓库已创建为 Public
- `Fabric.*` 已作为子模块挂载到 `Fabric`
- 本文件为第一版规划，后续按里程碑持续细化