# Python-3-GentleCollectAI

**Repository Path**: sanxiadaer/python-3-gentle-collect-ai

## Basic Information

- **Project Name**: Python-3-GentleCollectAI
- **Description**: 柔缴智排是支持客户数据导入、用户画像、回款预测、智能排序和文案生成的智能柔性账务提醒平台。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-10
- **Last Updated**: 2026-08-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<figure align="center">
  <img src="./GentleCollectLogo.png" alt="描述" width="20%" />
  <figcaption>GentleCat CAN DO GentleCollect <3</figcaption>
</figure>

# 柔缴智排（GentleCollect AI）

柔缴智排是支持客户数据导入、用户画像、回款预测、智能排序和文案生成的智能柔性账务提醒平台。

## 预览

<figure align="center">
  <img src="./BackEndLogo.png" alt="后端" width="75%" />
  <figcaption>后端功能一览</figcaption>
  <img src="./FrontEndLogo.png" alt="后端" width="75%" />
  <figcaption>前端界面一览</figcaption>
</figure>


## 一键初始化与启动

需要 Python 3.11+、Node.js 20+ 和 npm 10+。首次安装依赖需要联网；安装完成后，默认不需要网络或 API Key。

Windows 双击安装

```Click
点击 setup.cmd
点击 start.cmd
```

Windows PowerShell

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\setup.ps1
powershell -ExecutionPolicy Bypass -File .\scripts\start.ps1
```

Linux/macOS：

```bash
sh scripts/setup.sh
sh scripts/start.sh
```

## 系统总体架构

```mermaid
flowchart TB
    UI[React SPA<br/>Ant Design + ECharts] -->|HTTP /api/v1| API[FastAPI 路由层]
    API --> SVC[Service 业务与事务层]
    SVC --> ML[ML 模块<br/>K-Means / XGBoost / SHAP / 优先级]
    SVC --> NLG[Provider 模块<br/>HybridNLG / OpenAI-compatible]
    SVC --> DB[(SQLite)]
    NLG --> RULE[统一合规规则]
    JOB1[单工作线程训练任务] --> SVC
    JOB2[至多双工作线程候选生成] --> NLG
    UI -.约1秒单飞轮询.-> JOB1
    UI -.约1秒单飞轮询.-> JOB2
```

## 技术栈

| 层次 | 技术 | 在项目中的职责 |
| --- | --- | --- |
| 前端 | React 18、TypeScript 5、Vite 6 | 组件化界面、严格类型、开发与生产构建 |
| UI | Ant Design 5、ECharts 6 | 中文管理后台、表格表单、主题与模型图表 |
| 后端 | FastAPI、Pydantic | HTTP 路由、输入输出校验、稳定错误协议 |
| 数据库 | SQLAlchemy 2、SQLite | ORM、事务、外键级联、单机持久化 |
| 数据与模型 | pandas、NumPy、scikit-learn、XGBoost、SHAP | 预处理、聚类、预测、评估与解释 |
| 测试与质量 | Pytest、Vitest、Testing Library、Ruff、ESLint、Prettier | 回归测试、覆盖率和静态质量门禁 |

## 主要模块

| 模块 | 前端入口 | 后端核心位置 |
| --- | --- | --- |
| 工作台 | `frontend/src/pages/DashboardPage.tsx` | `services/reporting.py`、`services/customer_processing.py` |
| 数据管理与分析 | `CustomersPage.tsx`、`features/data-management/` | `services/customers.py`、`training_jobs.py`、`analysis.py` |
| 智能排序 | `PrioritiesPage.tsx` | `services/analysis.py`、`ml/priority.py` |
| 文案中心 | `MessagesPage.tsx` | `messaging.py`、`message_generation_jobs.py`、`providers/` |
| 处理闭环 | 三个业务页共用 `features/processing/` | `db/models.py::CustomerProcessingTask`、`customer_processing.py` |
| 规则实验室 | `CompliancePage.tsx` | `services/rules.py`、`services/compliance.py` |
| 历史记录 | `HistoryPage.tsx` | `services/config_history.py` |
| 系统设置 | `SettingsPage.tsx`、`features/settings/` | `basic_settings.py`、`prompt_settings.py`、`providers/configuration.py` |