DarkM

# DarkM 模块与系统清单

文档版本： 1.0
最后更新： 2022-03-01

术语说明：

  • 模块 = DarkM 模块（如 Admin、Common、WorkFlow 等），是功能单元
  • 系统 = 启动器项目（如 NewOA、JoyIn、StartEDW 等），是独立运行的应用入口
  • 一个系统由多个模块组合而成 模块总数： 18 个模块 + 6 个系统（启动器）

# 📊 模块与系统总览

DarkM 框架包含多个模块，支撑多个业务系统，涵盖 OA 办公、会员管理、商城电商、数据报表等多个领域。

分类 模块数 Git 组织 说明
NewOA 业务系统 8 个 doterra/oa 企业内部管理系统
会员系统 7 个 doterra/member 会员运营、公众号、小程序
商城系统 3 个 doterra/mall 微信商城、海外购
doTERRA 集成 4 个 doterra/darkm doTERRA 系统集成
总计 18 个模块 - -

# 🏢 NewOA 业务系统（doterra/oa）

# 模块组成

NewOA 业务系统（1 个系统 + 7 个模块）
│
├── **NewOA** (系统入口 + 启动器)
│   └── 统一入口、认证、导航
│
├── Recipients (内领模块) ⭐
│   ├── 领用申请
│   ├── 审批流程
│   └── 出库管理
│
├── doBOM (BOM 管理)
│   └── 物料清单管理
│
├── Holiday (休假管理)
│   └── 休假申请审批
│
├── ComplaintOrder (客诉订单)
│   └── 客诉处理
│
├── Project (需求管理)
│   └── IT 需求管理
│
└── FixedAssets (资产管理)
    └── 固定资产管理
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

# 1. NewOA 主系统

项目 说明
Git 地址 https://glab.woowis.com/doterra/oa/NewOA.git
状态 ✅ 已上线
类型 主系统
用户 全体员工
功能 集成所有 NOA 业务模块、统一入口、统一认证、统一权限

核心模块：

  • Admin（权限管理）
  • Common（数据字典）
  • Quartz（任务调度）
  • 各业务模块

# 2. NOA-内领模块 (Recipients) ⭐

项目 说明
Git 地址 https://glab.woowis.com/doterra/oa/Recipients.git
状态 ✅ 已上线（三期升级中）
类型 业务模块
用户 全体员工
功能 内部物品领用申请、审批流程、出库管理、签收确认

核心模块：

  • WorkFlow（流程引擎）
  • Common（数据字典/地址）
  • Message（通知）
  • Order（订单管理）

三期升级内容：

  • 业务流程升级
  • 申请表单优化
  • 批量申领支持（多用户、多订单、多地址）

# 3. NOA-BOM 模块 (doBOM)

项目 说明
Git 地址 https://glab.woowis.com/doterra/oa/doholiday.git
状态 ✅ 已上线
类型 业务模块
用户 生产/采购部门
功能 BOM 管理、物料清单、BOM 结构维护、BOM 版本管理

# 4. NOA-休假模块 (Holiday)

项目 说明
Git 地址 https://glab.woowis.com/doterra/oa/doholiday.git
状态 ✅ 已上线
类型 业务模块
用户 全体员工
功能 假期设定、休假申请、休假审批、休假统计

核心模块：

  • WorkFlow（审批流程）
  • Common（假期类型字典）
  • Message（审批通知）

# 5. NOA-客诉订单模块 (ComplaintOrder)

项目 说明
Git 地址 https://glab.woowis.com/doterra/oa/complaintorder.git
状态 ✅ 已上线
类型 业务模块
用户 客服部门
功能 客诉订单申请、客诉处理流程、客诉跟踪、客诉统计

核心模块：

  • WorkFlow（处理流程）
  • Message（通知）
  • Record（操作记录）

# 6. NOA-需求管理模块 (Project)

项目 说明
Git 地址 https://glab.woowis.com/doterra/oa/project.git
状态 ✅ 已上线
类型 业务模块
用户 IT 部门、需求方
功能 IT 需求收集、需求评审、需求跟踪、需求统计

注意： ⚠️ 这是业务系统层需求管理，与框架层的 DarkM.Module.Project 不同

# 7. NOA-资产管理模块 (FixedAssets)

项目 说明
Git 地址 https://glab.woowis.com/doterra/oa/fixedassets.git
状态 ✅ 已上线
类型 业务模块
用户 行政/财务部门
功能 固定资产管理、资产入库、资产领用、资产折旧、资产盘点

核心模块：

  • Common（资产分类字典）
  • Quartz（折旧计算）
  • Record（操作审计）

# 👥 会员系统（doterra/member）

