improve

Websoft9 · Jan 23, 2024 · 9eb0ff5 · 9eb0ff5
1 parent a3af449
commit 9eb0ff5
Show file tree

Hide file tree

Showing 81 changed files with 105 additions and 103 deletions.
diff --git a/docs/admin/_category_.yml b/docs/admin/_category_.yml
@@ -0,0 +1,2 @@
+label: "管理员"
+position: 5
diff --git a/...strator/maintenance/backup/_category_.yml → docs/admin/backup/_category_.yml b/...strator/maintenance/backup/_category_.yml → docs/admin/backup/_category_.yml
diff --git a/docs/administrator/maintenance/backup/app.md → docs/admin/backup/app.md b/docs/administrator/maintenance/backup/app.md → docs/admin/backup/app.md
diff --git a/...dministrator/maintenance/backup/readme.md → docs/admin/backup/readme.md b/...dministrator/maintenance/backup/readme.md → docs/admin/backup/readme.md
diff --git a/...dministrator/maintenance/backup/server.md → docs/admin/backup/server.md b/...dministrator/maintenance/backup/server.md → docs/admin/backup/server.md
diff --git a/.../administrator/maintenance/_category_.yml → docs/admin/maintenance/_category_.yml b/.../administrator/maintenance/_category_.yml → docs/admin/maintenance/_category_.yml
diff --git a/...ator/maintenance/migration/_category_.yml → docs/admin/migration/_category_.yml b/...ator/maintenance/migration/_category_.yml → docs/admin/migration/_category_.yml
diff --git a/...dministrator/maintenance/migration/app.md → docs/admin/migration/app.md b/...dministrator/maintenance/migration/app.md → docs/admin/migration/app.md
diff --git a/...administrator/maintenance/migration/db.md → docs/admin/migration/db.md b/...administrator/maintenance/migration/db.md → docs/admin/migration/db.md
diff --git a/...nistrator/maintenance/migration/readme.md → docs/admin/migration/readme.md b/...nistrator/maintenance/migration/readme.md → docs/admin/migration/readme.md
diff --git a/...nistrator/maintenance/migration/server.md → docs/admin/migration/server.md b/...nistrator/maintenance/migration/server.md → docs/admin/migration/server.md
diff --git a/docs/user/domain/_category_.yml → docs/admin/notify/_category_.yml b/docs/user/domain/_category_.yml → docs/admin/notify/_category_.yml
@@ -1,5 +1,5 @@
-position: 3
-label: "设置域名"
+position: 7
+label: "通知"
 collapsible: true
 collapsed: true
 className: "red"
diff --git a/docs/admin/notify/readme.md b/docs/admin/notify/readme.md
@@ -0,0 +1,16 @@
+---
+sidebar_position: 1
+slug: /notify
+---
+
+import DocCardList from '@theme/DocCardList';
+import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
+
+# 安全
+
+云端产生直接价值的是应用软件和数据，但安全事故可能会让一切化为乌有。所以，安全维护工作必不可少：   
+
+<DocCardList items={useCurrentSidebarCategory().items}/>
+
+
+
diff --git a/docs/administrator/configuration/smtp.md → docs/admin/notify/smtp.md b/docs/administrator/configuration/smtp.md → docs/admin/notify/smtp.md
@@ -3,7 +3,7 @@ sidebar_position: 6
 slug: /administrator/smtp
 ---
 
-# SMTP 发送邮件
+# SMTP
 
 应用中配置 SMTP 邮件发送功能是非常重要的设置，它可以用于密码找回和重要操作的通知。  
 

diff --git a/.../administrator/configuration/parameter.md → docs/admin/parameter.md b/.../administrator/configuration/parameter.md → docs/admin/parameter.md
@@ -3,7 +3,7 @@ sidebar_position: 10
 slug: /administrator/parameter
 ---
 
-# 路径、端口和服务
+# 技术参数
 
 Websoft9 将各个应用和组件的目录到一个约定的目录中，大大的简化了用户维护：  
 

