@quick-qui/model-server

@quick-qui/model-server

负责载入、解析、维护和发布模型。 关于模型的各种规则和计算在此执行 （但不在此定义，定义见 @quick-qui/model-defines。）

相关概念

• 模型库（repository） 与模型源、模型文件共同组成模型的描述系统。一个模型库一般对应一个模型空间，也就是一个系统的全部模型描述。一个模型库有一个主要的模型源，可能是文件夹、url 地址等等形式，一个模型源可以包含（include）其他源。每个模型源包含多个模型文件。模型文件按类似于文件夹的形式树形组织，不同文件夹内的模型文件对应不同的命名空间。
• 模型源（source） （见上条）
• 模型文件（file） （见上条）
• 包含（include） - 一个模型源可以包含一个或多个其他源，也就是一个模型库包含多个源。
• 日志（log） - 载入、解析、合并、编织等活动都有详尽记录。

如何工作

• 作为 node 服务运行起来。
• 从模型库（repository）地址加载模型源文件。
• 如果有导入（include），则加载被导入的模型源。
• 根据源文件的特征载入对应的模型定义。（模型定义为可扩展，详见 @quick-qui/model-defines）
• 所有的源文件验证（validate）以后解析为模型片段，合并到模型空间中。此处的验证是对源文件和片段的局部验证。
• 验证，特别是在模型空间范围的合法性。
• 编织（weave）。
• 处理完毕的常驻，随时可以查询，除非人为触发刷新（refresh），不会重新载入处理。
• 处理过程有记录，可以通过接口查询。

如何运行

• 作为node服务单独运行 - npm start
• 作为@quick-qui/builder的一部分运行，其背后也是通过子进程调用1.的方式。
• 作为“成品运行时“的一部分运行，其运行方式根据launcher类型的不同而不同。详细见@quick-qui/launcher相关说明。

所需环境

MODEL_PATH	环境变量	string， 必填。	指出模型项目所在的路径。本地路径，可以是相对路径。
PORT	环境变量	int，可选，默认1111	服务监听的端口。

接口

	URL	方法	参数	说明
获取模型列表	/models	GET		🏃（目前没有明确定义模型 id，只能使用“default”作为 id）
获取模型对象	/models/:id	GET	id:string, 模型 id	如果返回 404，可能是模型载入不成功，可获取对应的日志查看具体原因。
获取载入过程日志	/models/:id/logs	GET
获取模型对应的模型源信息	/models/:id/modelSources	GET
刷新模型	/models/:id/refresh	POST		下次 get 的时候会重新运行载入全过程