1.立项原因：旨在解决什么产品问题
中建相关项目涉及大量客户、项目、合同、收款、催款和附件资料。原有资料可能分散在 Excel、文件夹和人工沟通中，容易出现：
• 客户资料重复或不完整
• 项目与客户关系不清晰
• 合同、收款和催款信息难以统一跟进
• 业务员只能依赖人工汇总数据
• 客户附件和导入资料缺少统一管理
• 不同业务人员之间的数据权限边界不清晰
因此建设中建客户维护系统，将客户、项目、合同、收款、催款和附件资料集中到一个系统中，提高客户管理和项目跟进效率。
2.行业场景与业务背景
系统面向建筑工程、项目型销售和工程服务管理场景，主要服务于：
• 中国建筑相关项目单位
• 客户和服务公司管理
• 工程项目管理
• 合同及回款管理
• 催款和跟进管理
• 业务员数据范围管理
• Excel 客户资料导入导出
• 企业微信、飞书或 Bot 通知提醒
系统核心是围绕“客户—项目—合同—收款—催款”的业务关系进行管理。
2. 功能介绍
具体功能模块
• 用户登录与权限控制
• 客户资料管理
• 客户树形结构
• 项目管理
• 项目分组
• 服务公司管理
• 合同管理
• 收款管理
• 催款管理
• 附件上传和下载
• Excel 客户资料导入
• Excel 数据导出
• 业务员管理
• 数据范围隔离
• 企业微信、飞书和自定义 Webhook 通知
• 系统配置
• 操作日志或运维记录
• 数据库初始化和迁移
• MySQL 备份
• 自动化测试和权限测试
主要功能描述
用户登录后，系统根据角色和业务员数据范围展示对应客户、项目和合同信息。
客户模块支持客户新增、编辑、查询、分组和树形关系展示。项目模块维护项目名称、所属客户、服务公司和项目状态等信息。
合同和收款模块用于记录合同金额、回款情况和相关附件；催款模块用于维护催款进度、跟进记录和提醒信息。
系统支持 Excel 批量导入客户资料，也支持导出客户、项目和业务数据，减少人工重复录入。
通知模块可以推送合同到期、催款跟进和日常提醒，支持手动发送和服务器定时任务调用。
1.我负责的具体任务
• 负责客户需求沟通和业务流程梳理
• 负责客户、项目、合同、收款和催款模块的产品设计
• 负责客户与项目数据结构、字段关系和业务规则设计
• 负责登录认证、角色权限和业务员数据范围隔离
• 负责客户树形结构和项目分组功能实现
• 负责合同、收款、催款和附件管理功能实现
• 负责 Excel 导入、数据校验和 Excel 导出
• 负责企业微信、飞书和自定义 Webhook 通知集成
• 负责接口联调、测试、问题排查和上线维护
• 负责生产环境配置、数据库初始化、迁移和备份流程
• 负责根据客户反馈持续迭代功能和修复线上问题
如果你想突出项目负责人角色，可以写：
负责从客户需求对接、功能规划、技术实现、测试部署到上线维护的完整项目交付。
2.技术栈
• 后端：Python、Flask
• 数据库：MySQL、PyMySQL
• 前端：HTML、CSS、JavaScript
• 部署：Gunicorn、Nginx、Linux
• 数据处理：openpyxl、Excel 导入导出
• 接口与通知：REST API、企业微信 Webhook、飞书 Webhook、自定义 Bot
• 配置：环境变量、生产配置隔离
• 测试：Python unittest、权限测试、核心业务测试
• 运维：MySQL 备份、数据库迁移、日志排查
架构与实现亮点
• 后端采用 Flask 模块化结构，按客户、项目、收款、催款、导入、导出等业务域拆分路由
• 使用 MySQL 保存核心业务数据，保证客户、项目、合同和收款关系的持久化
• 通过角色权限和业务员数据范围实现数据隔离
• 采用环境变量管理生产配置，避免将密码、密钥和生产配置写入代码
• 使用 Gunicorn 提供生产 WSGI 服务，Nginx 负责反向代理和 HTTPS
• 将 Excel 导入、导出和数据校验结合，方便传统业务数据迁移
• 支持通知推送和定时任务，减少人工跟进成本
• 通过数据库迁移、备份脚本和自动化测试提高维护稳定性
难点简述
• 客户、项目、合同、收款和催款之间存在较复杂的业务关联，需要保证数据关系正确
• 不同业务员只能查看授权范围内的数据，需要同时处理角色权限和数据范围权限
• Excel 导入数据格式不统一，需要做字段映射、格式校验、重复数据处理和错误提示
• 合同、收款和催款数据涉及金额和状态变化，需要避免重复提交和状态错误
• 生产环境需要处理配置、密钥、数据库迁移、备份、HTTPS 和权限等问题
• 通知推送存在失败、重复发送和定时任务等情况，需要记录发送结果并支持问题排查
评论