CSFrameworkV6开发框架打造塑木地板新材料行业ERP系统

广东邦英新材料有限公司ERP系统（Bongywood ERP）是一套面向新材料行业的 Windows 桌面企业管理软件，基于 CSFrameworkV6.1 旗舰版快速开发框架构建，覆盖销售、采购、库存、生产、财务、人力资源、报表中心与系统管理八大业务域。本文从技术栈与功能模块两个维度，介绍这套系统的实现方案。

一、项目背景

新材料行业的生产组织方式介于化工与离散制造之间：既有挤出、造粒等连续工艺环节，又需要按客户订单进行批号、交期与成本核算管理。邦英 ERP 围绕这一业务特征，以「材料 / 产品双口径」为主线组织库存与单据体系，销售发货、采购入库、材料出库、生产计划、挤出登记等单据均围绕物料编码（ProductCode）贯通，最终形成从接单到出库、从对账到收付款的完整闭环。

系统采用 MDI 多文档界面，主窗体按业务模块组织导航，各模块以独立项目程序集承载，便于按客户授权范围裁剪与增量升级。

二、技术栈

1、开发框架与运行环境

2、分层架构与解决方案结构

系统沿用框架标准的接口层—业务层—数据层—模型层四层划分，业务模块各自独立成程序集：

CSFrameworkV6.Main              ★ 入口 EXE (WinExe)
CSFrameworkV6.Models            实体模型层（约 399 个文件）
CSFrameworkV6.Business          业务逻辑层（BLL）
CSFrameworkV6.DataAccess        数据访问层（DAL）
CSFrameworkV6.Interfaces        接口/契约层（Bridge）
CSFrameworkV6.Common            公共工具类
CSFrameworkV6.Library           共享 UI 框架库（frmBase 等）
CSFrameworkV6.Language          多语言支持
CSFrameworkV6.WebApiClient      Web API 客户端（HTTP 通道）
CSFrameworkV6.DataDictionary    数据字典/基础资料
CSFrameworkV6.SalesModule       销售模块
CSFrameworkV6.PurchaseModule    采购模块
CSFrameworkV6.InventoryModule   库存模块（最大的业务模块）
CSFrameworkV6.ProductionModule  生产模块
CSFrameworkV6.FinancelModule    财务模块
CSFrameworkV6.HumanResource     人力资源
CSFrameworkV6.ReportModule      报表模块
CSFrameworkV6.SystemModule      系统管理
CSFrameworkV6.Home              首页仪表盘
CSFrameworkV6.UserCustom        用户自定义扩展

窗体侧统一继承框架基类：frmBaseBusinessForm（业务单据：汇总 Grid + 明细 Grid + 编辑 Panel + 工具条）与 frmBaseDataDictionary（基础资料单表编辑），新增单据时只需继承并配置数据容器即可，界面交互与工具栏按钮由基类统一接管。

3、双通道数据访问（Bridge 模式）

框架在启动时通过 BridgeFactory.InitializeBridge() 确定数据通道，ADO Direct 模式下 DAL 类直连数据库，WebApi 模式下由 WebApiClient 通过 HTTP 调用后端服务；两种模式实现相同的 IBridge_* 接口，切换对业务代码完全透明。

配合 DalFactory.RegistAssembly() 反射扫描带 ORM 映射特性的 DAL 类，建立「ORM 类型 → DAL 类型」映射表：

[DefaultORM_UpdateMode(typeof(tb_SO), true)]
public class dal_SO_Product : dalBaseBusiness { ... }

同时由 DatabaseProvider 区分「系统数据库」（共享元数据）与「账套数据库」（公司业务数据），以 Loginer.CurrentUser.DBID 定位当前操作库，天然支持多公司、多账套。

4、主从单据与数据字典基类

业务单据统一走 BusinessData<TMaster, TDetail> 主从数据容器，经 bllBaseBusiness<TM,TD> → dalBaseBusiness 落地；基础资料则走 bllBaseDataDict<T> / dalBaseDataDict<T> 单表泛型基类。所有实体统一使用 isid（Snowflake 主键）、CreatedBy / CreationDate、LastUpdatedBy / LastUpdateDate、FlagApp（审批状态）、FlagPeriod（期末结账锁定）等公共字段，审计与月结控制由基类统一处理。

以「禁用物料检测」这类跨单据业务规则为例，只需要在基类提供一个方法，各单据在保存与审核两个入口各自调用一次即可完成全库覆盖：

// 保存时：拦截录入已禁用物料（含修改模式下新增的明细行）
if (isAdd)
{
    AssertStopProducts(data.Details.Select(s => s.ProductCode).Distinct().ToList());
}
if (listAdded.Count > 0)
{
    AssertStopProducts(listAdded.Select(s => s.ProductCode).Distinct().ToList());
}

// 审核时：拦截「录入时未禁用、之后被停用」的单据
if (input.Type == ApprovalType.Approval)
{
    AssertStopProducts(q_INs.Select(s => s.ProductCode).Distinct().ToList());
}

三、主要功能模块

1、模块功能一览

2、单据与实体命名规范

为让 21 个项目的协作保持统一，系统沿用框架的实体命名约定，从名称即可判断对象性质：

四、框架能力复用小结

回顾本项目的落地过程，CSFrameworkV6 快速开发框架带来的收益集中在四点：

1. 单据开发模板化。继承 frmBaseBusinessForm + BusinessData<TM,TD> 后，新增一张主从单据的工作量收敛为「建实体 → 写 DAL → 配窗体」，界面与工具条由基类接管。

2. 数据通道可切换。ADO Direct 与 WebApi 双通道共用同一套 IBridge_* 接口，从局域网直连迁移到集中式部署时，业务层无需改动。

3. 基础能力开箱即用。权限、多语言、日志、单据编号规则、系统参数、账套切换、自动升级、报表管理均由框架提供，项目只需要关注业务规则本身。

4. 公共字段与审计统一。isid / FlagApp / FlagPeriod 等公共字段与审批、月结控制内建在基类中，跨单据的业务规则（如禁用物料检测）可在基类一处实现、各单据按需调用。

了解更多 CSFrameworkV6 快速开发框架，请访问 C/S框架网。