项目实战|文契风控
一、项目前言
法律科技(LegalTech)赛道持续升温,但市面上主流合同审核工具大多面向中大型企业,定价高、操作复杂;普通应届生、自由职业者、10人以下小微企业想审核一份合同,找律师动辄300-2000元/份,等待周期1-3天,普通人根本承担不起。
为此我独立完成文契风控全栈项目,一款轻量化一站式AI合同智能审核Web平台,依托FastAPI+Vue3前后端分离架构,结合OCR文本识别、大模型法律分析、异步任务队列、支付订阅体系,解决普通人合同看不懂、改不会、成本高、版本乱四大核心痛点。
本文完整拆解项目背景、产品设计、技术架构、核心功能、落地成果与未来规划。
二、行业痛点与产品定位
2.1 市场规模
国内小微企业超5000万家,每年合同签署总量超10亿份,合同法律服务市场规模达千亿级别;仅1%小微企业转化,就拥有50万精准用户蓝海市场。
2.2 四大用户核心痛点
- 门槛高:普通人看不懂法律条款,劳动合同、合作协议暗藏陷阱;
- 成本贵:专职法务人力成本高,外部律师单份审核几百上千元;
- 处理难:纸质扫描合同无法快速提取文本,人工逐条核对效率极低;
- 无闭环:识别风险后不知道合规修改方案,多轮合同版本混乱难以追溯。
2.3 目标用户分层
| 用户群体 | 人群画像 | 核心诉求 |
|---|---|---|
| 自由职业者 | 25-35岁设计师/开发者/咨询师 | 快速审核客户服务、保密协议 |
| 小微企业主 | 35-50岁10人内企业负责人 | 批量审核用工、采购、租赁合同 |
| 应届毕业生 | 20-25职场新人 | 审核劳动合同、租房合同避坑 |
2.4 竞品差异化对比
| 竞品类型 | 短板 | 文契风控差异化优势 |
|---|---|---|
| 传统律所法务 | 价格贵、响应慢、线下沟通 | 2-5分钟AI自动审核,成本仅几分钱 |
| 通用大模型(豆包/ChatGPT) | 缺少国内法律库、结果无追溯、隐私风险 | 内置《民法典》《劳动合同法》法条,审核记录可留存,文件加密存储 |
| 企业级合同SaaS(法大大) | 定价高、功能冗余、面向大企业 | 轻量化Web端,免费额度可用,个人/小微低门槛 |
| 纯模板网站 | 仅提供文本,无风险识别能力 | 模板+AI审核+智能修改一站式闭环 |
产品定位:面向个人与小微企业的轻量化AI合同风控SaaS平台,实现「模板起草→上传解析→AI风险审核→一键修改→版本管理→报告导出」全链路闭环。
三、整体技术架构与技术栈
项目采用标准前后端分离+容器化部署方案,全流程异步任务处理,保障文件解析、AI审核等长耗时任务不阻塞接口。
3.1 后端技术(Python FastAPI)
- 核心框架:FastAPI(原生异步,自动生成OpenAPI接口文档,P95接口响应≤500ms)
- 数据库:PostgreSQL + SQLAlchemy 2.0异步ORM,Alembic版本迁移
- 缓存/任务队列:Redis,管理登录Session、异步解析/审核任务
- AI核心能力
- OCR识别:PaddleOCR,支持图片、扫描PDF文字提取
- 法律审核大模型:Dify工作流编排,搭建专用合同风险识别流水线
- 文件处理
- Word:python-docx读写
- PDF:ReportLab/WeasyPrint生成审核报告
- 安全体系
- 认证:JWT双Token(Access 2h + Refresh 7d)
- 加密:cryptography RSA签名,合同文件加密存储
- 限流:单用户每分钟20次接口访问限制
- 支付:支付宝沙箱支付,RSA验签防伪造回调
- 部署:Docker + Docker Compose一键启动服务
3.2 前端技术(Vue3 + TS)
- 框架:Vue3 Composition API + TypeScript类型约束
- 构建工具:Vite,开发热更新、打包速度快
- UI组件:Element Plus
- 富文本编辑器:TipTap(合同在线编辑)
- 可视化:ECharts(用户数据看板风险统计)
- 通信:Axios统一封装请求,SSE流式AI对话输出
3.3 基础设施
- 反向代理:Nginx,静态资源托管、端口转发
- 兼容性:全平台响应式,支持PC/手机浏览器访问
四、核心业务模块功能详解
整体产品流程链路:用户认证 → 合同上传解析 → AI智能审核 → 风险可视化 → AI一键修改 → 版本/模板/支付订阅/法律咨询
4.1 用户安全认证模块(P0核心)
- 注册:用户名(唯一不可修改)+手机号+验证码,自动赠送每月3份免费审核额度
- 登录双模式:密码登录 / 短信一键登录(未注册手机号自动创建账号)
- 安全防护:连续5次登录失败锁定10分钟,验证码5分钟有效、60秒重发冷却
- 账号管理:修改头像/昵称/手机号,30天冷静期账号注销机制
- 权限分层:普通免费用户、付费基础/专业版、管理员后台独立权限隔离

