# @cocreate/organizations 中文文档

规范地址：https://npmcn.com/package/%40cocreate/organizations/

版本：3\.0\.2
npm 元数据更新时间：2026-11-07T02:37:37.920Z
中文译文更新时间：2026-11-10T05:29:27.245Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cocreate/organizations
原文对照：https://npmcn.com/package/%40cocreate/organizations/?lang=original
项目主页：https://cocreatejs.com/docs/organizations
源码仓库：https://github.com/CoCreateJS/organizations

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：213 kB，28 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：7 个
- 首次发布：2021-03-29T04:20:57.236Z
- 最新版本发布：2026-11-07T02:37:37.747Z
- 近 30 天下载量：2718（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：285（近 12 个月 15 个）

## 中文简介

一个简单的组织组成 在香草javascript。 使用 HTML5 属性和/或 JavaScript API 轻松配置.

## 安装

```sh
npm install @cocreate/organizations
```

也可以使用：`pnpm add @cocreate/organizations`、`yarn add @cocreate/organizations`、`bun add @cocreate/organizations`

## README

# 创造组织

一个简单的组织组成 在香草javascript。 使用 HTML5 属性和/或 JavaScript API 轻松配置. 把它当作我们的旋转 [游乐场!](https://cocreatejs.com/docs/organizations)

![minified](https://img.badgesize.io/https://cdn.CoCreateJS.com/organizations/latest/CoCreate-organizations.min.js?style=flat-square&label=minified&color=orange) ![gzip](https://img.badgesize.io/https://cdn.CoCreateJS.com/organizations/latest/CoCreate-organizations.min.js?compression=gzip&style=flat-square&label=gzip&color=yellow) ![brotli](https://img.badgesize.io/https://cdn.CoCreateJS.com/organizations/latest/CoCreate-organizations.min.js?compression=brotli&style=flat-square&label=brotli) ![GitHub latest release](https://img.shields.io/github/v/release/CoCreateJS/organizations?style=flat-square) ![License](https://img.shields.io/github/license/CoCreateJS/organizations?style=flat-square) ![Hiring](https://img.shields.io/static/v1?style=flat-square&label=&message=Hiring&color=blueviolet)

![CoCreate-organizations](https://cdn.cocreatejs.com/docs/CoCreate-organizations.gif)

## [文档和演示](https://cocreatejs.com/docs/organizations)

完整的指南和工作演示请参见 [贴花](https://cocreatejs.com/docs/organizations)

## 光盘N

```html
<script src="https://cdn.CoCreateJS.com/organizations/latest/CoCreate-organizations.min.js"></script>
```

```html
<script src="https://cdn.CoCreateJS.com/organizations/latest/CoCreate-organizations.min.css"></script>
```

## 国家预防机制

```shell
$ npm i @cocreate/organizations
```

## 线条

```shell
$ yarn install @cocreate/organizations
```

# 目录

-   [目录](https://npmcn.com/package/%40cocreate/organizations/#readme-table-of-contents)
-   [通知](https://npmcn.com/package/%40cocreate/organizations/#readme-announcements)
-   [路线图](https://npmcn.com/package/%40cocreate/organizations/#readme-roadmap)
-   [如何贡献](https://npmcn.com/package/%40cocreate/organizations/#readme-how-to-contribute)
-   [关于](https://npmcn.com/package/%40cocreate/organizations/#readme-about)
-   [许可证](https://npmcn.com/package/%40cocreate/organizations/#readme-license)

# 通知

图书馆的所有更新都记录在我们 [变化](https://github.com/CoCreateJS/organizations/blob/master/CHANGELOG.md) 财务报告和审定财务报表 [释放](https://github.com/CoCreateJS/organizations/releases)。您也可以订阅电子邮件以发布和中断更改.

# 路线图

如果你对这个项目的未来方向有兴趣, 请看看我们的开放 [问题](https://github.com/CoCreateJS/organizations/issues) 财务报告和审定财务报表 [拖动请求](https://github.com/CoCreateJS/organizations/pulls)我们想听听你的反馈.

# 关于

创造组织由创造者开发者经验团队指导和支持.

请发电子邮件给开发者体验团队 [这里](mailto:develop@CoCreateJS.com) 如果有任何疑问.

创造组织由创造组织维护和资助. CoCreate的名称和标志是CoCreate,LLC的商标.

# 如何贡献

我们鼓励为我们的图书馆捐款(你甚至可能得分) [捐款](https://github.com/CoCreateJS/organizations/blob/master/CONTRIBUTING.md) 详细指南.

我们希望这个图书馆由社区驱动, Coreate 领导。 我们需要你的帮助来实现这一目标。 为了帮助确保我们按正确的顺序建造正确的东西,我们请你们创造 [问题](https://github.com/CoCreateJS/organizations/issues) 财务报告和审定财务报表 [拖动请求](https://github.com/CoCreateJS/organizations/pulls) 或只是对现有问题进行投票或发表意见或提出请求.

我们感谢你的继续支持,谢谢!

# 许可证

[《麻省理工学院许可证》](https://github.com/CoCreateJS/organizations/blob/master/LICENSE)

### 已认证的注册

注册表运行 `signUp`, (中文(简体) ), `signIn`,则 `createOrganization`服务器 解决经认证的套接字上签名的配置文件和证书; 客户端提供的用户、密钥、靴子和存储器元数据无法确定 新的租户的身份或提供证明.

`server.organizations.create(data)` 协调这些工作流程,以便:

1.  用服务器生成的ID注册一个平台组织.
2.  运行 `create-organization-database` 在平台上下文。 工作流程创建 供应商存储,坚持 `bootstrapStorage` 在平台记录, 并返回同一对象。 处理者验证这种持久性.
3.  安装平台定义 `create-organization` 租户的工作流程 数据库,然后在租户背景中执行它来写组织, 经认证的用户配置文件、证书和生成的密钥 .
4.  生成一个组织集群ID并运行 `create-organization-cluster` 在平台上下文中,然后安装可信任的定义,并在租户上下文中运行,使用同一组. 这两个组织的记录都收到其记录 `cluster_id`。 。 。 .
5.  运行 `create-organization-repository` 在平台上下文。 它创造了一个私人 从模板的仓库 `main`,输入初始上传配置,并 创建 `dev` 财务报告和审定财务报表 `test` 从同样的承诺。 仓库参考文献为 保留在平台和租户组织记录上.
6.  等着 `server.manager.createServer(cluster)` 与已完成的集群和 注册的仓库。 管理器使用集群。 初始 部署和持续 服务器目录和两个范围中的供应商身份.
7.  注册就绪,并返回安全组织摘要+ `https://<tenant-host>/auth/`部署证书,以及 内部管理员的反应,永远不归还给客户.

客户端在成功后创建了组织. 现有残废 注册按钮通过超时显示旋转器( 60 000); 然后动作 沿着链条完成后返回的螺旋。 创建失败中止 链条不改变方向。 固定延迟不验证启动或上传 完成;在租户节点上继续进行.

工作流程源记录在 CoCreate App 中直播 `src/apps/workflows/config/{data,organization,cluster,repository}.js`稳定记录身份证 允许重复上传,而无需重复定义。 工作流程名称为 可配置通过 `organizations.databaseWorkflow`, (中文(简体) ), `organizationWorkflow`, (中文(简体) ), `clusterWorkflow`,以及 `repositoryWorkflow`。检查所有四个启用的平台定义 在创建新的组织记录之前.

拖带对象需要非空 `name` 财务报告和审定财务报表 `provider` 字符串; 剩余 字段没有改变。 此外,目前的Atlas数据库配方 需求 `cloudProvider`, (中文(简体) ), `regionName`,以及 `cidrBlock` 内 `organizations.databaseProvisioning`,带有配置的提供者证书和 结束点。 该工作流程一直被禁用,直至其供应商设置完成.

仓库食谱使用 `organizations.repositoryProvisioning` 页:1 `api`, (中文(简体) ), `templateOwner`,以及 `templateRepository`。配置了管理中的 GitHub API 必须有一个 `owner`,证书,以及模板/文件/分支/部署键端点. 仓库名称仍然是稳定的组织ID. 平台的工作流程 `initialConfig` AST 是权威的初始文件定义: 它包括 上传目录规则,租户组织ID,一个空的API键占位符, 财务报告和审定财务报表 `main`编号 :`dev`编号 :`test` 主机映射. 随后上传解析 API 密钥 在基特门外 配置在注册时生成一次, 而不是在节点重新启动时生成 .

顺序不是交易 失败者保留平台组织 与 `provisioning.status: "failed"` 数据库/租户/仓库阶段状况. 部分GitHub故障可离开仓库或分支进行调查; 自动恢复、回滚和清理没有实施。 复制 寄存器创建是一个错误,而不是允许覆盖它. 创建前检查主机名的可用性; 仍在同时签名 需要数据库强化的独特性.

此路径通过 API 准备寄存器; 它不会克隆本地 退出或运行 `coc upload`. 初次应用出版物仍然是单独的 下一个阶段 集群 UI 创建只选择已有存储并创建 集群/服务器资源;它不重复注册。 集群主检出和应用出版 与注册数据库和寄存器创建分离.

服务器准备好后初始化 :

```js
const Organizations = await import("@cocreate/organizations");
await Organizations.init(server);
```

旧的 `server.organizations.provision` Git/ Mirror 创建路径被删除 . 注册是主要管理的组织/数据库/存储器创建途径. 真实工作流程注册集成测试在 CoCreate App 中 `test/bootstrap-workflow.test.js`;它们取代了已过时的原生基特 提供测试装置.

### 注册时仓库访问

在提供租户数据库和初始组织/用户/密钥数据后,服务器生成一个针对存储器的RSA SSH密钥对. 它在租户的房契上 存放一名残疾人士 `apis` 打电话前 `create-organization-repository`;只有公钥和API-record ID输入该工作流程. 工作流程创建/配置寄存器,在 HTTPS 上读取 GitHub SSH 主机校验密钥, 并通过 W `create-repository-deploy-key`. 仓库元数据包括它的SSH克隆URL,HTTPS克隆URL,认证APIID,以及部署密钥ID.

服务器然后用返回的引用和主机密钥激活租户API记录,然后报告注册准备. 没有私有密钥被复制到平台组织,工作流程有效载荷,GitHub请求,寄存器配置或签名响应. 注册/ 持久性失败的叶子注册失败, 其证书待签; 重试/ 清理不是自动的 。 GitHub 集成证书需要寄存器 行政部门编写权限来注册部署密钥. 部署密钥没有内置过期;明确旋转被推迟。 GitHub 仍然可能取消/删除密钥,包括用于创建部署密钥的 PAT 被删除时.

节点大师在开始和关闭前从他们自己的组织API记录中取回此证书. 旋转和初始应用程序上传仍然是单独的工作.

### 组织群组

集群有自己的服务器生成 `_id`,与 `name` 等于生成的组织ID, `type: 'organization'`,以及租户的主要主机名。 平台记录先被创建;其定义再被复制到租户数据库中,使用相同的 `_id`20\. 范围元数据仍然是每个数据库的局部数据. `organizations.clusterProvisioning` 用品信任的部署默认;客户集群ID,名称,类型和主机不能覆盖生成的身份. 默认 `scaleIn.minClusterSize` 以 0 表示,而且 超值必须是非负整数. `initialDeployment` 需要并复制到两个集群记录: 注册当前使用云 API `65f8ca227b39a3c1a8904e02`区域 `us-east-1`类型 `t3a.small` 从信任的配置。 这些是未来部署选择 UI 的静态默认; 今天客户端的签名输入不能覆盖它们 .

默认记录创建身份和最小比例政策. 云、存储、路由、二进制和大小设置必须通过信任提供 `clusterProvisioning` 或配置在部署前; 注册不会猜测这些证书, 现在需要配置的部署路径才能成功 。 这个 `create-organization-cluster` 工作流程也写 `cluster_id` 输入每个范围内的相应组织。 失败的平台或租户集群写入无法完成注册 。 此步骤不会创建或修改租户运行时间启动脚本. 单独的平台部署处理器使用croup.manager. 作为节点组织ID而不改变平台CRUD执行范围.

### 集群拥有的储存库

在寄存器工作流程返回其 GitHub 细节后, 部署密钥是 启动, 注册后将其寄存器定义附加到已创建 以平台和租户范围分组。 两者都收到同样的 URL,证书 参考,主分支,相对本地FsRoot ./,目录,生命周期超时 并初始加载 {已启用: true, 已完成: false} 。 现有可信任的仓库 保留分组中的条目。 组合写入失败 阻止注册准备.

URL 识别数组条目 。 没有仓库条目 ID 或服务器配置 生成仓库记录。 保留组织基特元数据 引用,但 Cluster startup 读作 Cluster.resitories 而不是导出 运行时间配置从元数据。 分组初级课程现在在离职和服务后进行初步出版 准备,并保留组群/URL。 单是报名和克隆并不表示 初始 Up 装入完成; 只有成功上传才能完成 .

### 集群管理证书

在两个组织组的拷贝都存在后,就发出报名电话 src/server/集群-管理.js. 它读取了App平台的无键权限 引用 (6b0700000000000000000000000021), 生成 Utils UUID, 并创建活动 包含集群/租户所有权元数据,既不管理也不管理 默认访问。 没有创建租户运输 API 或终点 .

第一VM处理器解决了那个密钥,并将其存储在管理器中. 双键 服务器副本,与母组织ID和主机名并列。 分组读取 此对象在当前启动搜索中进入主运行时间. 自动缩放器使用服务器. manager. send to POST 到父方/管理路径, 而不是 而不是使用配置的运输 API。 钥匙不在基特 注册回复, VM工作流程输入和云启动脚本.

权限引用限制创建- intance/ delet- intance 端点通过 授权 $endpoint 运算符 。 集群/提供者 AST 的上游部分仍然分开. 失败的管理键写入会阻止注册准备 。 现有集群和 额外的集群 UI 创建不会自动回填.

管理组元数据作为管理器存储 : {organization id, host, for}: 第一部 有两个值表示平台,而租户组织是身份证。 注册指定 并保存在两个集群副本中. 名称从生成的组织ID开始,但是一个显示标签,可以重新命名. 初始部署和寄存器是顶级集群配置. 仓库设置 在等待 Manager.createServer 之前填充两个阵列 。 网格保留了它的后期 激活并返回零创建路径.

## 常见问题

### @cocreate/organizations 是什么？

一个简单的组织组成 在香草javascript。 使用 HTML5 属性和/或 JavaScript API 轻松配置\.

### 如何安装 @cocreate/organizations？

在项目目录运行 npm install @cocreate/organizations，或使用 pnpm add / yarn add / bun add。

### @cocreate/organizations 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cocreate\_\_organizations 是否存在。

### @cocreate/organizations 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @cocreate/organizations 可以商用吗？

@cocreate/organizations 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cocreate/organizations 的下载量有多少？

根据 npm 官方下载统计，@cocreate/organizations 在 2026/10/10 – 2026/11/08 这 30 天内被下载 2,718 次，日均约 91 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cocreate/organizations 还在维护吗？

最新版本 3\.0\.2 发布于 2026/11/07（3 天前）；至今共发布 285 个版本，其中过去 12 个月发布了 15 个；首次发布于 2021/03/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。