# FraudGuard **Repository Path**: lihugh/FraudGuard ## Basic Information - **Project Name**: FraudGuard - **Description**: 专业级智能反欺诈平台 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-06-20 - **Last Updated**: 2026-06-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: Python, JavaScript, CSS, HTML ## README # FraudGuard - 智能反欺诈平台 专业级反欺诈服务平台，采用 Python + FastAPI 后端，React + Vite 前端，具备智能客服、知识库、风险检测等核心功能。 --- ## 📂 项目结构 ``` FraudGuard/ ├── backend/ # 后端项目 │ ├── routers/ # 路由模块 │ │ ├── __init__.py │ │ ├── users.py # 用户认证 │ │ ├── knowledge.py # 知识库 │ │ ├── consultation.py # 智能客服 │ │ └── risk.py # 风险检测 │ ├── config.py # 配置文件 │ ├── database.py # 数据库连接 │ ├── schemas.py # Pydantic 数据模型 │ ├── services.py # 业务逻辑层 │ ├── main.py # FastAPI 入口 │ ├── init_sample_data.py # 初始化示例数据 │ ├── generate_secret_key.py # 生成密钥工具 │ ├── requirements.txt # Python 依赖 │ ├── .env # 环境变量 │ ├── .env.example # 环境变量示例 │ └── learning.db # SQLite 数据库 ├── frontend/ # 前端项目 │ ├── src/ │ │ ├── components/ │ │ │ └── Layout.jsx # 页面布局组件 │ │ ├── contexts/ │ │ │ └── AuthContext.jsx # 用户认证上下文 │ │ ├── pages/ │ │ │ ├── Login.jsx # 登录页 │ │ │ ├── Register.jsx # 注册页 │ │ │ ├── Home.jsx # 首页 │ │ │ ├── Knowledge.jsx # 知识库 │ │ │ ├── Consultation.jsx # 智能客服 │ │ │ └── RiskCheck.jsx # 风险检测 │ │ ├── utils/ │ │ │ └── api.js # API 工具 │ │ ├── App.jsx # 主应用 │ │ └── main.jsx # React 入口 │ ├── index.html # HTML 入口 │ ├── package.json # Node 依赖 │ └── vite.config.js # Vite 配置 ├── docs/ # 学习文档 │ ├── 00-学习大纲/ │ │ └── 00-学习计划.md │ ├── 01-基础搭建/ │ │ ├── 01-Hello-World.md │ │ └── 02-路由与请求.md │ ├── 02-数据模型与验证/ │ │ ├── 01-Pydantic-模型.md │ │ └── 02-数据库入门.md │ ├── 03-项目分层/ │ │ └── 01-分层架构.md │ ├── 04-配置管理/ │ │ ├── 01-配置文件.md │ │ ├── 02-用户认证.md │ │ ├── 03-代码详解.md │ │ └── 04-OAuth2PasswordBearer-vs-APIKeyHeader.md │ ├── 05-功能实现/ │ │ ├── 01-知识库功能.md │ │ ├── 02-智能客服功能.md │ │ └── 03-风险检测功能.md │ ├── 06-前端开发/ │ │ ├── 01-项目初始化.md │ │ ├── 02-核心概念.md │ │ └── 03-部署说明.md │ └── 06-项目总结/ │ └── 01-项目总结与展望.md ├── .gitignore └── README.md ``` --- ## 🎯 核心功能 ### 1. 用户认证系统 - JWT Token 认证 - 密码加密存储（bcrypt） - OAuth2PasswordBearer 安全认证 ### 2. 知识库管理 - 反欺诈知识管理 - 分类和标签系统 - 搜索和过滤 ### 3. 智能客服 - TF-IDF + 余弦相似度匹配 - jieba 中文分词 - 同义词扩展 - 关键词权重系统 ### 4. 风险检测 - 可疑内容风险评估 - 风险关键词检测 - 风险评分（0-100） - 风险等级分类 --- ## 🚀 快速开始 ### 1. 初始化后端 ```powershell cd backend venv\Scripts\activate pip install -r requirements.txt ``` 初始化示例数据： ```powershell python init_sample_data.py ``` 启动后端服务器： ```powershell python -m uvicorn main:app --host 0.0.0.0 --port 8080 --reload ``` 后端 API 文档地址：http://localhost:8080/docs ### 2. 初始化前端 ```powershell cd frontend npm install npm run dev ``` 前端访问地址：http://localhost:3000 --- ## 🔑 测试账号 - 邮箱：demo_user@example.com - 密码：demo123 或者注册一个新账号！ --- ## 📚 学习文档 所有学习笔记都在 `docs/` 文件夹下，按阶段分类整理。 --- ## 🛠️ 技术栈 ### 后端 - **框架**: FastAPI - **数据库**: SQLite - **认证**: JWT + bcrypt - **NLP**: jieba, scikit-learn ### 前端 - **框架**: React 18 - **构建工具**: Vite - **路由**: React Router - **HTTP**: Axios --- ## 📄 许可证 MIT License