4.2 合同上传与多模态解析
- 支持文件格式:docx、PDF、jpg/png扫描件,单文件上限50MB
- 前置额度校验:上传前校验当月剩余审核次数,额度不足直接弹窗引导升级
- 异步解析引擎:
- 纯电子文档30秒内完成文本提取
- 图片/扫描件通过PaddleOCR识别,最长2分钟,识别失败自动重试2次
- 状态全生命周期:待解析→解析中→待审核→审核中→审核完成/失败

4.3 AI智能审核三大核心能力(产品核心亮点)
能力1:分层风险自动识别
AI内置国内完整法律知识库,自动区分三级风险,按高/中/低排序展示:
- 🔴高风险:违约金超标、权责完全不对等、缺失核心履约条款
- 🟡中风险:试用期过长、自动续期无约束、争议管辖偏向对方
- 🟢低风险:信息条款缺失、格式不规范
每条风险自动输出:原文定位+法条依据+通俗风险解释+可直接复用修改示例
能力2:原文高亮 能力2:原文高亮可视化展示
合同预览区自动标红/黄/蓝标记风险段落,点击风险条目自动滚动定位原文,无需人工逐行查找。支持自定义风险标签(需修改/已协商/忽略等5种状态),可添加个人备注存档。
能力3:一键生成PDF审核报告
审核完成可导出标准化PDF存档,包含封面、风险总览、逐条风险分析、综合建议、AI免责声明,10秒内完成生成。
4.4 AI智能合同修改(V1.2新增重磅功能)
区别于普通仅给建议的工具,本项目支持AI自动重写合规条款:
- 五阶段进度可视化:准备→风险二次分析→智能改写→差异对比→完成
- 左右分栏Diff视图:删除红色划线、新增绿色高亮,直观查看改动
- 一键应用修改,自动生成新版本,完整保留原始合同不覆盖

4.5 合同全生命周期管理
- 版本管理:同一合同支持多轮上传,自动生成V1/V2/V3版本,任意两版差异对比
- 在线富文本编辑:TipTap编辑器直接修改合同内容,保存自动新建版本
- 多格式导出:txt纯文本、docx Word、PDF(废弃HTML格式)
- 回收站软删除:删除合同进入30天冷静期,超时永久清除,防止误操作
4.6 合同模板库
内置10套法务校验标准模板:劳动合同、租房合同、采购合同、保密协议等;
- 模板免费预览、下载Word本地修改;
- 「一键审核」功能直接上传模板生成审核报告(消耗月度额度)。

