coscene-io
diff --git a/‎docs/developers/concepts/2-auth-models.md‎
Lines changed: 6 additions & 1 deletion b/‎docs/developers/concepts/2-auth-models.md‎
Lines changed: 6 additions & 1 deletion
diff --git a/‎docs/developers/concepts/img/auth.png‎
718 KB b/‎docs/developers/concepts/img/auth.png‎
718 KB
diff --git a/‎docs/developers/s3/1-s3-authentication.md‎
Lines changed: 27 additions & 0 deletions b/‎docs/developers/s3/1-s3-authentication.md‎
Lines changed: 27 additions & 0 deletions
diff --git a/‎docs/developers/s3/2-s3-operations.md‎
Lines changed: 70 additions & 0 deletions b/‎docs/developers/s3/2-s3-operations.md‎
Lines changed: 70 additions & 0 deletions
diff --git a/‎docs/developers/s3/_category_.json‎
Lines changed: 9 additions & 0 deletions b/‎docs/developers/s3/_category_.json‎
Lines changed: 9 additions & 0 deletions
diff --git a/‎docs/developers/s3/img/pro-s3_1.png‎
91.3 KB b/‎docs/developers/s3/img/pro-s3_1.png‎
91.3 KB
diff --git a/‎docs/developers/s3/img/pro-s3_2.png‎
91 KB b/‎docs/developers/s3/img/pro-s3_2.png‎
91 KB
diff --git a/‎docs/developers/s3/img/pro-s3_3.png‎
82.1 KB b/‎docs/developers/s3/img/pro-s3_3.png‎
82.1 KB
diff --git a/‎docs/developers/s3/img/s3-record.png‎
125 KB b/‎docs/developers/s3/img/s3-record.png‎
125 KB
diff --git a/‎docs/developers/s3/img/s3-resource.png‎
53.6 KB b/‎docs/developers/s3/img/s3-resource.png‎
53.6 KB
@@ -23,11 +23,16 @@ coScene 根据上述的权限体系和原则，在系统内为所有的资源预
 1. 组织管理员：可以管理组织内的所有资源和权限
 2. 成员：可以管理所有组织内成员有权限的数据
 3. 只读成员：可以读取所有组织内成员有权限的数据
+4. 外部人员：不是组织内的实际用户，可以通过邀请加入组织，访问被添加的项目
 
 ### 项目
 
 1. 项目管理员：可以管理项目内所有资源和权限
 2. 成员：可以管理项目内所有的数据
 3. 只读成员：可以读取项目内所有的数据
 
-当一个用户拥有项目的角色时，该用户项目内的角色会被优先使用。唯一的例外是组织管理员，组织管理员目前拥有最高的系统权限，能访问所有的项目，并且会忽略项目内的角色设置（如果有）。
+当一个用户拥有项目的角色时，该用户项目内的角色会被优先使用。唯一的例外是组织管理员，组织管理员目前拥有最高的系统权限，能访问所有的项目。
+
+各角色的操作权限如下：
+
+![auth.png](./img/auth.png)
@@ -0,0 +1,27 @@
+---
+sidebar_position: 1
+---
+
+# S3 身份验证
+
+了解如何使用 S3 进行身份验证，从而对组织内有权限的项目执行 S3 操作。
+
+1. 进入项目概览-S3 连接页面，获取 Endpoint、Region、Bucket 等信息。
+
+    ![pro-s3_1](./img/pro-s3_1.png)
+
+2. 点击【我的访问秘钥】，前往个人设置-安全页面，管理个人的 S3 访问秘钥。
+
+    ![pro-s3_2](./img/pro-s3_2.png)
+
+3. 点击【创建访问秘钥】，输入备注信息后，创建 S3 访问秘钥。
+
+    ![pro-s3_3](./img/pro-s3_3.png)
+
+4. 复制访问秘钥 ID 和访问秘钥，用于后续 S3 操作。例如，使用 [AIStor Client(mc)](https://docs.min.io/enterprise/aistor-object-store/reference/cli/) 工具进行 S3 身份验证：
+
+    ```bash
+    mc alias set coscene <endpoint> <access-key-id> <secret-access-key>
+    ```
+
+注意：**个人的 S3 访问秘钥可对组织内有权限的所有项目执行操作，仅用于个人使用，不建议分享给他人。**
@@ -0,0 +1,70 @@
+---
+sidebar_position: 2
+---
+
+# S3 操作
+
+在项目中，通过 S3 可对记录、资源进行上传、下载等操作。
+
+## 存储路径
+
+1. **记录**
+
+    记录中的文件在 S3 对应 Bucket 中的路径为 `records/<record-id>/files/<file-name>`。
+
+    例如，记录的 ID 为 `123456`，文件名为 `example.txt`，则文件的路径为 `records/123456/files/example.txt`。
+
+    ![s3-record](./img/s3-record.png)
+
+2. **资源**
+
+    资源中的文件在 S3 对应 Bucket 中的路径为 `files/<file-name>`。
+
+    例如，资源中文件名为 `example.txt`，则文件的路径为 `files/example.txt`。
+
+    ![s3-resource](./img/s3-resource.png)
+
+## 操作示例
+以 [AIStor Client(mc)](https://docs.min.io/enterprise/aistor-object-store/reference/cli/) 工具为例。假设项目 Bucket 为 `coscene.01`，记录的 ID 为 `123456`，文件名为 `example.txt`，S3 配置的别名为 `coscene`。
+
+### 列出文件
+
+1. 列出记录中的文件
+
+    ```bash
+    mc ls coscene/coscene.01/records/123456/files/
+    ```
+
+2. 列出资源中的文件
+
+    ```bash
+    mc ls coscene/coscene.01/files/
+    ```
+
+### 上传文件
+
+1. 上传文件到记录中：
+
+    ```bash
+    mc put example.txt coscene/coscene.01/records/123456/files/
+    ```
+
+2. 上传文件到资源中：
+
+    ```bash
+    mc put example.txt coscene/coscene.01/files/
+    ```
+
+### 下载文件
+
+1. 从记录中下载文件
+
+    ```bash
+    mc get coscene/coscene.01/records/123456/files/example.txt .
+    ```
+
+2. 从资源中下载文件
+
+    ```bash
+    mc get coscene/coscene.01/files/example.txt .
+    ```
@@ -0,0 +1,9 @@
+{
+  "label": "S3 存储",
+  "position": 4,
+  "collapsible": true,
+  "link": {
+    "type": "generated-index",
+    "slug": "/category/s3"
+  }
+}