mm_os 5.0.1 → 5.0.3

package/README.md

@@ -1,13 +1,12 @@
 # mm_os
 
-这是 OS 系统模块，超级美眉服务端的核心框架。负责初始化日志、注册管理、加载输入 / 输出适配器、缓存与数据库、应用加载器，并驱动应用与插件的完整生命周期。
+这是 OS 系统模块，超级美眉服务端的核心框架。负责初始化日志、注册管理、加载输入适配器、缓存与数据库、应用加载器，并驱动应用与插件的完整生命周期。
 
 ## 功能特点
 
 - `OS` 类：初始化日志、管理、适配器、存储与应用加载器
 - 输入适配器：web / mqtt / socket / websocket
-- 输出适配器：redis / mongodb / mysql / sqlite / jsondb / file
-- 工具：lang / tpl / ret 
+- 存储：`cache`（redis / mongodb 等）与 `sql`（mysql / sqlite / jsondb 等），由 `mm_cache` / `mm_sql` 统一装配
 - 管理：service / handle / event / api / param / dao / templete / pendant / timer / statics
 - `Loader` 类：扫描应用目录，加载应用与插件的配置、生命周期和资源清单
 - `osAdmin(scope, config)` 按作用域缓存系统实例，相同 `scope` 返回同一实例