4.7 订阅与支付商业化体系
采用订阅制分层套餐,免费获客+付费转化闭环:
| 套餐 | 月额度 | 核心权益 |
|---|---|---|
| 免费版 | 3份 | 基础AI审核、PDF报告、模板浏览,无AI咨询/数据看板 |
| 基础版(19元) | 20份 | 深度风险识别、AI法律咨询、个人数据看板 |
| 专业版(99元) | 100份 | 100份 |
支付流程:支付宝沙箱模拟真实交易,30分钟订单超时自动关闭;支付成功实时刷新当月审核额度,额度每月1号自动重置,上月余量不结转。
4.8 AI法律咨询对话
- SSE流式输出,多轮对话保存最近20轮上下文;
- 可绑定当前合同,AI结合合同内容针对性答疑;
- 预置4类高频快捷问题:租房/劳动/借款合同咨询;
- 严格拒答策略:不生成完整合同、不提供诉讼法律意见,底部永久展示AI免责声明。

4.9 个人数据看板 & 管理员后台
- 用户看板(付费可用):近30天上传趋势、风险分布饼图、月度额度使用进度;
- 管理员后台:用户/合同/模板/订单全量管理,可禁用违规账号、处理退款;遵循隐私原则,管理员默认无法查看用户合同原文。

五、非功能性指标与项目验收标准
5.1 性能核心指标
- 系统月度可用性 ≥99.5%
- AI审核平均耗时:2-5分钟/份
- 接口P95响应时间 ≤500ms
- PDF报告生成 ≤10秒
- AI对话首条响应 ≤5秒
5.2 安全规范
- 传输全程HTTPS,数据库敏感字段脱敏存储;
- JWT无状态鉴权,RBAC角色权限隔离;
- 接口、短信、AI对话多级限流防刷;
- 所有用户合同加密存储,支持主动删除销毁数据。
5.3 核心北极星指标(产品价值衡量标准)
每份合同平均识别≥2条风险(至少1条中高风险),作为平台核心价值判断依据。
六、项目落地成果
- 完整可交付产品:从PRD需求文档、PPT答辩材料、前后端代码、容器部署方案全套产出,版本迭代至V1.3,移除邮箱登录、企业定制版、HTML导出等不符合沙箱场景功能;
- 完整业务闭环:实现免费引流-付费转化-合同审核-智能修改-法律咨询全链路商业逻辑;
- 多技术落地实践:异步任务队列、OCR文档解析、大模型工作流编排、SSE流式对话、JWT双Token、支付宝支付对接、数据可视化;
- 完善测试验收体系:覆盖认证、审核、支付、后台全模块验收标准,灰度内测方案(内部种子用户→公测100人→全量发布);
- 风险可控机制:制定线上故障分级回滚方案、AI回答拒答策略、用户数据隐私保护规则。
七、项目不足与未来迭代规划
7.1 当前局限
- 仅支持Web网页端,无移动端App;
- 支付仅接入支付宝沙箱,暂未支持微信支付;
- 无多人团队协作功能,仅面向个人用户;
- 未对接电子签章、CA存证能力。
7.2 V2.0迭代方向
- 新增团队协作版,支持企业多人共享额度、合同协同;
- 接入正式支付渠道(微信支付);
- 对接第三方电子签约平台,实现审-签一体化;
- 开放API接口,支持小微企业内部系统对接;
- 拓展更多行业垂直合同模板(电商、工程、加盟协议);
- 引入用户反馈迭代AI风险模型,降低误判率至10%以内。
八、总结
文契风控是一套完整落地的LegalTech SaaS实战项目,既覆盖产品需求设计、用户场景拆解、竞品差异化定位,又完整落地Python异步后端、Vue3前端、LangGraph+LangChain+RAG全栈AI架构(三模块共享同一RAG法律知识层,BGE-M3+Chroma)、支付订阅、文件OCR处理等工程技术。
项目直击千万小微企业与普通用户合同风控刚需,用AI降低法律服务门槛,将原本数百元每份的人工审核成本压缩至几分钱,同时兼顾数据安全、系统性能与轻量化使用体验,适合作为全栈+AI垂直赛道实战项目参考。
更多推荐




所有评论(0)