diff --git a/docs/administrator/readme.mdx → docs/admin/readme.mdx b/docs/administrator/readme.mdx → docs/admin/readme.mdx
diff --git a/...rator/maintenance/security/_category_.yml → docs/admin/security/_category_.yml b/...rator/maintenance/security/_category_.yml → docs/admin/security/_category_.yml
diff --git a/...dministrator/maintenance/security/ddos.md → docs/admin/security/ddos.md b/...dministrator/maintenance/security/ddos.md → docs/admin/security/ddos.md
diff --git a/docs/administrator/configuration/firewall.md → docs/admin/security/firewall.md b/docs/administrator/configuration/firewall.md → docs/admin/security/firewall.md
diff --git a/...trator/maintenance/security/insertcode.md → docs/admin/security/insertcode.md b/...trator/maintenance/security/insertcode.md → docs/admin/security/insertcode.md
diff --git a/...inistrator/maintenance/security/readme.md → docs/admin/security/readme.md b/...inistrator/maintenance/security/readme.md → docs/admin/security/readme.md
diff --git a/...dministrator/maintenance/security/scan.md → docs/admin/security/scan.md b/...dministrator/maintenance/security/scan.md → docs/admin/security/scan.md
diff --git a/docs/admin/settings/_category_.yml b/docs/admin/settings/_category_.yml
@@ -0,0 +1,2 @@
+label: "管理设置"
+position: 1
diff --git a/...nistrator/configuration/db/_category_.yml → docs/admin/settings/db/_category_.yml b/...nistrator/configuration/db/_category_.yml → docs/admin/settings/db/_category_.yml
diff --git a/.../administrator/configuration/db/readme.md → docs/admin/settings/db/readme.md b/.../administrator/configuration/db/readme.md → docs/admin/settings/db/readme.md
diff --git a/...ator/configuration/storage/_category_.yml → docs/admin/storage/_category_.yml b/...ator/configuration/storage/_category_.yml → docs/admin/storage/_category_.yml
diff --git a/...strator/configuration/storage/external.md → docs/admin/storage/external.md b/...strator/configuration/storage/external.md → docs/admin/storage/external.md
diff --git a/...strator/configuration/storage/increase.md → docs/admin/storage/increase.md b/...strator/configuration/storage/increase.md → docs/admin/storage/increase.md
diff --git a/...inistrator/configuration/storage/mount.md → docs/admin/storage/mount.md b/...inistrator/configuration/storage/mount.md → docs/admin/storage/mount.md
diff --git a/...nistrator/configuration/storage/readme.md → docs/admin/storage/readme.md b/...nistrator/configuration/storage/readme.md → docs/admin/storage/readme.md
diff --git a/...nistrator/configuration/storage/volume.md → docs/admin/storage/volume.md b/...nistrator/configuration/storage/volume.md → docs/admin/storage/volume.md
diff --git a/...trator/maintenance/upgrade/_category_.yml → docs/admin/upgrade/_category_.yml b/...trator/maintenance/upgrade/_category_.yml → docs/admin/upgrade/_category_.yml
diff --git a/.../administrator/maintenance/upgrade/app.md → docs/admin/upgrade/app.md b/.../administrator/maintenance/upgrade/app.md → docs/admin/upgrade/app.md
diff --git a/docs/administrator/maintenance/upgrade/os.md → docs/admin/upgrade/os.md b/docs/administrator/maintenance/upgrade/os.md → docs/admin/upgrade/os.md
diff --git a/...ministrator/maintenance/upgrade/readme.md → docs/admin/upgrade/readme.md b/...ministrator/maintenance/upgrade/readme.md → docs/admin/upgrade/readme.md
diff --git a/docs/administrator/_category_.yml b/docs/administrator/_category_.yml
diff --git a/docs/administrator/architecture.md b/docs/administrator/architecture.md
diff --git a/docs/administrator/configuration/_category_.yml b/docs/administrator/configuration/_category_.yml
diff --git a/docs/administrator/configuration/proxy.md b/docs/administrator/configuration/proxy.md
diff --git a/docs/apps/reademe.tl b/docs/apps/reademe.tl
@@ -0,0 +1,9 @@
+# 应用
+
+## 一级分类
+
+- [产品名称](product_name)
+
+## 一级分类
+
+- [产品名称](product_name)
diff --git a/docs/developer/architecture.md b/docs/developer/architecture.md
@@ -1,8 +1,36 @@
 ---
 sidebar_position: 1
-slug: /developer/structure
+slug: /developer/architecture
 ---
 
-# 系统架构
+# 架构
 
