项目实战|文契风控
文章目录一、项目前言二、行业痛点与产品定位2.1 市场规模2.2 四大用户核心痛点2.3 目标用户分层2.4 竞品差异化对比三、整体技术架构与技术栈3.1 后端技术Python FastAPI3.2 前端技术Vue3 TS3.3 基础设施四、核心业务模块功能详解4.1 用户安全认证模块P0核心4.2 合同上传与多模态解析4.3 AI智能审核三大核心能力产品核心亮点4.4 AI智能合同修改V1.2新增重磅功能4.5 合同全生命周期管理4.6 合同模板库4.7 订阅与支付商业化体系4.8 AI法律咨询对话4.9 个人数据看板 管理员后台五、非功能性指标与项目验收标准5.1 性能核心指标5.2 安全规范5.3 核心北极星指标产品价值衡量标准六、项目落地成果七、项目不足与未来迭代规划7.1 当前局限7.2 V2.0迭代方向八、总结一、项目前言法律科技LegalTech赛道持续升温但市面上主流合同审核工具大多面向中大型企业定价高、操作复杂普通应届生、自由职业者、10人以下小微企业想审核一份合同找律师动辄300-2000元/份等待周期1-3天普通人根本承担不起。为此我独立完成文契风控全栈项目一款轻量化一站式AI合同智能审核Web平台依托FastAPIVue3前后端分离架构结合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异步ORMAlembic版本迁移缓存/任务队列Redis管理登录Session、异步解析/审核任务AI核心能力OCR识别PaddleOCR支持图片、扫描PDF文字提取法律审核大模型Dify工作流编排搭建专用合同风险识别流水线文件处理Wordpython-docx读写PDFReportLab/WeasyPrint生成审核报告安全体系认证JWT双TokenAccess 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响应时间 ≤500msPDF报告生成 ≤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前端、大模型AI工作流、支付订阅、文件OCR处理等工程技术。项目直击千万小微企业与普通用户合同风控刚需用AI降低法律服务门槛将原本数百元每份的人工审核成本压缩至几分钱同时兼顾数据安全、系统性能与轻量化使用体验适合作为全栈AI垂直赛道实战项目参考。