@@ -44,12 +43,17 @@ const os = osAdmin('os', {
 - `scope`：作用域名称，缺省为 `'os'`
 - `config`：系统配置
   - `in_adapters`：输入适配器列表，默认 `['web', 'mqtt', 'socket', 'websocket']`
-  - `out_adapters`：输出适配器列表，默认 `['redis', 'mongodb', 'mysql', 'sqlite', 'jsondb', 'file']`
-  - `tools`：工具列表，默认 `['lang', 'tpl', 'ret', 'service', 'handle']`
-  - `admins`：管理列表，默认 `['event', 'api', 'param', 'sql', 'templete', 'pendant', 'timer', 'statics']`
-  - `cache` / `db`：缓存与数据库配置
+  - `admins`：管理列表，默认 `['event', 'api', 'param', 'dao', 'service', 'template', 'pendant', 'timer', 'static']`
+  - `daos`：数据域列表，默认 `['os', 'user', 'org', 'project', 'client', 'app']`，业务用 `daoAdmin('user')` 等取用
+  - `dao_<域>`：给单个数据域指定数据源，如 `dao_org = { sql: { way: 'sqlite', sqlite: { dir: './db/', database: 'org_{org_id}' } } }`；未配置的域复用主库
+    - 配置里含 `{org_id}` 时该域按机构分库：只登记模板，用 `daoAdmin('org', { org_id })` 取到该机构独立的库（`org_{org_id}.db`）；接口侧从 query 参数 `org_id` 解析（页面路由 `/ai/{org_id}/` 兜底）
+    - 固定域（如 `user`）直接 `daoAdmin('user')`，一域一库
+  - `cache` / `sql`：缓存与数据库配置（含 `redis` / `mongodb` / `mysql` / `sqlite` / `jsondb` 子项）
   - `web` / `mqtt` / `socket` / `websocket`：各入站适配器端口配置
 
+> `out_adapters` 与 `tools` 已废弃：存储统一走 `cache` / `sql`，语言与模板由各模块自行初始化。
+> 若仍显式传入这两个配置，启动时会打印一条 `warn` 提示并忽略。
+
 ### `OS`
 
 | 方法 | 说明 |
@@ -59,15 +63,21 @@ const os = osAdmin('os', {
 | `log(type, msg, ...args)` | 输出日志 |
 | `reg(name, admin)` | 注册管理对象 |
 | `require(mod_name)` | 加载模块 |
-| `initAdapter()` | 初始化输入 / 输出适配器并初始化事件总线 |
-| `initTools()` | 初始化工具 |
+| `initAdapter()` | 初始化输入适配器（输出适配器已废弃，存储由 `initpStorage()` 负责） |
 | `initAdmins()` | 初始化管理 |
+| `initDaos()` | 初始化数据域（os/user/org/project/client/app），注册为 `dao:<域>` |
+| `_initModules(list, label, collect)` | 按清单加载模块：绑定服务器 → 取管理器 → 初始化 → 注册 |
 | `initpStorage()` | 初始化缓存与数据库 |
 | `initLoader()` | 初始化应用加载器 |
+| `_bindMqttHostServices()` | 向 `mm_mqtt` 管理器注入宿主服务（`get_db` 数据库、`event_bus` 事件总线） |
 | `initEventBus()` | 初始化事件总线 |
 | `start()` | 启动全部适配器、缓存、数据库与应用 |
 
-OS 实例属性：`admins`、`in_adapters`、`out_adapters`、`cache`、`sql`、`logger`、`loader`、`eventer`。
+> `mm_mqtt` 的设备状态入库与事件派发采用宿主注入：未注入 `get_db` 时会跳过入库并打印
+> `未配置 get_db，跳过设备状态入库`。`initLoader()` 与 `start()` 会自动把系统 `sql` 实例与
+> `eventer` 注入到所有 MQTT 管理器，无需在应用内重复配置。
+
+OS 实例属性：`container`、`config`、`in_adapters`、`cache`、`sql`、`logger`、`loader`、`eventer`、`app`。
 
 ### `Loader`
 

package/index.js

@@ -5,22 +5,21 @@ const Admin = require('mm_corejs').Admin;
 let admin = new Admin();
 admin.setClass(OS);
 
-/**
- * 获取系统实例
- * @param {string} scope 作用域
- * @param {Object} config 配置参数
- * @returns {OS} 系统实例
- */
-function osAdmin(scope, config) {
-  if (!scope) {
-    scope = 'os';
-  }
-  return admin.get(scope, config);
-}
 
 module.exports = {
   OS,
   Loader,
   admin,
-  osAdmin
+  /**
+   * 获取系统实例
+   * @param {string} scope 作用域
+   * @param {Object} config 配置参数
+   * @returns {OS} 系统实例
+   */
+  osAdmin(scope, config) {
+    if (!scope) {
+      scope = 'os';
+    }
+    return admin.get(scope, config);
+  }
 };

package/lib/config.js

@@ -0,0 +1,104 @@
+/**
+ * OS 默认配置
+ * 系统类只负责加载，配置数据在此集中声明，由 lib/os.js 的 static config 装载；
+ * 宿主实例化 OS 时传入的 config 会与之深合并覆盖。
+ */
+
+/**
+ * 系统默认配置对象
+ * @type {object}
+ */
+const os_config = {
+  name: 'os',
+  // 路径根：所有相对路径配置（jsondb/sqlite/tpl/log/loader）都相对此目录解析，
+  // 为空时取 process.cwd()；宿主可用它把运行期路径与启动目录解耦
+  root: process.env.MM_ROOT || '',
+  // 装配清单默认最小化（D-17 阶段 2）：内核只保证 web 入口 + 事件/API 两个基础管理器。
+  // mqtt/socket/websocket 适配器与 param/dao/service/template/pendant/timer/static 等管理器
+  // 由宿主显式声明（见 example/demo.js）；可选角色可加 required: false，缺失时降级跳过；
+  // 清单模块支持按通道 cwd 解析，缺失时错误信息给出 os.moduleInstall 安装指引
+  in_adapters: [{
+    name: 'web',
+    module: 'mm_web_server'
+  }],
+  // 管理模块
+  admins: [{
+    name: 'event',
+    module: 'mm_event'
+  }, {
+    name: 'api',
+    module: 'mm_api'
+  }],
+  // 数据域：默认只建内核自身的 os 域。业务域（user/org/project/client/app 等）
+  // 是业务概念，不由内核预设——宿主按需声明 config.daos = ['os','user',...]，
+  // 每个域可独立配置数据源（config.dao_<域> = { sql: {...} }），未配置时复用主库
+  daos: ['os'],
+  cache: {
+    type: 'redis'
+  },
+  sql: {
+    type: 'mysql'
+  },
+  web: {
+    port: 8000
+  },
+  mqtt: {
+    port: 1883
+  },
+  socket: {
+    port: 9000
+  },
+  websocket: {
+    port: 9001
+  },
+  jsondb: {
+    dir: './data'
+  },
+  // 存储凭据一律从环境变量读取（MM_* 前缀），默认值为空：
+  // 库内不携带任何真实口令；未提供凭据时相关存储无法连接，启动阶段会显式报错（fail-fast）
+  mysql: {
+    host: process.env.MM_MYSQL_HOST || '127.0.0.1',
+    port: Number(process.env.MM_MYSQL_PORT) || 3306,
+    user: process.env.MM_MYSQL_USER || 'root',
+    password: process.env.MM_MYSQL_PASSWORD || '',
+    database: process.env.MM_MYSQL_DATABASE || 'mm'
+  },
+  redis: {
+    host: process.env.MM_REDIS_HOST || '127.0.0.1',
+    password: process.env.MM_REDIS_PASSWORD || '',
+    port: Number(process.env.MM_REDIS_PORT) || 6379,
+    db: Number(process.env.MM_REDIS_DB) || 0
+  },
+  mongodb: {
+    host: process.env.MM_MONGO_HOST || '127.0.0.1',
+    port: Number(process.env.MM_MONGO_PORT) || 27017,
+    user: process.env.MM_MONGO_USER || 'root',
+    password: process.env.MM_MONGO_PASSWORD || '',
+    database: process.env.MM_MONGO_DATABASE || 'mm'
+  },
+  sqlite: {
+    dir: process.env.MM_SQLITE_DIR || './db',
+    database: process.env.MM_SQLITE_DATABASE || 'mm'
+  },
+  ret: {
+    type: 'json-rpc'
+  },
+  lang: {
+    type: 'zh_cn'
+  },
+  tpl: {
+    dir: './static/template',
+    ext: '.html'
+  },
+  loader: {
+    // 应用目录必填：内核不再回退到包内 example/app（生产会静默加载示例应用）。
+    // 由宿主显式指定相对 root 的路径；传 false 表示本实例不加载应用
+    dir: ''
+  },
+  // 模块通道：基于 mm_module 的动态安装/卸载/热更新（见 os.moduleInstall 等）。
+  // false 显式关闭；未安装 mm_module 时自动降级停用；
+  // 对象形式透传 ModuleManager 配置（cwd 默认取 root，可注入 runner/registry/prefix）
+  modules: {}
+};
+
+module.exports = os_config;