蓝鲸框架提供可视化代码生成器，以"表/视图"为单元，一键生成后端 Model、业务类（Service/Repository）以及前端 Vue 页面，并自动完成菜单与权限注册。

点击新建，弹出选择框；若是修改已有配置，可直接修改页面配置后点【保存】，再执行各类生成操作。

点击确认后，系统自动从后台加载表结构信息（若仅生成空菜单，表名可随意填写）。关键参数：

• 项目命名空间：生成的文件所放置的类库（框架以一个模块为一个类库）。
• 项目文件夹：生成文件所在文件夹，由代码生成器自动创建，无需手动建。
• 表名：可为视图或表，名称必须与数据库一致。

在表格中配置查询、新建、编辑字段（不配置则弹出框为空白）。可设置表别名以隐藏真实表名。配置完成后点击【保存】→【生成Vue页面】→【生成Model】→【生成业务类】即可（每次修改后都需先点保存）。

生成后在 Visual Studio 中搜索当前表名即可看到后端代码；Vue 代码同步生成，可在 VS Code 中按表名搜索（文件名均以表名开头）。

Url：通过 VS Code 打开 Vue 项目，在 router/viewGird.js 中找到当前生成表的 path（如 /SellOrder）复制即可。表名：必须与生成代码时填写的表名/视图名一致，否则权限验证不通过。

若后台启动的是 builder_run.bat 请先关闭，改由 WebApi/dev_run.bat 启动后台，访问 http://localhost:9990/sellOrder 即可看到自动生成的业务页面。

核心配置项包括：项目命名空间、项目文件夹、表中文名、表别名（隐藏真实表名）、明细表名（生成主从表）、快捷编辑字段、排序字段、Vue 视图绝对路径等。

蓝鲸框架后台开发遵循"在代码生成器生成的类上进行扩展"的原则。每个表都会生成对应的 Repository 与 Service，自定义接口与业务统一在 Partial 文件夹下实现（如 SellOrderService.cs 的 Partial/SellOrderService.cs）。

框架封装了多种数据访问方式，均可在业务类中使用：

• repository.xxx / repository.FindAsIQueryable：EF 仓储。
• repository.DapperContext.xxx 与 DBServerProvider.SqlDapper：Dapper 原生 SQL / 存储过程。
• SellOrderRepository.Instance.Find()：实列化仓储调用。
• DBServerProvider.DbContext：直接使用 EF DbContext。

EF 默认开启 NoTracking，更新操作请调用 repository.Update；若报"实体已被跟踪"错误，更新前先调用 SellOrderRepository.Instance.Detached()。

• 查询扩展：重写 GetPageData，通过 QuerySql、QueryRelativeExpression、OrderByExpression、SummaryExpress 自定义查询、排序与合计。
• 增删改扩展：重写 Add/Update/Del，利用 OnExecuting/OnExecuted 钩子在保存前后介入校验与业务。
• 导入导出：重写 Import/Export/DownLoadTemplate，配置字段与最大导出量。
• 事务：repository.DbContextBeginTransaction 或 DBServerProvider.SqlDapper.BeginTransaction。
• 缓存：注入 ICacheService（默认内存，appsettings 设 UseRedis:true 切换 Redis）。
• 权限：控制器方法加 [ApiActionPermission]；免登录 [AllowAnonymous]；定时任务 [ApiTask]。
• 多表/视图：复杂查询建议建视图再生成代码；视图的增删改可转发到原表 Service 实现。

蓝鲸基础框架内置大量开箱即用的通用能力，由系统管理员配置后即可被所有业务模块复用，无需重复开发。

框架支持多维度数据查询与分析报表，数据读取方式包括：直接从后台 API 读取、执行存储过程返回数据、以及 JSON 静态数据。数据源既可从数据库连接获取，也可在【系统→下拉框绑定设置】中配置 SQL 或字典，代码生成器选择后即自动完成前端绑定。

支持按菜单名称、菜单编号查找，查看完整功能菜单，以及我的常用菜单（可自定义）。代码生成器生成的菜单在此集中管理并参与权限分配。

工作台展示由管理员设定并授权的关键播报数据；待办事项入口可一键调出当前用户的所有待办工作。

可修改密码、设定主题颜色、切换语言环境、退出系统，并通过已开模块在不同功能模块间快速切换。

系统单据分为单表与主次表两种形态。以销售订单为例：主表功能操作区（红色框选）提供查询、新建、编辑、删除、复制；勾选一条主表数据可进入编辑，也可直接点击蓝色行快捷编辑；子表（黑色框选）维护明细。

提供三种查询方式：①快速查询/联合快捷查询（按管理员设定字段模糊查询）；②高级查询（弹出条件窗录入多条件）；③查询生成器（自由定义并永久保存查询方案）。

支持从 Excel 导入（下载模板→编辑→上传，需通过规则校验），以及明细表"Excel 添加行"功能：下载模板后直接拷贝 Excel 数据粘贴，快速批量录入（调整字段顺序后模板需同步调整）。

通过"定义"功能按钮配置个性化显示：勾选字段是否显示、拖动行调整顺序，保存即生效，也可重置恢复初始值。

选择单据后单击打印，系统弹出本模块已设计的报表供选用；报表模板在【系统设置→报表管理】下定义与定制。

单选被复制单据后进入复制界面，在原数据基础上修改保存即生成新单据；自动编码规则的系统会自动生成新单号，手动编码则需自行输入。

在【系统设置→自定义配置→待办规则】中由管理员建立并授权（定义页面名称、详细页面路径、查询语句、数据列与状态）；用户登录后可在待办入口查看并一键办理。

代码生成器生成的 Vue3 页面直接构成业务功能。以下以"工程设计—产品模板"为例，展示框架生成的典型业务界面：左侧为产品模板列表与结构树，右侧为模板属性与工艺参数的编辑表单，均由表结构配置自动渲染。

蓝鲸MES 以"后端 .NET Core + 前端 Vue3"为基础，借助代码生成器实现业务模块的零代码生成，再于 Partial 业务类中扩展复杂逻辑；系统主控台内置数据源、菜单、工作台、查询、导入导出、报表、待办等通用能力，使开发人员能把精力集中在业务本身。结合上述流程与图示，实施团队可快速完成从建表、生成、配置到上线的完整开发闭环。