# 模块组成

会员系统生态（3 个系统 + 4 个模块）
│
├── JoyIn (香荟多特瑞公众号) 🌟
│   ├── 微信业务功能
│   └── SNS + CRM 整合
│
├── EssentialOil (相遇精油小程序) 🌟
│   ├── 精油产品展示销售
│   └── PageForm 驱动
│
├── StartEDW (数据仓库启动器) 🌟
│   ├── 报表管理
│   └── 数据仓库
│
├── doEvent (活动管理)
│   └── 会员活动
│
├── CRM (客户关系)
│   └── 客户管理
│
├── doReport (报表管理)
│   └── 数据可视化
│
└── doEDW (数据仓库)
    └── 财务数据
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# 8. 香荟多特瑞公众号 (JoyIn) 🌟

项目 说明
Git 地址 https://glab.woowis.com/doterra/member/joyin.git
状态 ✅ 已上线
类型 业务模块
平台 微信公众号
用户 会员用户
功能 香荟多特瑞公众号系统、微信业务功能、启动器功能

核心模块：

  • 核心管理模块
  • Common（数据字典）
  • Quartz（定时任务）
  • SNS（社交模块）- 用户动态、分享
  • CRM（客户关系）- 会员管理

技术特点：

  • 社交 +CRM 整合
  • 会员运营平台
  • 微信生态集成

# 9. 相遇精油小程序 (EssentialOil) 🌟

项目 说明
Git 地址 https://glab.woowis.com/doterra/member/essentialoil.git
状态 ✅ 已上线
类型 业务模块
平台 微信小程序
用户 消费者
功能 精油产品展示与销售、业务功能 + 启动器功能

核心模块：

  • 核心管理模块
  • Common（数据字典/地址）
  • Quartz（定时任务）
  • PageForm（页面配置）- 灵活配置

技术特点：

  • PageForm 驱动
  • 小程序开发模式
  • 电商功能

# 10. 数据仓库系统 (StartEDW) 🌟

项目 说明
Git 地址 https://glab.woowis.com/doterra/member/startedw.git
状态 ✅ 已上线
类型 启动器
用户 管理层、财务
功能 DarkM 数据仓库/报表/Dashboard 启动项目、统一入口

核心模块：

  • 核心管理模块
  • Common（数据字典）
  • Quartz（定时任务）
  • doReport（报表管理）
  • doEDW（数据仓库）

技术特点：

  • 数据仓库入口
  • 财务报表生成
  • Dashboard 展示

# 11. 会员活动模块 (doEvent)

项目 说明
Git 地址 https://glab.woowis.com/doterra/member/doEvent.git
状态 ✅ 已上线
类型 业务模块
功能 会员活动创建与管理、活动报名、活动签到、活动统计

# 12. 客户关系模块 (CRM)

项目 说明
Git 地址 https://glab.woowis.com/doterra/member/crm.git
状态 ✅ 已上线
类型 业务模块
用户 销售/客服
功能 客户信息管理、客户分类、客户跟进、销售漏斗、客户分析

# 13. 报表模块 (doReport)

项目 说明
Git 地址 https://glab.woowis.com/doterra/member/doReport.git
状态 ✅ 已上线
类型 业务模块
功能 Management Dashboard、报表配置、报表生成、数据可视化

# 14. 数据仓库模块 (doEDW)

项目 说明
Git 地址 https://glab.woowis.com/doterra/member/doedw.git
状态 ✅ 已上线
类型 业务模块
功能 DarkM 数据仓库（财务报表）、财务数据存储、数据 ETL、财务报表生成

# 🛍️ 商城系统（doterra/mall）

# 模块组成

商城系统生态（2 个系统 + 1 个模块）
│
├── doMall (微信商城)
│   └── 新老框架数据桥接
│
├── StartWechatMini (微信商城小程序) 🌟
│   ├── 微信商城业务
│   └── 最完整的模块组合
│
└── StartHWGWechatMini (海外购公众号商城) 🌟
    ├── 跨境购业务
    └── 简化模块组合
1
2
3
4
5
6
7
8
9
10
11
12

# 15. 微信商城数据桥接模块 (doMall)

项目 说明
Git 地址 https://glab.woowis.com/doterra/mall/doMall.git
状态 ✅ 已上线
类型 数据桥接层（无业务逻辑）
功能 新框架调用老.Net Framework 商城数据、新旧系统数据桥接

技术特点：

  • 新旧系统过渡方案
  • 数据同步/迁移
  • API 网关功能

# 16. 微信商城小程序 (StartWechatMini) 🌟

