# rcs

**Repository Path**: trainingEnglish/rcs

## Basic Information

- **Project Name**: rcs
- **Description**: 风控系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-04
- **Last Updated**: 2026-02-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 风控系统 RCS (Risk Control System)

一个现代化的风控规则配置和管理系统,支持规则集、评分卡和可视化流程编排。

## 🎯 项目概述

风控系统RCS是一个企业级的风险控制配置平台,提供三大核心功能模块:

- **规则集管理**: 配置逻辑判断规则,实现复杂的业务规则
- **评分卡管理**: 对用户特征进行加权评分,量化风险等级
- **模型工厂**: 可视化流程编排,组织复杂的风控决策流程

## 🚀 技术栈

### 核心框架

- **Vue 3.5** - 渐进式JavaScript框架
- **TypeScript 5.9** - 类型安全的JavaScript超集
- **Vite 5.4** - 下一代前端构建工具

### UI框架

- **Naive UI 2.43** - Vue 3组件库
- **TailwindCSS 3.4** - 原子化CSS框架
- **Lucide Icons** - 现代化图标库

### 状态管理与路由

- **Pinia 2.3** - Vue官方状态管理库
- **Vue Router 4.6** - Vue官方路由库

### 可视化

- **@antv/x6 2.19** - 图编辑引擎(用于流程编辑器)

### 开发工具

- **ESLint 8.57** - 代码检查工具
- **Prettier 3.8** - 代码格式化工具
- **pnpm 10.11** - 快速的包管理器

## 📦 项目结构

\`\`\`
rcs/
├── .agent/ # Agent配置
│ ├── agents/ # 各Agent配置文件
│ ├── README.md # Agent架构说明
│ ├── SUMMARY.md # 详细总结
│ └── workflow.md # 工作流定义
├── .skills/ # 可复用Skills
│ ├── requirement-doc-generator/
│ ├── dev-rules-generator/
│ ├── multi-agent-architecture/
│ └── README.md
├── docs/ # 文档
│ ├── requirements/ # 需求文档
│ └── development/ # 开发规则
├── public/ # 静态资源
├── src/ # 源代码
│ ├── api/ # API接口
│ ├── assets/ # 资源文件
│ │ └── styles/ # 样式文件
│ ├── components/ # 组件
│ │ └── common/ # 通用组件
│ ├── router/ # 路由配置
│ ├── stores/ # 状态管理
│ ├── types/ # 类型定义
│ ├── utils/ # 工具函数
│ ├── views/ # 页面
│ │ ├── home/ # 首页
│ │ ├── ruleset/ # 规则集模块
│ │ ├── scorecard/ # 评分卡模块
│ │ └── model-factory/ # 模型工厂模块
│ ├── App.vue # 根组件
│ ├── main.ts # 入口文件
│ └── vite-env.d.ts # 环境变量类型
├── .eslintrc.cjs # ESLint配置
├── .prettierrc # Prettier配置
├── .gitignore # Git忽略文件
├── index.html # HTML入口
├── package.json # 项目配置
├── pnpm-lock.yaml # 依赖锁定文件
├── postcss.config.js # PostCSS配置
├── tailwind.config.js # TailwindCSS配置
├── tsconfig.json # TypeScript配置
├── tsconfig.node.json # TypeScript Node配置
└── vite.config.ts # Vite配置
\`\`\`

## 🛠️ 开发指南

### 环境要求

- Node.js >= 18.0.0
- pnpm >= 8.0.0

### 安装依赖

\`\`\`bash
pnpm install
\`\`\`

### 开发

\`\`\`bash

# 启动开发服务器

pnpm dev

# 访问 http://localhost:3000

\`\`\`

### 构建

\`\`\`bash

# 构建生产版本

pnpm build

# 预览生产构建

pnpm preview
\`\`\`

### 代码检查

\`\`\`bash

# ESLint检查

pnpm lint

# TypeScript类型检查

pnpm type-check

# 代码格式化

pnpm format

# 全部检查

pnpm check-all
\`\`\`

## 📚 核心功能

### 1. 规则集管理

- ✅ 规则集列表展示
- ✅ 搜索和筛选
- ✅ 统计卡片
- ✅ 4步向导创建/编辑
  - 基本信息
  - 规则配置(开发中)
  - 执行策略
  - 测试验证(开发中)

### 2. 评分卡管理

- ✅ 评分卡列表展示
- ✅ 搜索和筛选
- ✅ 统计卡片
- ✅ 4步向导创建/编辑
  - 基本信息
  - 算法配置
  - 特征配置(开发中)
  - 测试验证(开发中)

### 3. 模型工厂

- ✅ 规则链列表展示
- ✅ 搜索和筛选
- ✅ 统计卡片
- ✅ 规则链创建
- ✅ 流程编辑器(开发中)
  - 节点库
  - 画布
  - 属性面板

## 🎨 设计系统

项目采用Shadcn UI风格的设计系统:

- **颜色系统**: 使用CSS变量实现主题
- **组件库**: 基于Naive UI + 自定义组件
- **样式方案**: TailwindCSS工具类优先
- **图标**: Lucide Icons
- **响应式**: 移动端、平板、桌面端适配

## 📖 开发规范

项目遵循严格的开发规范,详见 \`docs/development/\`:

- **代码规范** (\`coding-standards.md\`)
- **Git工作流** (\`git-workflow.md\`)
- **组件开发指南** (\`component-guidelines.md\`)
- **代码审查清单** (\`code-review-checklist.md\`)

## 🤖 Agent架构

项目采用多Agent协作开发模式:

- **架构师Agent**: 技术选型、架构设计
- **基础设施Agent**: 项目初始化、环境配置
- **UI/UX设计Agent**: 设计系统、组件样式
- **业务开发Agent**: 业务逻辑、功能实现

详见 \`.agent/README.md\`

## 📊 项目进度

### ✅ 已完成

- [x] 项目初始化和配置
- [x] 基础设施搭建
- [x] 设计系统建立
- [x] 首页
- [x] 规则集列表页
- [x] 规则集创建/编辑页(基础)
- [x] 评分卡列表页
- [x] 评分卡创建/编辑页(基础)
- [x] 模型工厂列表页
- [x] 规则链创建页
- [x] 流程编辑器页面(占位)

### 🚧 开发中

- [ ] 规则编辑器
- [ ] 特征编辑器
- [ ] 流程编辑器(基于@antv/x6)
- [ ] 测试功能
- [ ] 发布功能

### 📅 计划中

- [ ] 用户权限管理
- [ ] 版本管理
- [ ] 审计日志
- [ ] 数据导入导出
- [ ] API文档

## 🔗 相关文档

- [需求文档](./docs/requirements/)
- [开发规则](./docs/development/)
- [Agent配置](./.agent/)
- [Skills](./.skills/)

## 📝 更新日志

### v0.1.0 (2026-01-31)

- 🎉 项目初始化
- ✨ 完成基础设施搭建
- ✨ 实现三大模块的列表页
- ✨ 实现创建/编辑页基础框架
- 📚 完善文档体系

## 👥 贡献者

- Agent (AI开发助手)

## 📄 许可证

MIT License

---

**开发时间**: 2026-01-31  
**当前版本**: v0.1.0  
**开发状态**: 🚧 开发中