5. References
【免费下载链接】platformHuly — All-in-One Project Management Platform (alternative to Linear, Jira, Slack, Notion, Motion)项目地址: https://gitcode.com/GitHub_Trending/platform80/platform
- Document Control SOP
- Document Review Procedure
要点说明: - 链接指向同空间内的同级文档(`[SOP-001] Document Control.md`)和子文件夹中的子文档(`[SOP-001] Document Control/[SOP-002] Document Review.md`); - 由于文件名包含空格,链接中需对空格进行 URL 编码(`%20`),方括号保留原样; - 从仓库根目录视角看,上述两个引用目标分别对应 [SOP-001] Document Control.md 与 [SOP-002] Document Review.md,这是"模板 + 模板实现"的标准层级关系。 ## 7. 模板与受控文档的关系链 把 QMS 空间的三个文件串联起来,可以得到完整的模板使用链路: 1. **模板定义**:[SOP-001] Document Control.md 以 `documents:mixin:DocumentTemplate` 定义标准操作程序模板,声明 `docPrefix: SOP` 作为受控文档代码前缀; 2. **受控文档实例化**:[SOP-002] Document Review.md 与 [WI-001] Document Template Usage.md 都以 `documents:class:ControlledDocument` 创建,并通过 `template` 字段指向模板; 3. **约束条件**(见 [统一格式导入指南](https://link.gitcode.com/i/f1307a8ec7f61421c845b6efc4c40233) 的 Limitations 一节):文档代码(方括号内)必须在所有文档空间内唯一;受控文档必须与其模板位于同一空间;受控文档导入时只能是 `Draft` 状态。 也就是说,[WI-001] 既是"教人用模板"的操作指南,它自身又是一份完整应用了模板机制的受控文档——文档即范例。 ## 8. 导入实操:将 QMS 文档空间导入 Huly 完成目录与 frontmatter 编写后,即可使用 import-tool 的 `import` 命令批量导入。命令入口见 [dev/import-tool/src/index.ts](https://link.gitcode.com/i/61fee9099b1878c73502e3ba5cdf8967),其底层通过 `HulyFormatImporter.importFolder(dir)` 递归处理目录,`authorize` 函数负责登录、查找工作区并建立与 Transactor 的连接。 推荐运行方式(Docker,摘自 [dev/import-tool/README.md](https://link.gitcode.com/i/1be4d5c7964247ee7d65cc884c740b37)): ```bash docker run \ -e FRONT_URL="https://huly.app" \ -v /path/to/workspace:/data \ hardcoreeng/import-tool:latest \ -- bundle.js import /data \ --user your.email@company.com \ --password yourpassword \ --workspace workspace-id也可以基于源码直接运行(见 src/index.ts 中的注释示例):
node bundle.js import <workspace-dir> --workspace ws1 --user user1 --password 1234【免费下载链接】platformHuly — All-in-One Project Management Platform (alternative to Linear, Jira, Slack, Notion, Motion)项目地址: https://gitcode.com/GitHub_Trending/platform80/platform
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考