# contentflow-cloud

**Repository Path**: huiGod/contentflow-cloud

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-22
- **Last Updated**: 2025-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ContentFlow Cloud

> Node.js 云端RPA集群 - ContentFlow RPA 系统的大规模并发执行引擎

[![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
[![Playwright](https://img.shields.io/badge/Playwright-1.40+-blue.svg)](https://playwright.dev/)
[![Docker](https://img.shields.io/badge/Docker-Ready-blue.svg)](https://www.docker.com/)
[![Kubernetes](https://img.shields.io/badge/Kubernetes-Ready-blue.svg)](https://kubernetes.io/)

## 🎯 项目概述

ContentFlow Cloud 是 ContentFlow RPA 系统的云端执行引擎，基于 Node.js + Playwright 构建，提供大规模并发的内容发布自动化服务。支持容器化部署、自动扩缩容和分布式任务调度。

### ✨ 核心特性

- 🔄 **代码共享架构** - 一次编写，多环境运行
- 💾 **智能存储系统** - 多策略存储，自动降级
- 🖼️ **AI图片处理** - 智能分析，平台适配
- 🤖 **RPA自动化** - 跨平台内容发布
- 📱 **多端支持** - 插件、Web、移动端
- 🔐 **完整认证** - JWT + RBAC权限控制
- 👥 **会员管理** - 套餐权益，订阅管理

## 🏗️ 系统架构

```mermaid
graph TB
    subgraph "用户层"
        U1[内容创作者]
        U2[系统管理员]
        U3[运营人员]
    end
    
    subgraph "前端应用层"
        SF[sword-front<br/>Vue3 + Element Plus<br/>Web管理界面]
        RP[rpa-plugin<br/>Chrome Extension<br/>浏览器插件]
    end
    
    subgraph "共享库层"
        CS[contentflow-shared<br/>NPM包<br/>核心业务逻辑]
    end
    
    subgraph "后端服务层"
        SB[sword-backend<br/>Spring Boot<br/>API服务 + 认证授权]
        CC[contentflow-cloud<br/>Node.js + Playwright<br/>云端RPA执行集群]
    end
    
    subgraph "数据存储层"
        DB[(MySQL<br/>业务数据)]
        RD[(Redis<br/>缓存 + 会话)]
        OS[(云存储<br/>OSS/七牛)]
    end
    
    subgraph "外部平台"
        WX[微信公众号]
        TT[头条号]
        ZH[知乎]
        WB[微博]
    end
    
    %% 用户交互
    U1 --> SF
    U1 --> RP
    U2 --> SF
    U3 --> SF
    
    %% 前端依赖
    SF --> CS
    RP --> CS
    SF --> SB
    
    %% 后端依赖
    SB --> DB
    SB --> RD
    CC --> CS
    CC --> OS
    
    %% 共享库功能
    CS --> OS
    
    %% RPA执行
    RP --> WX
    RP --> TT
    RP --> ZH
    RP --> WB
    CC --> WX
    CC --> TT
    CC --> ZH
    CC --> WB
    
    %% 数据流
    SF -.->|任务调度| CC
    RP -.->|数据同步| SB
```

## 📦 项目结构

### 核心项目

| 项目 | 技术栈 | 功能定位 | 状态 |
|------|--------|----------|------|
| [sword-backend](./sword-backend/) | Spring Boot 2.7.18 | 后端API服务 + 认证授权 | ✅ 完成 |
| [sword-front](./sword-front/) | Vue 3 + Element Plus | Web管理界面 | 🔄 开发中 |
| [contentflow-shared](./contentflow-shared/) | TypeScript + NPM | 跨环境共享库 | ✅ 完成 |
| [rpa-plugin](./rpa-plugin/) | Chrome Extension | 浏览器插件 | ✅ 完成 |
| [contentflow-cloud](./contentflow-cloud/) | Node.js + Playwright | 云端RPA集群 | 🔄 开发中 |

### 项目依赖关系

```mermaid
graph TD
    subgraph "NPM依赖"
        CS[contentflow-shared<br/>@contentflow/shared]
    end
    
    subgraph "前端项目"
        SF[sword-front<br/>Vue3 Web应用]
        RP[rpa-plugin<br/>Chrome扩展]
    end
    
    subgraph "后端项目"
        SB[sword-backend<br/>Spring Boot API]
        CC[contentflow-cloud<br/>Node.js RPA集群]
    end
    
    %% NPM依赖关系
    SF -->|npm install| CS
    RP -->|npm install| CS
    CC -->|npm install| CS
    
    %% API调用关系
    SF -->|HTTP API| SB
    RP -.->|可选同步| SB
    SF -.->|任务调度| CC
    
    %% 数据流向
    CS -->|存储抽象| SF
    CS -->|RPA逻辑| RP
    CS -->|RPA逻辑| CC
    
    style CS fill:#e1f5fe
    style SF fill:#f3e5f5
    style RP fill:#e8f5e8
    style SB fill:#fff3e0
    style CC fill:#fce4ec
```

## 🚀 快速开始

### 环境要求

- **Node.js** >= 16.0.0
- **pnpm** >= 7.0.0 (必须使用 pnpm)
- **Java** >= 8
- **MySQL** >= 8.0
- **Redis** >= 6.0
- **Chrome** >= 88.0

### 安装和运行

#### 1. 克隆项目
```bash
git clone <repository-url>
cd contentflow-rpa-system
```

#### 2. 安装共享库
```bash
cd contentflow-shared
pnpm install
pnpm build
```

#### 3. 启动后端服务
```bash
cd sword-backend
mvn clean install
mvn spring-boot:run
```

#### 4. 启动Web界面
```bash
cd sword-front
pnpm install
pnpm dev
```

#### 5. 构建浏览器插件
```bash
cd rpa-plugin
pnpm install
pnpm build
```

### 插件安装

1. 打开 Chrome 浏览器
2. 访问 `chrome://extensions/`
3. 开启"开发者模式"
4. 点击"加载已解压的扩展程序"
5. 选择 `rpa-plugin/dist` 目录

## 🔄 业务流程

```mermaid
sequenceDiagram
    participant U as 用户
    participant SF as sword-front
    participant RP as rpa-plugin
    participant CS as contentflow-shared
    participant SB as sword-backend
    participant CC as contentflow-cloud
    participant P as 发布平台
    
    Note over U,P: 内容创作和发布流程
    
    U->>SF: 1. 登录Web管理界面
    SF->>SB: 2. 用户认证
    SB-->>SF: 3. 返回JWT令牌
    
    U->>SF: 4. 创建内容
    SF->>CS: 5. 使用编辑器组件
    CS-->>SF: 6. 富文本编辑功能
    
    U->>RP: 7. 安装并使用插件
    RP->>CS: 8. 加载RPA逻辑
    CS-->>RP: 9. 平台适配器
    
    alt 本地发布模式
        RP->>CS: 10a. 执行RPA逻辑
        CS->>P: 11a. 自动发布内容
        P-->>CS: 12a. 发布结果
        CS-->>RP: 13a. 返回结果
    else 云端发布模式
        SF->>CC: 10b. 提交发布任务
        CC->>CS: 11b. 执行RPA逻辑
        CS->>P: 12b. 自动发布内容
        P-->>CS: 13b. 发布结果
        CS-->>CC: 14b. 返回结果
        CC-->>SF: 15b. 任务完成通知
    end
    
    RP->>SB: 16. 同步发布记录(可选)
    SB-->>RP: 17. 确认同步
```

## 📋 项目详细说明

### 🎯 sword-backend (后端核心)
**定位**: 系统的数据和业务中枢

- **技术栈**: Spring Boot 2.7.18 + MyBatis-Plus + MySQL + Redis
- **核心模块**:
  - `sword-common`: 公共基础设施 (统一响应、异常处理、工具类)
  - `sword-auth`: 认证授权模块 (JWT + RBAC + 安全防护)
  - `sword-member`: 会员管理模块 (套餐管理 + 权益系统)
  - `sword-server`: 应用启动模块
- **主要功能**:
  - 用户认证和权限控制
  - 会员套餐和权益管理
  - RESTful API服务
  - 数据持久化和缓存

**快速开始**: [sword-backend/README.md](./sword-backend/README.md)

### 🌐 sword-front (Web管理界面)
**定位**: 系统的Web端管理控制台

- **技术栈**: Vue 3 + Element Plus + Vite + TypeScript + Pinia
- **主要功能**:
  - 用户管理和数据运维
  - 内容创作和管理界面
  - RPA任务调度和监控
  - 系统配置和统计分析
  - 会员管理和权益配置
- **集成方式**:
  - 通过HTTP API调用sword-backend
  - 通过NPM依赖使用contentflow-shared

**快速开始**: [sword-front/README.md](./sword-front/README.md)

### 🔧 contentflow-shared (共享核心库)
**定位**: 跨环境的核心业务逻辑库

- **技术栈**: TypeScript + Rollup + Jest + NPM包
- **核心模块**:
  - **内容编辑器**: 基于Tiptap的富文本编辑器
  - **存储适配器**: 多环境存储抽象 (浏览器/Node.js/云存储)
  - **平台适配器**: 多平台RPA逻辑 (微信/头条/知乎等)
  - **图片处理引擎**: 智能压缩和格式转换
  - **工具模块**: 环境检测、日志记录、数据验证
- **环境支持**: 浏览器、浏览器扩展、Node.js
- **发布方式**: NPM包 `@contentflow/shared`

**详细文档**: [contentflow-shared/README.md](./contentflow-shared/README.md)

### 🚀 rpa-plugin (浏览器插件)
**定位**: 用户端的内容发布工具

- **技术栈**: Chrome Extension (Manifest V3) + Vue 3 + TypeScript + Webpack
- **主要功能**:
  - 内容编辑和实时预览
  - 多平台自动发布
  - 本地存储管理
  - 用户界面交互
  - 平台适配和反检测
- **依赖关系**: 通过NPM依赖使用contentflow-shared
- **支持平台**: 微信公众号、头条号、知乎、微博等

**安装指南**: [rpa-plugin/README.md](./rpa-plugin/README.md)

### ☁️ contentflow-cloud (云端RPA集群)
**定位**: 大规模并发的云端RPA执行引擎

- **技术栈**: Node.js + Playwright + Docker + Kubernetes
- **主要功能**:
  - 无头浏览器自动化
  - 任务队列管理和调度
  - 集群自动扩缩容
  - 性能监控和优化
  - 分布式任务执行
- **依赖关系**: 通过NPM依赖使用contentflow-shared
- **部署方式**: 容器化部署，支持云原生

**部署指南**: [contentflow-cloud/README.md](./contentflow-cloud/README.md)

## 🔗 关键关联关系

### 技术关联
- **代码复用**: 通过contentflow-shared实现核心RPA逻辑的跨环境复用
- **类型安全**: 统一的TypeScript类型定义确保接口一致性
- **环境适配**: 自动检测运行环境并选择合适的实现策略

### 业务关联
- **统一认证**: sword-backend提供JWT认证，所有前端应用统一鉴权
- **数据同步**: 插件可选择性地将发布记录同步到后端
- **任务调度**: Web界面可以调度云端RPA集群执行发布任务

### 用户关联
- **双模式支持**:
  - **本地模式**: 用户直接使用浏览器插件进行发布
  - **云端模式**: 通过Web界面调度云端集群批量发布
- **权限管理**: 基于RBAC的细粒度权限控制
- **会员体系**: 支持不同套餐的功能权益管理

## 🛠️ 开发规范

### 代码规范
- **语言**: TypeScript优先，Java 8+
- **包管理**: 统一使用pnpm
- **代码风格**: ESLint + Prettier
- **提交规范**: Conventional Commits

### 文档规范
- **API文档**: 使用OpenAPI 3.0规范
- **代码注释**: JSDoc/JavaDoc格式
- **架构文档**: Mermaid图表
- **变更日志**: Keep a Changelog格式

### 测试规范
- **单元测试**: Jest (前端) + JUnit (后端)
- **集成测试**: Playwright
- **覆盖率要求**: > 80%

详细规范请参考: [开发规范文档](./.kiro/steering/)

## 📊 项目状态

### 完成功能 ✅
- **sword-backend**: 认证授权模块、会员管理模块
- **contentflow-shared**: 存储适配器、平台适配器、编辑器组件
- **rpa-plugin**: 基础插件框架、内容脚本、用户界面

### 开发中 🔄
- **sword-front**: Web管理界面完善
- **contentflow-cloud**: 云端RPA集群实现
- **系统集成**: 各模块间的完整集成测试

### 计划功能 📋
- **AI增强**: 内容智能优化和推荐
- **移动端**: React Native移动应用
- **监控告警**: 完整的运维监控体系
- **多租户**: SaaS化部署支持

## 🤝 贡献指南

### 开发环境搭建
1. 确保安装所有环境要求
2. 按照快速开始指南设置各项目
3. 阅读相关项目的开发文档
4. 运行测试确保环境正常

### 提交流程
1. Fork项目并创建功能分支
2. 编写代码并添加测试
3. 确保所有测试通过
4. 提交Pull Request

### 问题反馈
- **Bug报告**: 使用Issue模板提交
- **功能请求**: 详细描述需求和使用场景
- **技术讨论**: 参与Discussions讨论

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 📞 支持

如果您在使用过程中遇到问题：

1. **查看文档**: 首先查阅相关项目的README和文档
2. **搜索Issue**: 查看是否有类似问题已被报告
3. **提交Issue**: 使用模板提交新的问题报告
4. **联系维护者**: 通过邮件或其他方式联系项目维护者

---

**ContentFlow RPA - 让内容发布变得简单高效！** 🚀