简介这是一套基于 ASP.NETC#开发的客户关系管理系统CRM源码面向具备一定 .NET 基础、希望学习或二次开发企业级管理系统的开发者与计算机专业学生。系统围绕客户信息维护、客户分配与流转、流失客户管理、反馈与投诉处理等典型 CRM 业务场景展开涵盖登录、客户编辑、客户分配服务、构成管理、管理员设置等模块可帮助读者理解分层架构与业务逻辑的组织方式。压缩包共 297 个文件以 100 个 cs 源码文件、38 个 aspx 页面、32 个 dll 程序集为主辅以 gif、jpg 界面素材及 txt 说明、csproj 项目文件、sln 解决方案与数据库文件整体约 1.15MB结构完整、便于按模块查阅。目前已有 441 人学习下载适合作为课程设计、毕业设计参考或 CRM 类项目入门练手素材读者可从中获取页面与后台代码的对应关系、数据库表结构及常见业务实现思路。1. 接手一套 ASP.NET CRM 源码先搞清楚它到底能跑什么业务朋友公司去年上了一套客户关系管理系统销售团队用着还行但老板想加个“客户跟进超时自动提醒”外包报价五位数。他转头把源码包丢给我“你帮我看看能不能自己改。”我打开一看ASP.NET WebForms 那一套C# 后端加 SQL Server典型的十多年前企业信息化项目骨架。这类 CRM 源码包在网上的流通量很大但真正能跑起来、能改动的没几个——要么数据库脚本缺失要么依赖的第三方控件找不到。这套系统的价值在于客户档案、联系人、销售机会、跟进记录、合同订单这几条主线是完整的权限模型也是标准的角色-用户-菜单三层结构。适合两类人一是想拿一套现成 CRM 做二次开发的小团队二是想通过完整项目理解 ASP.NET 分层架构的开发者。下面我按“能干什么→怎么跑→怎么改”的顺序把这套源码拆开讲。2. 技术栈与目录结构一套典型的三层 ASP.NET WebForms 工程2.1 技术选型为什么是 WebForms 而不是 MVC这套源码用的是 ASP.NET WebForms不是 MVC。很多人一看 WebForms 就觉得过时但在企业内网系统这个场景里它反而有优势GridView 控件直接绑定 DataTable 就能出增删改查页面服务器控件的事件模型让表单提交逻辑写起来很直白不需要额外配路由。对于一套以“数据录入列表查询报表导出”为主的 CRM 来说WebForms 的开发效率其实不低。后端语言是 C#数据库是 SQL Server数据访问层用的是 ADO.NET 手写 SQL 加 SqlHelper 封装没有上 Entity Framework。这种选择在老项目里很常见——SqlHelper 对 SQL 的控制力强调优方便缺点是写起来啰嗦。前端方面页面主体是 .aspx 加 .aspx.cs 代码后置文件样式用了 Bootstrap 3 的栅格和表格类弹窗用的是 layer.js日期控件是 My97DatePicker。这些第三方库都放在 Scripts 和 Content 目录下不依赖 CDN内网部署时不会因为断网导致页面样式崩掉。提示如果你打算把这套系统迁移到 .NET Core 或 Blazor工作量不小。WebForms 的页面生命周期和服务器控件在 .NET Core 里没有对应实现建议要么整体重写要么就留在 .NET Framework 4.x 上继续维护。2.2 目录结构每个文件夹对应什么职责解压源码后根目录下大致是这么几个部分CRM.Web/ Web 层所有 .aspx 页面和静态资源 ├── Admin/ 系统管理模块用户、角色、菜单、日志 ├── Customer/ 客户管理模块客户档案、联系人 ├── Sales/ 销售管理模块销售机会、跟进记录 ├── Contract/ 合同与订单模块 ├── Report/ 报表统计模块 ├── Scripts/ jQuery、Bootstrap、layer、My97 等前端库 ├── Content/ CSS 和图片资源 ├── Web.config 数据库连接串、应用配置 └── Global.asax 应用启动与全局异常处理 CRM.BLL/ 业务逻辑层每个模块一个 Manager 类 CRM.DAL/ 数据访问层SqlHelper 各模块 Dao 类 CRM.Model/ 实体类与数据库表一一对应 CRM.Common/ 工具类加密、日志、Excel 导出、分页 CRM.DB/ 数据库脚本建表、初始数据这个分层是标准的 BLL/DAL/Model 三层。Web 层的页面不直接碰数据库而是调用 BLL 里的 Manager 方法Manager 再调 DAL 的 Dao。Model 层是纯数据载体字段和数据库表列对应。Common 层里有两个类值得注意一个是SqlHelper.cs封装了 ExecuteNonQuery、ExecuteDataTable、ExecuteScalar 这些方法另一个是PageHelper.cs负责 GridView 的分页参数计算。2.3 数据库设计五张核心表撑起整个 CRM打开 CRM.DB 目录下的建表脚本表不少但真正撑起业务主线的就五张表名作用关键字段Customer客户档案CustomerID, CustomerName, Industry, Level, OwnerIDContact联系人ContactID, CustomerID, ContactName, Phone, PositionOpportunity销售机会OppID, CustomerID, Stage, Amount, ExpectedDateFollowUp跟进记录FollowID, CustomerID, Content, FollowTime, NextTimeContract合同ContractID, CustomerID, Amount, SignDate, StatusCustomer 表里的 OwnerID 指向系统用户表表示这个客户归哪个销售负责。Opportunity 的 Stage 字段是枚举值初步接触、需求确认、方案报价、谈判、赢单、输单跟进记录里的 NextTime 用来做“下次跟进提醒”。这几张表之间的外键关系不复杂但查询时经常需要联表——比如“查某个销售名下所有客户的本月合同金额”就要 Customer 联 Contract 再按 OwnerID 过滤。3. 把项目跑起来环境准备、数据库还原与首次登录3.1 环境清单与版本要求这套源码基于 .NET Framework 4.5 开发开发工具用 Visual Studio 2019 或 2022 都可以安装时勾选“ASP.NET 和 Web 开发”工作负载。数据库需要 SQL Server 2012 及以上版本Express 版也行。IIS 不是必须的直接用 VS 自带的 IIS Express 调试就可以。需要确认的几件事第一项目文件是 .csproj 格式用 VS 打开解决方案文件.sln即可第二Web.config 里的连接字符串需要改成你本机的 SQL Server 实例名第三如果本机没装 SQL Server用 LocalDB 也可以连接串换成(localdb)\MSSQLLocalDB就行。3.2 数据库还原先跑脚本再改连接串CRM.DB 目录下有两个脚本CreateTable.sql和InitData.sql。执行顺序不能反——先建表再插初始数据。用 SSMS 打开这两个脚本连上你的实例依次执行。-- 先创建数据库如果不存在 IF NOT EXISTS (SELECT name FROM sys.databases WHERE name CRM_DB) CREATE DATABASE CRM_DB; GO USE CRM_DB; GO -- 然后执行 CreateTable.sql 里的建表语句 -- 再执行 InitData.sql 插入管理员账号和基础字典数据InitData.sql 里会插入一个默认管理员账号用户名一般是admin密码是经过 MD5 加密的字符串。这里有个坑不同版本的源码包密码加密方式可能不一样有的是 MD5有的是 MD5 加盐。如果登录提示密码错误去CRM.Common里找EncryptHelper.cs看它用的是哪种方式然后手动生成一个对应密文更新到数据库里。3.3 修改连接串并启动调试打开 Web 层的Web.config找到connectionStrings节点connectionStrings add nameCRMConn connectionStringData Source.;Initial CatalogCRM_DB;User IDsa;Password你的密码 providerNameSystem.Data.SqlClient / /connectionStringsData Source.表示本机默认实例如果你用的是命名实例就改成.\SQLEXPRESS这种形式。改完之后在 VS 里右键 Web 项目选择“设为启动项目”按 F5 启动。首次启动会编译整个解决方案如果 Common 或 DAL 项目引用了找不到的程序集检查一下 packages 目录是否完整——有些源码包不带 NuGet 还原需要手动在 VS 里“还原 NuGet 包”。启动后浏览器会打开登录页用 InitData 里的管理员账号登录。进去之后先看左侧菜单是否完整如果菜单是空的说明菜单表的数据没插进去回到 InitData.sql 检查 Menu 表的 INSERT 语句有没有执行成功。3.4 常见启动失败与排查顺序启动失败最常见的原因按概率排连接串不对占一半以上、数据库脚本没执行完整、NuGet 包缺失、IIS Express 端口被占用。排查顺序建议是先看浏览器报的详细错误Web.config 里把customErrors设为Off如果是“无法打开登录所请求的数据库”就是连接串或数据库名的问题如果是“找不到类型或命名空间”就是引用缺失如果是 500 但页面没详细信息去 VS 的输出窗口看异常堆栈。4. 核心模块拆解客户档案、跟进记录与权限控制怎么实现的4.1 客户列表页GridView 绑定与分页查询客户列表是使用频率最高的页面Customer/CustomerList.aspx里放了一个 GridView 和一个搜索框。页面加载时调用 BLL 的CustomerManager.GetList()方法传入页码、每页条数和搜索关键词。// CustomerList.aspx.cs 中的分页加载逻辑 protected void Page_Load(object sender, EventArgs e) { if (!IsPostBack) { BindGrid(1); // 首次加载第一页 } } private void BindGrid(int pageIndex) { int pageSize 15; string keyword txtKeyword.Text.Trim(); int totalCount 0; // BLL 返回 DataTable同时通过 out 参数带回总记录数 DataTable dt CustomerManager.GetList(pageIndex, pageSize, keyword, out totalCount); gvCustomer.DataSource dt; gvCustomer.DataBind(); // 自己拼一个简单分页条 litPager.Text PageHelper.BuildPager(pageIndex, pageSize, totalCount); }GetList在 DAL 层拼的 SQL 是这样的SELECT * FROM ( SELECT ROW_NUMBER() OVER (ORDER BY CustomerID DESC) AS RowNum, * FROM Customer WHERE (Keyword OR CustomerName LIKE % Keyword %) ) AS T WHERE RowNum BETWEEN Start AND End用ROW_NUMBER()做分页是 SQL Server 2005 之后的老办法优点是兼容性好缺点是数据量大时性能一般。如果客户表超过十万条建议改成OFFSET FETCH或者加索引优化。参数Start和End由 PageHelper 根据页码算出来Keyword为空时不过滤这样搜索和列表共用一个方法。4.2 跟进记录一次提交写两张表的业务逻辑跟进记录是 CRM 的核心动作。销售在客户详情页填写“本次跟进内容”和“下次跟进时间”提交后系统要做两件事往 FollowUp 表插一条记录同时更新 Customer 表的LastFollowTime和NextFollowTime字段。这两个操作必须在一个事务里完成否则会出现跟进记录写了但客户表没更新的情况。// FollowUpManager.AddFollowUp 方法 public static bool AddFollowUp(FollowUpModel model) { using (SqlConnection conn new SqlConnection(SqlHelper.ConnString)) { conn.Open(); using (SqlTransaction trans conn.BeginTransaction()) { try { // 1. 插入跟进记录 string sqlInsert INSERT INTO FollowUp (CustomerID, Content, FollowTime, NextTime, CreateBy) VALUES (CustomerID, Content, FollowTime, NextTime, CreateBy); SqlHelper.ExecuteNonQuery(trans, sqlInsert, new SqlParameter(CustomerID, model.CustomerID), new SqlParameter(Content, model.Content), new SqlParameter(FollowTime, model.FollowTime), new SqlParameter(NextTime, model.NextTime), new SqlParameter(CreateBy, model.CreateBy)); // 2. 更新客户表的最近跟进时间和下次跟进时间 string sqlUpdate UPDATE Customer SET LastFollowTime FollowTime, NextFollowTime NextTime WHERE CustomerID CustomerID; SqlHelper.ExecuteNonQuery(trans, sqlUpdate, new SqlParameter(FollowTime, model.FollowTime), new SqlParameter(NextTime, model.NextTime), new SqlParameter(CustomerID, model.CustomerID)); trans.Commit(); return true; } catch (Exception ex) { trans.Rollback(); LogHelper.WriteLog(AddFollowUp, ex); return false; } } } }这段代码的关键点在于SqlTransaction的使用——两个ExecuteNonQuery共用同一个连接和事务对象。SqlHelper里对应的方法签名要接受SqlTransaction参数否则事务不生效。另外NextTime允许为空表示不需要再跟进页面上对应一个“不再提醒”的复选框。4.3 权限控制角色-菜单-页面三级拦截这套系统的权限模型是“用户属于角色角色关联菜单菜单对应页面路径”。登录成功后用户信息包括角色 ID存到 Session 里每个页面加载时检查当前用户是否有权访问当前页面。// BasePage.cs 中的权限校验所有业务页面继承这个基类 public class BasePage : System.Web.UI.Page { protected override void OnInit(EventArgs e) { base.OnInit(e); if (Session[CurrentUser] null) { Response.Redirect(~/Login.aspx); return; } UserModel user Session[CurrentUser] as UserModel; string currentPage Request.AppRelativeCurrentExecutionFilePath; // 管理员跳过校验 if (user.RoleID 1) return; // 查当前角色是否有这个页面的权限 if (!MenuManager.HasPermission(user.RoleID, currentPage)) { Response.Redirect(~/NoPermission.aspx); } } }HasPermission在 DAL 层查的是 RoleMenu 关联表判断当前页面路径是否在角色已授权的菜单集合里。这种做法的优点是直观缺点是每次页面加载都要查一次数据库。优化思路是把角色-菜单关系缓存到 Application 或 MemoryCache 里菜单变更时清缓存。源码里没做缓存如果并发量上来这里是第一个要改的地方。5. 避坑与排查这套源码跑起来最容易翻车的五个地方5.1 登录后菜单空白但数据库里明明有数据现象用管理员账号登录成功跳转到主页后左侧菜单一片空白F12 看接口返回是空数组。原因菜单表的数据虽然插入了但MenuManager.GetMenusByRole方法里过滤条件写的是IsVisible 1而 InitData.sql 里插入的菜单记录IsVisible字段默认是 0。解决手动执行UPDATE Menu SET IsVisible 1或者检查 InitData.sql 里 INSERT 语句有没有显式给 IsVisible 赋值。5.2 日期控件报错“未定义 My97DatePicker”现象打开客户编辑页浏览器控制台报My97DatePicker is not defined日期选择框点不出来。原因My97DatePicker 的脚本引用路径写的是绝对路径/Scripts/My97DatePicker/WdatePicker.js但项目部署在 IIS 的虚拟目录下时根路径变了。解决把 .aspx 里的脚本引用改成% ResolveUrl(~/Scripts/My97DatePicker/WdatePicker.js) %用 ResolveUrl 动态解析路径。5.3 导出 Excel 时中文乱码现象合同列表点“导出 Excel”下载下来的文件用 Excel 打开中文全是乱码。原因ExcelHelper里写的是Response.ContentType application/vnd.ms-excel但没有设置Response.Charset GB2312而且输出流用的是 UTF-8 编码。解决在导出方法开头加Response.Charset GB2312; Response.ContentEncoding System.Text.Encoding.GetEncoding(GB2312);或者干脆改成导出 CSV 再用 Excel 打开兼容性更好。5.4 发布到 IIS 后报“未能加载文件或程序集”现象本地 VS 调试一切正常发布到服务器 IIS 后打开页面报黄页提示某个程序集加载失败。原因发布时没有把bin目录下的依赖 DLL 一起拷过去或者目标服务器上没装对应版本的 .NET Framework。解决检查发布目录的 bin 文件夹是否完整服务器上运行dotnetfx安装包确认 .NET Framework 4.5 已安装应用程序池的 .NET CLR 版本设为 v4.0。5.5 并发编辑客户信息时后保存的覆盖先保存的现象两个销售同时打开同一个客户的编辑页A 先改了电话保存B 后改了地址保存结果 A 改的电话被 B 的提交覆盖了。原因更新语句是UPDATE Customer SET ... WHERE CustomerID ID没有做乐观并发控制。解决在 Customer 表加一个RowVersion字段timestamp 类型更新时带上WHERE CustomerID ID AND RowVersion OldVersion受影响行数为 0 就提示“数据已被他人修改请刷新后重试”。6. 二次开发改造从加一个字段到换一套提醒机制拿到这套源码后最常见的改造需求是“加字段”和“改提醒逻辑”。加字段的路径很固定数据库表加列 → Model 类加属性 → DAL 的 INSERT/UPDATE 语句加参数 → 页面加输入框和 GridView 列。以给客户加一个“客户来源”字段为例五步走完半小时能搞定。真正值得花时间的是提醒机制——原生的“下次跟进时间”只是一个静态字段没有任何主动提醒能力。我的做法是在 Global.asax 里挂一个定时任务每天上午九点扫一遍 Customer 表把NextFollowTime是今天且未关闭提醒的客户查出来往站内消息表插一条提醒记录同时在主页右上角的消息图标上显示红点。核心代码就一个方法// Global.asax 中注册定时器 void Application_Start(object sender, EventArgs e) { System.Threading.Timer timer new System.Threading.Timer( CheckFollowUpReminder, null, TimeSpan.FromMinutes(1), TimeSpan.FromHours(24)); } private void CheckFollowUpReminder(object state) { // 只在每天 9 点后执行一次 if (DateTime.Now.Hour ! 9) return; string sql SELECT CustomerID, CustomerName, OwnerID FROM Customer WHERE CONVERT(date, NextFollowTime) CONVERT(date, GETDATE()) AND IsRemindClosed 0; DataTable dt SqlHelper.ExecuteDataTable(sql); foreach (DataRow row in dt.Rows) { MessageManager.AddReminder( Convert.ToInt32(row[OwnerID]), $客户【{row[CustomerName]}】今天需要跟进); } }这个定时器的精度不高Timer 的回调时间受应用程序池回收影响IIS 空闲一段时间后应用池回收Timer 就停了。更稳的做法是写一个独立的 Windows 服务或者用 SQL Server 的作业来跑但作为快速验证Timer 方案够用。改完之后我一般会手动把系统时间调到 9 点零 1 分重启应用池看消息表里有没有新记录确认逻辑通了再调回去。还有一个改造点是列表页的查询性能。原生的ROW_NUMBER()分页在客户量超过五万后明显变慢我的习惯是给 Customer 表的OwnerID、CustomerName、NextFollowTime三个字段各建一个非聚集索引然后把分页 SQL 换成OFFSET Start ROWS FETCH NEXT PageSize ROWS ONLY。改完用 SQL Server Profiler 抓一下执行计划确认走了索引扫描而不是全表扫描。从那以后我每次接手这类老源码包都强制自己先跑一遍“建库→改连接串→登录→点一遍所有菜单”的完整链路确认基线可用再动代码。很多坑其实在第一次启动时就埋下了早发现比改到一半再回头查要省事得多。希望帮到你。本文还有配套的精品资源点击获取