-Websoft9 以 Docker 为基础，全面采用微服务架构。    
+Websoft9 是一个以应用为中心的微服务架构模式，它入门极简，扩充能力极强。  
+
+**"一切皆应用，一切可组装"** 是 Websoft9 的根本哲学思想，基于这个哲学思想，我们灵活的将优秀的开源软件融合到产品体系中。  
+
+我们的架构中遵循一些主要的技术思想：
+
+- 通过组装实现产品创新
+- [云原生 12 要素](https://12factor.net/zh_cn/)
+- 开源迭代，持续演化
+- 专注于连接，减少非必要的创作
+- 使用已经流行的技术要素，避免再创造新的技术规范
+- GitOps 云原生持续交付模型
+- Unix 哲学 KISS 原则： Keep It Simple, Stupid!
+
+我们采用的技术要素包括：Linux, Docker, K8s, API 网关，服务发现，应用网关，应用编排，Git等。  
+
+对应的产品架构图如下：  
+
+![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/websoft9/websoft9-architecture.png)
+
+
+- Apphub：应用管理服务，负责应用整个生命周期
+- Git：应用安装模板的仓库，实现先申明、再部署的模式
+- Deployment：负责与 Docker, K8s 交付的部署工作模块，同时提供可视化的管理容器的界面
+- App Gateway：发布和控制应用的访问
+
+采用 [Docker Compose](https://docs.docker.com/compose/) 作为应用程序的模板，同时开源由 Websoft9 维护的[模板库](https://github.com/Websoft9/docker-library)。
+
+也就是说，应用实际上最终运行在 Docker Compose 编排下，即使不使用 Websoft9 的控制台管理应用，也不会被任何技术体系绑架，做到绝对的收放自如、自主可控。  
diff --git a/docs/guide/_category_.yml b/docs/guide/_category_.yml
@@ -0,0 +1,2 @@
+label: "指南"
+position: 4
diff --git a/.../administrator/configuration/db/change.md → docs/guide/dbchange.md b/.../administrator/configuration/db/change.md → docs/guide/dbchange.md
@@ -1,9 +1,9 @@
 ---
-sidebar_position: 2
-slug: /administration/db_change
+sidebar_position: 3
+slug: /guide/dbchange
 ---
 
-# 更换为外部数据库
+# 更换应用的数据库
 
 Websoft9 每个应用都预装了默认数据库，并且这些数据库也按照应用的要求进行了必要的个性化设置，确保用户可以直接使用。虽然如此，每个用户可能面临使用习惯、企业 IT 规范要求等不同的因素，导致需要更换默认数据库为用户自己的特定数据库。  
 

diff --git a/docs/user/database.md → docs/guide/dbconnect.md b/docs/user/database.md → docs/guide/dbconnect.md
@@ -1,9 +1,9 @@
 ---
-sidebar_position: 10
-slug: /user/database
+sidebar_position: 2
+slug: /guide/dbconnect
 ---
 
-# 管理数据库
+# 连接应用的数据库
 
 虽然 Websoft9 在默认情况下，没有安装任何一个数据库管理工具。但是，我们在应用商店的【数据库】>【管理与迁移】类目提供了诸多热门的 Web 版的数据库管理工具。  
 

diff --git a/docs/guide/domain/_category_.yml b/docs/guide/domain/_category_.yml
@@ -0,0 +1,5 @@
+position: 1
+label: "为应用设置域名"
+collapsible: true
+collapsed: true
+className: "red"
diff --git a/docs/user/domain/change.md → docs/guide/domain/change.md b/docs/user/domain/change.md → docs/guide/domain/change.md
diff --git a/docs/user/domain/https.md → docs/guide/domain/https.md b/docs/user/domain/https.md → docs/guide/domain/https.md
diff --git a/docs/user/domain/readme.md → docs/guide/domain/readme.md b/docs/user/domain/readme.md → docs/guide/domain/readme.md
@@ -6,14 +6,16 @@ slug: /user/domain
 import DocCardList from '@theme/DocCardList';
 import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
 
-# 域名
+# 为应用设置域名
 
-Websoft9 简化了域名和证书配置，让这些工作不再涉及配置文件，大大减轻了用户的负担。
+为应用设置域名（包含HTTPS证书）的前提首先需要：[准备域名](../reference/domain)，确保域名可用。  
 
-## 域名准备
+然后，再根据需求完成对应的设置：
 
 ## 配置域名
 
+Websoft9 简化了域名和证书配置，让这些工作不再涉及配置文件，大大减轻了用户的负担。
+
 ### 全局域名{#global-domain}
 
 ### 单设域名{#single-domain}

diff --git a/...dministrator/configuration/integration.md → docs/guide/integration.md b/...dministrator/configuration/integration.md → docs/guide/integration.md
@@ -3,7 +3,7 @@ sidebar_position: 7
 slug: /administrator/integration
 ---
 
-# 应用之间集成
+# 应用集成
 
 现代 IT 架构中，孤立的应用系统已经成为阻碍组织运行效率的制约，它导致企业无法充分共享业务数据实现流程协作。   
 

diff --git a/docs/user/readme.mdx → docs/guide/readme.mdx b/docs/user/readme.mdx → docs/guide/readme.mdx
diff --git a/docs/guide/solution/_category_.json b/docs/guide/solution/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "使用场景",
+  "position": 7
+}
diff --git a/docs/solution/tech/automation.mdx → docs/guide/solution/automation.mdx b/docs/solution/tech/automation.mdx → docs/guide/solution/automation.mdx
diff --git a/docs/solution/tech/b2bCMS.md → docs/guide/solution/b2bCMS.md b/docs/solution/tech/b2bCMS.md → docs/guide/solution/b2bCMS.md
diff --git a/docs/solution/tech/dbHa.md → docs/guide/solution/dbHa.md b/docs/solution/tech/dbHa.md → docs/guide/solution/dbHa.md
diff --git a/docs/solution/tech/docs.md → docs/guide/solution/docs.md b/docs/solution/tech/docs.md → docs/guide/solution/docs.md
diff --git a/docs/solution/industry/education.md → docs/guide/solution/education.md b/docs/solution/industry/education.md → docs/guide/solution/education.md
diff --git a/docs/solution/industry/government.md → docs/guide/solution/government.md b/docs/solution/industry/government.md → docs/guide/solution/government.md
diff --git a/docs/solution/industry/manufacture.md → docs/guide/solution/manufacture.md b/docs/solution/industry/manufacture.md → docs/guide/solution/manufacture.md
diff --git a/docs/solution/readme.md → docs/guide/solution/readme.md b/docs/solution/readme.md → docs/guide/solution/readme.md
diff --git a/docs/solution/tech/searchEngine.md → docs/guide/solution/searchEngine.md b/docs/solution/tech/searchEngine.md → docs/guide/solution/searchEngine.md
diff --git a/docs/user/credentials.md → docs/quick/credentials.md b/docs/user/credentials.md → docs/quick/credentials.md
diff --git a/docs/user/installapp.md → docs/quick/installapp.md b/docs/user/installapp.md → docs/quick/installapp.md
diff --git a/docs/user/manageapp.md → docs/quick/manageapp.md b/docs/user/manageapp.md → docs/quick/manageapp.md
diff --git a/docs/readme.md b/docs/readme.md
@@ -11,17 +11,14 @@ slug: /
 
 ## 什么是 Websoft9?
 
-Websoft9 是一个创新的云原生应用商店。通过它的 Web 控制台，可以一键部署数据、AI、网站等数百个热门的开源云应用署。  
+Websoft9（微聚云） 是一个创新的云原生应用商店。通过它的 Web 控制台，用户可以一键部署数据、AI、网站、企业运营、设计创作、低代码、数据库等数百个热门的开源云应用署。  
 
 对于创新型组织来说，Websoft9 消除了任何技术障碍。帮助擅长使用软件工具的工作者或企业，在几分钟的时间内便可以进入企业数字化和 AI 的大门。它让用户专注于工具的使用，极大提升工作效率和职业竞争力。 
 
 从技术上讲， Websoft9 是一个微服务架构的 PaaS 平台，它管理软件的生命周期：寻找、部署、维护、升级和监控。它支持 Docker, K8s 等原生架构，以 Nginx 作为应用网关，为应用提供了自动化的配置域名、HTTPS 证书生成。
 
 ![](https://libs.websoft9.com/Websoft9/DocsPicture/zh/websoft9/websoft9-dashboard.png)
 
-
-
-
 Websoft9 将云原生软件的应用时间由 1-2 天缩短到 2 分钟，安装云原生应用不再是专业 IT 人员的专属技能。  
 
 毫无疑问，Websoft9 是一个值得尝试的企业生产力工具，它帮助一切高能的知识工作者，去提升生产力，其降本增效价值完全可见。
@@ -67,10 +64,21 @@ Websoft9 是一个以应用为中心的，它支持各种全面的应用的自
 * [如何配置 HTTPS？](./administrator/domain_https)
 * [联系人工支持](./helpdesk)
 
-## 迁移至 Websoft9
+## Websoft9 价值
+
+云原生的是一个充满创造力的世界，Websoft9 的核心价值观就是要将云原生的技术和产品进行整合，以便利性的方式将这些产品和服务普惠全球，让创新型组织专注于使用这些技术。
+
+企业在数字化推进中，传统的做法是**寻找一个单一的软件，再找一个贴身定制的服务商**，期望通过昂贵的 License + 复杂的项目组织实现一个目标，它看似投入了巨大的人力无力，但由于跨度时间周期太长，无法持续迭代，导致结果却往往事与愿违。   
+
+云原生时代，小步快跑，轻盈灵活是创新组织的生存形态，它具备如下特点：
+
+- 组织架构：小而美
+- 组织演化：持续迭代
+- 组织创新：生产力工具组合
+- 组织文件：开放协同
 
-企业在数字化推进中，要抛弃传统的做法：昂贵的 License + 复杂的项目组织，它看似投入了巨大的人力无力，结果却往往事与愿违。   
+而开源技术和小型软件具有**百家争鸣**的特征，这个生态中各种有特点的工具层出不穷，它非常符合创新型组织的特点。  
 
-云原生时代，小步快跑，轻盈灵活是创新组织的生存形态，而开源技术和小型软件的使用至关重要，Websoft9 可以帮助您物尽其用。   
+只要学会将这些工具进行有效的组合，那它将产生不可估量的效率提升。而 Websoft9 通过共享的原云生技术，可以帮助您物尽其用。   
 
 如果您的 IT 团队无法进行有效的支持与建议，[订阅](./buy/subscription) Websoft9 的服务，享受商业级支持给您带来的效率提升和保障吧。  
diff --git a/docs/administrator/cmd.md → docs/reference/cmd.md b/docs/administrator/cmd.md → docs/reference/cmd.md
diff --git a/docs/user/glossary.md → docs/reference/glossary.md b/docs/user/glossary.md → docs/reference/glossary.md
diff --git a/docs/user/domain/steps.md → docs/reference/steps.md b/docs/user/domain/steps.md → docs/reference/steps.md
@@ -1,9 +1,9 @@
 ---
 sidebar_position: 1
-slug: /user/domain_step
+slug: /reference/domain
 ---
 
-# 域名五步设置
+# 准备域名
 
 ## 设置步骤
 

diff --git a/docs/administrator/tools.md → docs/reference/tools.md b/docs/administrator/tools.md → docs/reference/tools.md
diff --git a/docs/solution/_category_.json b/docs/solution/_category_.json
diff --git a/docs/solution/industry/_category_.json b/docs/solution/industry/_category_.json
diff --git a/docs/solution/tech/_category_.json b/docs/solution/tech/_category_.json
diff --git a/...administrator/troubleshoot/_category_.yml → docs/troubleshoot/_category_.yml b/...administrator/troubleshoot/_category_.yml → docs/troubleshoot/_category_.yml
@@ -1,5 +1,5 @@
 position: 16
-label: "故障问题"
+label: "故障与问题"
 collapsible: true
 collapsed: true
 className: "red"
diff --git a/docs/administrator/troubleshoot/deduction.md → docs/troubleshoot/deduction.md b/docs/administrator/troubleshoot/deduction.md → docs/troubleshoot/deduction.md
diff --git a/docs/administrator/troubleshoot/faq.md → docs/troubleshoot/faq.md b/docs/administrator/troubleshoot/faq.md → docs/troubleshoot/faq.md
diff --git a/docs/administrator/troubleshoot/fivewhy.md → docs/troubleshoot/fivewhy.md b/docs/administrator/troubleshoot/fivewhy.md → docs/troubleshoot/fivewhy.md
diff --git a/docs/administrator/troubleshoot/logs.md → docs/troubleshoot/logs.md b/docs/administrator/troubleshoot/logs.md → docs/troubleshoot/logs.md
diff --git a/docs/administrator/troubleshoot/method.md → docs/troubleshoot/method.md b/docs/administrator/troubleshoot/method.md → docs/troubleshoot/method.md
diff --git a/docs/administrator/troubleshoot/readme.mdx → docs/troubleshoot/readme.mdx b/docs/administrator/troubleshoot/readme.mdx → docs/troubleshoot/readme.mdx
diff --git a/docs/administrator/troubleshoot/softpower.md → docs/troubleshoot/softpower.md b/docs/administrator/troubleshoot/softpower.md → docs/troubleshoot/softpower.md
diff --git a/docs/user/_category_.yml b/docs/user/_category_.yml
diff --git a/sidebars.js b/sidebars.js
@@ -18,12 +18,6 @@ const sidebars = {
     {
         type: 'autogenerated',
         dirName: '.'
-    },
-
-    {
-        type: 'link',
-        label: '联系我们', // 链接标签
-        href: '/docs/helpdesk#contact', // 内部路径
     }
 
     ]
-Original file line number
+Diff line change
@@ Expand Up / @@ -3,7 +3,7 @@ sidebar_position: 6 @@
     slug: /administrator/smtp
     ---
-    # SMTP 发送邮件
+    # SMTP
     应用中配置 SMTP 邮件发送功能是非常重要的设置，它可以用于密码找回和重要操作的通知。
@@ Expand Down @@