项目 说明
Git 地址 https://glab.woowis.com/doterra/mall/doTERRANewWechatMini.git
状态 ✅ 已上线
类型 启动器
平台 微信小程序
用户 消费者
功能 微信商城小程序启动项目、统一入口、统一认证、统一导航

核心模块：

模块 用途
核心管理模块 认证/权限/导航
Common 数据字典/地址区域
Quartz 定时任务
doEvent 会员活动管理
Message 消息通知（订单通知）
SNS 社交模块（分享/裂变）
PageForm 页面配置
MobileApp APP 管理
doTERRAConnector 统一接口（第三方集成）

技术特点：

  • 模块最全，功能最完整
  • 社交电商整合
  • 微信生态深度集成

# 17. 海外购公众号商城 (StartHWGWechatMini) 🌟

项目 说明
Git 地址 https://glab.woowis.com/doterra/mall/dohwgministart.git
状态 ✅ 已上线
类型 启动器
平台 微信公众号
用户 跨境购消费者
功能 海外购公众号商城启动项目、跨境购业务

核心模块：

模块 用途
核心管理模块 认证/权限/导航
Common 数据字典/地址区域
Quartz 定时任务
Message 消息通知
SNS 社交模块
PageForm 页面配置
doTERRAConnector 统一接口（海关/物流）

技术特点：

  • 跨境购业务
  • 海关接口集成
  • 物流跟踪

# 📱 doTERRA 集成项目（doterra/darkm）

# 18. doTERRA 集成模块

系统 Git 地址 功能
DarkM.MobileApp doterra/darkm/mobileapp.git APP 管理、版本管理、更新推送
DarkM.FileExplorers doterra/darkm/fileexplorers.git 文件管理、文档存储、在线预览
DarkM.doTERRAConnector doterra/darkm/doterraconnector.git 所有第三方接口统一实现
DarkM.Survey doterra/darkm/survey.git 问卷调查、数据收集

# 📊 模块使用统计

# 系统用户规模

系统（启动器） 用户数 DAU 说明
NewOA 主系统 全体员工 高 日常办公
内领系统 全体员工 中 物品领用
休假管理 全体员工 中 休假申请
JoyIn 公众号 会员用户 高 会员运营
相遇精油小程序 消费者 高 电商销售
微信商城小程序 消费者 高 电商销售
海外购公众号 跨境购用户 中 跨境购

# 模块使用频率

模块 使用系统数 说明
Common 18/18 所有系统
Quartz 15/18 定时任务需求
Message 12/18 通知需求
SNS 5/18 社交需求
PageForm 5/18 灵活配置需求
WorkFlow 4/18 审批流程需求
doTERRAConnector 4/18 第三方集成需求

# 🎯 系统与模块组合模式

# 启动器模式

特点：

  • 统一入口、认证、导航
  • 模块可插拔
  • 快速构建新系统

代表系统（启动器）：

  • StartNOA（NewOA 入口）
  • JoyIn（公众号入口）
  • EssentialOil（小程序入口）
  • StartEDW（数据仓库入口）
  • StartWechatMini（商城小程序入口）
  • StartHWGWechatMini（海外购入口）

标准结构：

启动器系统
├── 核心管理模块（认证/权限/导航）
├── Common（数据字典/地址）
├── Quartz（定时任务）
└── 业务模块（按需组合）
1
2
3
4
5

# 数据桥接模式

特点：

  • 新旧系统过渡
  • 数据同步/迁移
  • API 网关

代表系统（启动器）：

  • doMall（新老商城数据桥接）

# 微服务集成模式

特点：

  • 第三方接口统一
  • 服务解耦
  • 可复用

代表模块：

  • doTERRAConnector（所有第三方接口统一实现）

# 📝 模块与系统开发规范

# 1. 命名规范

  • 业务模块：功能名称
  • 系统（启动器）：Start + 功能名称
  • 模块：Module/功能名称

# 2. Git 组织

  • framework/darkm - 核心框架
  • woowis/darkm - 业务模块
  • doterra/oa - NewOA 系统
  • doterra/member - 会员系统
  • doterra/mall - 商城系统
  • doterra/darkm - doTERRA 集成

# 3. 部署方式

  • 单体部署 - 多个模块集成为一个系统（启动器项目）
  • 独立部署 - 单个系统独立部署
  • Docker 部署 - 容器化部署

# 🔗 相关文档

文档维护： 随框架发展持续更新
最后更新： 2022-03-01

术语说明：

  • 模块 = DarkM 模块（如 Admin、Common、WorkFlow 等），是功能单元
  • 系统 = 启动器项目（如 NewOA、JoyIn、StartEDW 等），是独立运行的应用入口
  • 一个系统由多个模块组合而成

← 依赖注入 →