DarkM 模块目录
文档版本： 1.0
最后更新： 2022-03-01
模块总数： 42 个
📦 模块总览
DarkM 框架采用模块化架构，包含核心框架、工具模块、业务模块等多种类型，支持灵活组合和部署。
| 分类 | 数量 | Git 组织 |
|---|
| 核心框架层 | 3 个 | framework/darkm |
| 皮肤层 | 2 个 | framework/darkm |
| 工具模块层 | 5 个 | framework/darkm |
| 业务模块层 | 8 个 | woowis/darkm |
| NewOA 业务系统 | 8 个 | doterra/oa |
| 会员系统 | 7 个 | doterra/member |
| 商城系统 | 3 个 | doterra/mall |
| doTERRA 集成 | 4 个 | doterra/darkm |
| 文档 | 1 个 | framework/darkm |
| 新建模块 | 2 个 | framework/darkm |
| 总计 | 42 个 | - |
🔵 核心框架层（framework/darkm）
DarkM（核心框架）
| 项目 | 说明 |
|---|
| Git 地址 | http://ngitl.woowis.com/framework/darkm/darkm.git |
| 状态 | ✅ 成熟 |
| 功能 | 框架核心基础支撑、依赖注入、配置管理、日志、异常处理、权限控制 |
| 数据访问 | 基于 Dapper 封装的 ORM，支持 SqlServer/MySql/PostgreSQL/SQLite |
| 批量操作 | BatchInsert、BulkMerge（Upsert）、分表操作 |
DarkM.UI（前端核心）
| 项目 | 说明 |
|---|
| Git 地址 | http://ngitl.woowis.com/framework/darkm/darkm.ui.git |
| 状态 | ✅ 成熟 |
| 功能 | Vue 2.6 基础框架封装、网络请求、安全控制、权限控制、组件库、Vuex |
DarkM.UI.Map（地图组件）
| 项目 | 说明 |
|---|
| Git 地址 | http://ngitl.woowis.com/framework/darkm/darkm.ui.map.git |
| 状态 | ✅ 成熟 |
| 功能 | 地图组件封装、地址选择器、地理编码 |
🎨 皮肤层（framework/darkm）
DarkM.Skins.Classics（经典皮肤）
| 项目 | 说明 |
|---|
| Git 地址 | http://ngitl.woowis.com/framework/darkm/darkm.skins.classics.git |
| 状态 | ✅ 成熟 |
| 功能 | 经典浅色 UI 主题，企业风格设计 |
DarkM.Skins.Pithy（黑暗皮肤）
| 项目 | 说明 |
|---|
| Git 地址 | http://ngitl.woowis.com/framework/darkm/darkm.skins.pithy.git |
| 状态 | ✅ 成熟 |
| 功能 | 黑暗 UI 主题，现代风格设计 |
🔨 工具模块层（framework/darkm）
DarkM.Module.CodeGenerator（代码生成器）
| 项目 | 说明 |
|---|
| Git 地址 | http://ngitl.woowis.com/framework/darkm/darkm.module.codegenerator.git |
| 状态 | ✅ 成熟 |
| 功能 | 根据数据库表生成模块代码、支持前后端代码生成、自定义模板 |
| 用途 | 快速搭建模块基础结构，节省 70% 重复编码工作 |
DarkM.Module.Common（公共模块）
| 项目 | 说明 |
|---|
| Git 地址 | http://ngitl.woowis.com/framework/darkm/darkm.module.common.git |
| 状态 | ✅ 成熟 |
| 功能 | 数据字典管理、地址区域管理（4 级联动）、公共 API、通用工具类 |
| 前端组件 | nm-dict-select（字典下拉框）、nm-dict-tree（字典树） |
DarkM.Module.Message（消息通知）
| 项目 | 说明 |
|---|
| Git 地址 | http://ngitl.woowis.com/framework/darkm/darkm.module.message.git |
| 状态 | ✅ 成熟 |
| 功能 | 短信/邮件/App 推送/微信模板消息、消息管理配置、发送日志 |
| 用途 | 审批通知、订单通知、系统通知 |
DarkM.Module.Quartz（任务定时器）
| 项目 | 说明 |
|---|
| Git 地址 | http://ngitl.woowis.com/framework/darkm/darkm.module.quartz.git |
| 状态 | ✅ 成熟 |
| 功能 | 定时任务调度、任务配置 UI、任务执行日志、Cron 表达式 |
| Web 控制台 | http://localhost:5000 |
DarkM.Module.PageForm（页面配置）
| 项目 | 说明 |
|---|
| Git 地址 | http://ngitl.woowis.com/framework/darkm/darkm.module.pageform.git |
| 状态 | ✅ 成熟 |
| 功能 | 页面配置管理、文章配置、动态表单配置、页面布局配置 |
💼 业务模块层（woowis/darkm）
DarkM.Module.WorkFlow（流程引擎）
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/woowis/darkm/DarkM.Module.WorkFlow.git |
| 状态 | ✅ 成熟 |
| 功能 | 流程定义与配置、流程实例管理、审批节点配置、流程流转引擎、历史记录 |
| 用途 | NewOA 系统、领用流程、审批流程 |
DarkM.Module.HumanResources（人事管理）
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/woowis/darkm/DarkM.Module.HumanResources.git |
| 状态 | ✅ 成熟 |
| 功能 | 员工信息管理、部门管理、岗位管理、入职/离职流程、员工档案 |
DarkM.Module.SNS（社交模块）
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/woowis/darkm/darkm.module.sns.git |
| 状态 | ✅ 成熟 |
| 功能 | 用户动态、关注/粉丝、点赞/评论、消息推送、社交关系链 |
| 用途 | JoyIn 公众号系统、商城小程序 |
DarkM.Module.Record（访问记录）
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/woowis/darkm/record.git |
| 状态 | ✅ 成熟 |
| 功能 | 访问日志记录、操作审计、行为分析、数据追踪 |
DarkM.Module.Project（项目管理模块）
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/woowis/darkm/project.git |
| 状态 | ✅ 成熟 |
| 功能 | 项目立项、任务分解、进度跟踪、资源分配、项目报表 |
| 注意 | ⚠️ 这是框架层项目管理模块，与 NewOA 中的需求管理（Project）不同 |
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/woowis/darkm/performance.git |
| 状态 | ✅ 成熟 |
| 功能 | 绩效考核配置、KPI 指标管理、绩效评估、绩效报表、绩效反馈 |
DarkM.Module.Order（订单管理）
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/woowis/darkm/order.git |
| 状态 | ⚠️ 需优化 |
| 功能 | 订单管理、订单状态流转、订单查询 |
| 优化需求 | 批量订单处理、订单拆分/合并、通知机制集成 |
DarkM.Demo（示例项目）
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/woowis/darkm/DarkM.Demo.git |
| 状态 | ✅ 成熟 |
| 功能 | 框架使用示例、模块开发参考、最佳实践演示 |
🏢 NewOA 业务系统（doterra/oa）
NewOA 主系统
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/oa/NewOA.git |
| 状态 | ✅ 成熟 |
| 功能 | NewOA 主系统、集成所有 NOA 业务模块、统一入口、统一认证、统一权限 |
NOA-需求管理 (Project)
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/oa/project.git |
| 状态 | ✅ 成熟 |
| 功能 | IT 需求申请/审批、需求收集、需求评审、需求跟踪、需求统计 |
NOA-内领系统 (Recipients) ⭐
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/oa/Recipients.git |
| 状态 | ✅ 成熟（三期升级中） |
| 功能 | 内部物品领用申请、审批流程、出库管理、签收确认 |
| 三期升级 | 业务流程升级、申请表单优化、批量申领支持 |
NOA-BOM 管理 (doBOM)
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/oa/doholiday.git |
| 状态 | ✅ 成熟 |
| 功能 | DarkM BOM 管理、物料清单管理、BOM 结构维护、BOM 版本管理 |
NOA-休假管理 (Holiday)
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/oa/doholiday.git |
| 状态 | ✅ 成熟 |
| 功能 | 假期设定、休假申请、休假审批、休假统计 |
NOA-客诉订单 (ComplaintOrder)
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/oa/complaintorder.git |
| 状态 | ✅ 成熟 |
| 功能 | 客诉订单申请、客诉处理流程、客诉跟踪、客诉统计 |
NOA-需求管理 (Project)
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/oa/project.git |
| 状态 | ✅ 成熟 |
| 功能 | IT 需求管理系统、需求收集、需求评审、需求跟踪、需求统计 |
| 注意 | ⚠️ 这是业务系统层需求管理，与框架层的 DarkM.Module.Project 不同 |
NOA-资产管理 (FixedAssets)
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/oa/fixedassets.git |
| 状态 | ✅ 成熟 |
| 功能 | 固定资产管理、资产入库、资产领用、资产折旧、资产盘点 |
👥 会员系统（doterra/member）
会员活动管理 (doEvent)
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/member/doEvent.git |
| 状态 | ✅ 成熟 |
| 功能 | 会员活动创建与管理、活动报名、活动签到、活动统计 |
客户关系系统 (CRM)
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/member/crm.git |
| 状态 | ✅ 成熟 |
| 功能 | 客户信息管理、客户分类、客户跟进、销售漏斗、客户分析 |
香荟多特瑞公众号 (JoyIn) 🌟
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/member/joyin.git |
| 状态 | ✅ 成熟 |
| 类型 | 业务系统 + 启动器 |
| 模块组成 | 核心 + Common + Quartz + SNS + CRM |
| 用途 | 香荟多特瑞公众号入口、会员运营 |
相遇精油小程序 (EssentialOil) 🌟
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/member/essentialoil.git |
| 状态 | ✅ 成熟 |
| 类型 | 业务系统 + 启动器 |
| 模块组成 | 核心 + Common + Quartz + PageForm |
| 用途 | 相遇精油微信小程序入口、精油产品展示与销售 |
报表管理模块 (doReport)
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/member/doReport.git |
| 状态 | ✅ 成熟 |
| 功能 | Management Dashboard、报表配置、报表生成、数据可视化 |
数据仓库 (doEDW)
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/member/doedw.git |
| 状态 | ✅ 成熟 |
| 功能 | 财务数据存储、数据 ETL、财务报表生成 |
启动项目：数据仓库 (StartEDW) 🌟
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/member/startedw.git |
| 状态 | ✅ 成熟 |
| 类型 | 启动器 |
| 模块组成 | 核心 + Common + Quartz + doReport + doEDW |
| 用途 | 数据仓库/报表入口 |
🛍️ 商城系统（doterra/mall）
DarkM 版微信商城 (doMall)
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/mall/doMall.git |
| 状态 | ✅ 成熟 |
| 类型 | 数据桥接层（无业务逻辑） |
| 功能 | 新框架调用老.Net Framework 商城数据、新旧系统数据桥接 |
微信商城小程序 (StartWechatMini) 🌟
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/mall/doTERRANewWechatMini.git |
| 状态 | ✅ 成熟 |
| 类型 | 启动器 |
| 模块组成 | 核心 + Common + Quartz + doEvent + Message + SNS + PageForm + MobileApp + doTERRAConnector |
| 用途 | 微信商城小程序入口 |
海外购公众号商城 (StartHWGWechatMini) 🌟
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/mall/dohwgministart.git |
| 状态 | ✅ 成熟 |
| 类型 | 启动器 |
| 模块组成 | 核心 + Common + Quartz + Message + SNS + PageForm + doTERRAConnector |
| 用途 | 海外购公众号商城入口、跨境购业务 |
📱 doTERRA 集成项目（doterra/darkm）
DarkM.MobileApp（APP 管理）
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/darkm/mobileapp.git |
| 状态 | ✅ 成熟 |
| 功能 | 手机 APP 管理、版本管理、更新推送、设备管理 |
DarkM.FileExplorers（文档管理）
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/darkm/fileexplorers.git |
| 状态 | ✅ 成熟 |
| 功能 | 文件管理、文档存储、权限控制、在线预览 |
DarkM.doTERRAConnector（统一接口）🌟
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/darkm/doterraconnector.git |
| 状态 | ✅ 成熟 |
| 功能 | 所有第三方接口的统一实现、doTERRA 系统集成、第三方 API 对接、数据同步、接口监控 |
| 使用规范 | ⚠️ 所有系统中遇到需要与第三方系统对接时，都需要加入这个模块 |
DarkM.Survey（问卷调查）
| 项目 | 说明 |
|---|
| Git 地址 | https://glab.woowis.com/doterra/darkm/survey.git |
| 状态 | ✅ 成熟 |
| 功能 | 问卷设计、问卷发布、数据收集、统计分析 |
📚 文档（framework/darkm）
DarkM.Docs（框架文档）
| 项目 | 说明 |
|---|
| Git 地址 | http://ngitl.woowis.com/framework/darkm/darkm.docs.git |
| 在线文档 | https://dmdocs.woowis.com |
| 功能 | 框架说明文档、模块开发指南、API 接口文档、最佳实践 |
🆕 新建业务模块（framework/darkm）
DarkM.Module.Product（商品模块）🆕
| 项目 | 说明 |
|---|
| Git 地址 | 待创建 |
| 状态 | 🆕 新建 |
| 功能 | 商品/物品管理、商品分类、库存管理、商品搜索、价格管理 |
| 用途 | 领用三期（物品目录）、商城系统 |
DarkM.Module.Payment（支付模块）🆕
| 项目 | 说明 |
|---|
| Git 地址 | 待创建 |
| 状态 | 🆕 新建 |
| 功能 | 支付接口集成、支付订单管理、退款管理、对账管理 |
| 用途 | 商城系统 |
📊 模块使用统计
最常用模块 TOP 10
| 排名 | 模块 | 使用系统数 |
|---|
| 1 | DarkM.Module.Common | 所有系统 |
| 2 | DarkM.Module.Message | 10+ 系统 |
| 3 | DarkM.Module.Quartz | 8+ 系统 |
| 4 | DarkM.Module.WorkFlow | NewOA、领用系统 |
| 5 | DarkM.Module.SNS | JoyIn、商城小程序 |
| 6 | DarkM.Module.PageForm | EssentialOil、商城系统 |
| 7 | DarkM.doTERRAConnector | 商城系统、集成项目 |
| 8 | DarkM.Module.Order | 领用系统、商城系统 |
| 9 | DarkM.Module.Record | 审计需求系统 |
| 10 | DarkM.Module.CodeGenerator | 模块开发 |
🎯 模块选择指南
新建系统推荐模块组合
1. 内部管理系统的标准配置
核心框架 + Admin + Common + Quartz + Message + Record
1
2. 审批流程系统
核心框架 + Admin + Common + WorkFlow + Message + Record
1
3. 商城/电商系统
核心框架 + Admin + Common + Order + Product + Payment + Message + SNS
1
4. 微信公众号/小程序
核心框架 + Admin + Common + PageForm + SNS + doTERRAConnector
1
5. 数据报表系统
核心框架 + Admin + Common + Quartz + doReport + doEDW
1
📝 模块开发规范
1. 项目结构约定
ModuleName/
├── Application/ # 应用服务层
├── Domain/ # 领域层
├── Infrastructure/ # 基础设施层
├── Quartz/ # 任务调度层
├── Web/ # 应用层
└── WebHost/ # 启动器
1
2
3
4
5
6
7
2. 命名规范
- 实体类以
Entity 结尾 - 应用服务接口和实现以
Service 结尾 - 模型映射在
_MapperConfig.cs 中定义 - 模型验证类以
Validator 结尾
3. 模块依赖管理
- 避免循环依赖
- 使用观察者模式解耦
- 通过接口通信，不直接依赖实现
🔗 相关文档
文档维护： 随框架发展持续更新
最后更新： 2022-03-01
📝 更新日志
v1.1 - 2022-08-07
🆕 新增:
- 新增数据访问层完整 API 文档
DarkM-Data-API.md - 基于 Dapper 的轻量级 ORM 封装详细说明
- 支持 SqlServer/MySql/PostgreSQL/SQLite 四种数据库
IDbSet / IDbSet<TEntity> 核心接口完整文档- 批量操作方法（BatchInsert/BulkMerge Upsert）
- 分表操作与数据迁移
- 工作单元（IUnitOfWork）事务控制
- 最佳实践与常见问题
📦 模块更新:
- 新增
DarkM.Module.Product 模块（商品管理） - 新增
DarkM.Module.Payment 模块（支付管理） - 商城系统相关模块归档至
doterra/mall 组织
v1.0 - 2022-03-01
📋 初始版本:
- 完成 42 个模块的完整清单整理
- 按 Git 组织分类汇总
- 框架能力评估与技术债务分析
- 领用三期技术策略说明