update docs

Author: wu-clan

docs/.vuepress/components/PluginMarket.vue

@@ -15,7 +15,7 @@
             class="image-content"
         />
         <div v-else class="image-placeholder">
-          <Icon :name="item.icon" size="3em" color="var(--vp-c-brand)" />
+          <Icon :name="item.icon" size="3em" color="var(--vp-c-text-1)" />
         </div>
         <div v-if="item.priceLabel" class="price-corner-tag" :class="{ 'paid': item.priceLabel === '付费' }">
           <span class="price-corner-text">{{ item.priceLabel }}</span>
@@ -49,21 +49,19 @@
         <h3 class="card-title">{{ item.title }}</h3>
         <p class="card-description">{{ item.description }}</p>
         <div class="card-tags">
-          <span
+          <Badge
               v-for="(tag, tagIndex) in item.tags"
               :key="tagIndex"
-              class="badge"
-              :style="getTagColors(tag)"
-          >{{ tag }}</span>
+              :text="tag"
+              :style="colors[tag]"
+          />
         </div>
       </div>
     </div>
   </div>
 </template>
 
 <script setup lang="ts">
-import type { CSSProperties } from 'vue';
-
 export interface PluginItem {
   icon: string
   title: string
@@ -85,28 +83,16 @@ const props = withDefaults(
     }
 )
 
-interface TagColors extends CSSProperties {
-}
-
-const getTagColors = (tag: string): TagColors => {
-  const colors: Record<string, TagColors> = {
-    'MySQL': { color: '#006484', backgroundColor: 'rgba(0, 100, 132, 0.1)', borderColor: 'rgba(0, 100, 132, 0.2)' },
-    'PostgreSQL': {
-      color: '#336699',
-      backgroundColor: 'rgba(51, 102, 153, 0.1)',
-      borderColor: 'rgba(51, 102, 153, 0.2)'
-    },
-    'fba': { color: '#8b5cf6', backgroundColor: 'rgba(139, 92, 246, 0.1)', borderColor: 'rgba(139, 92, 246, 0.2)' },
-    'fba_ui': { color: '#a855f7', backgroundColor: 'rgba(168, 85, 247, 0.1)', borderColor: 'rgba(168, 85, 247, 0.2)' },
-    'app': { color: '#f97316', backgroundColor: 'rgba(249, 115, 22, 0.1)', borderColor: 'rgba(249, 115, 22, 0.2)' },
-    'extra': { color: '#64748b', backgroundColor: 'rgba(100, 116, 139, 0.1)', borderColor: 'rgba(100, 116, 139, 0.2)' },
-  };
-  return colors[tag] || {
-    color: 'var(--vp-c-text-2)',
-    backgroundColor: 'var(--vp-c-bg-soft)',
-    borderColor: 'var(--vp-c-divider)'
-  };
-}
+const colors: Record<string, TagColors> = {
+  'MySQL': { color: '#006484', backgroundColor: 'rgba(0, 100, 132, 0.1)', borderColor: 'rgba(0, 100, 132, 0.2)' },
+  'PostgreSQL': {
+    color: '#336699',
+    backgroundColor: 'rgba(51, 102, 153, 0.1)',
+    borderColor: 'rgba(51, 102, 153, 0.2)'
+  },
+  '后端': { color: '#009485', backgroundColor: 'rgba(0,148,133,0.1)', borderColor: 'rgba(0,148,133,0.2)' },
+  '前端': { color: '#a855f7', backgroundColor: 'rgba(168, 85, 247, 0.1)', borderColor: 'rgba(168, 85, 247, 0.2)' },
+};
 
 const getGithubAvatarUrl = (username: string) => {
   return `https://github.com/${ username }.png?size=32`;
@@ -269,24 +255,10 @@ const handleCardClick = (item: PluginItem) => {
   margin-bottom: 0.5rem;
 }
 
-.badge {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  padding: 0.1rem 0.5rem;
-  border-radius: 4px;
-  font-size: 0.7rem;
-  line-height: 1;
-  font-weight: 500;
-  white-space: nowrap;
-  border: 1px solid transparent;
-}
-
 .price-corner-tag {
   position: absolute;
   top: 0;
   right: 0;
-  background: #17bf63;
   color: #fff;
   padding: 0.3rem 0.6rem;
   font-size: 0.75rem;

docs/.vuepress/config.ts

@@ -56,6 +56,7 @@ export default defineUserConfig({
         contributors: false,
         lastUpdated: false,
         footer: {
+            message: 'FastAPI 最佳架构 & MIT LICENCE',
             copyright: 'Copyright © 2023-present FastAPI Practices'
         },
         //watermark: true,

docs/.vuepress/data/plugin.ts

@@ -5,39 +5,39 @@ export const pluginItems: PluginItem[] = [
         icon: "fa6-regular:file-code",
         title: "代码生成",
         description: "生成通用业务代码（仅后端工程）",
-        tags: ["MySQL", "PostgreSQL", "fba", "app"],
+        tags: ["MySQL", "PostgreSQL", "后端"],
         githubUser: 'wu-clan',
         priceLabel: "免费"
     },
     {
         icon: "fe:notice-active",
         title: "通知公告",
         description: "发布系统内部通知、公告",
-        tags: ["MySQL", "PostgreSQL", "fba", "extra"],
+        tags: ["MySQL", "PostgreSQL", "后端"],
         githubUser: 'wu-clan',
         priceLabel: "免费"
     },
     {
         icon: "fluent-mdl2:dictionary",
         title: "数据字典",
         description: "通常用于约束前端工程数据展示",
-        tags: ["MySQL", "PostgreSQL", "fba", "extra"],
+        tags: ["MySQL", "PostgreSQL", "后端"],
         githubUser: 'wu-clan',
         priceLabel: "免费"
     },
     {
         icon: "icon-park-outline:config",
         title: "参数配置",
         description: "通常用于前端工程数据展示",
-        tags: ["MySQL", "PostgreSQL", "fba", "extra"],
+        tags: ["MySQL", "PostgreSQL", "后端"],
         githubUser: 'wu-clan',
         priceLabel: "免费"
     },
     {
         icon: "charm:shield-keyhole",
         title: "Casbin-RBAC",
         description: "基于 Casbin 实现的 RBAC 权限",
-        tags: ["MySQL", "PostgreSQL", "fba", "extra"],
+        tags: ["MySQL", "PostgreSQL", "后端"],
         link: "https://github.com/fastapi-practices/fba_casbin",
         image: "https://avatars.githubusercontent.com/u/27810343?s=200&v=4",
         githubUser: 'wu-clan',
@@ -47,7 +47,7 @@ export const pluginItems: PluginItem[] = [
         icon: "streamline:ai-prompt-spark",
         title: "MCP ChatGPT",
         description: "带有 MCP 服务器调用的 AI 对话",
-        tags: ["MySQL", "PostgreSQL", "fba", "extra"],
+        tags: ["MySQL", "PostgreSQL", "后端"],
         link: "https://github.com/fastapi-practices/fba_mcp",
         image: "https://github.com/modelcontextprotocol/.github/raw/main/profile/assets/light.png",
         githubUser: 'wu-clan',
@@ -57,7 +57,7 @@ export const pluginItems: PluginItem[] = [
         icon: "ant-design:aliyun-outlined",
         title: "阿里云 oss",
         description: "阿里云 oss 文件上传",
-        tags: ["MySQL", "PostgreSQL", "fba", "extra"],
+        tags: ["MySQL", "PostgreSQL", "后端"],
         link: "https://github.com/fastapi-practices/fba_aliyun_oss",
         image: "https://img.alicdn.com/tfs/TB1Ly5oS3HqK1RjSZFPXXcwapXa-238-54.png",
         githubUser: 'wu-clan',
@@ -67,7 +67,7 @@ export const pluginItems: PluginItem[] = [
         icon: "material-symbols:token-outline",
         title: "配置下发",
         description: "将 env 等配置信息通过数据库进行管理",
-        tags: ["MySQL", "fba", "extra"],
+        tags: ["MySQL", "后端"],
         link: "https://github.com/dividduang/option",
         githubUser: 'dividduang',
         priceLabel: "免费"
@@ -76,7 +76,7 @@ export const pluginItems: PluginItem[] = [
         icon: "ant-design:wechat-work-outlined",
         title: "企微 bot 定时任务",
         description: "定时调用企业微信群聊机器人发送消息",
-        tags: ["MySQL", "fba", "extra"],
+        tags: ["MySQL", "后端"],
         link: "https://github.com/dividduang/wecom-task",
         image: "https://rescdn.qqmail.com/node/wework/images/Slice.d2258f37eb.png",
         githubUser: 'dividduang',
@@ -86,7 +86,7 @@ export const pluginItems: PluginItem[] = [
         icon: "ant-design:wechat-work-outlined",
         title: "SSO",
         description: "通过 Casdoor 实现 SSO 单点登录集成",
-        tags: ["MySQL", "PostgreSQL", "fba", "extra"],
+        tags: ["MySQL", "PostgreSQL", "后端"],
         link: "/fastapi_best_architecture_docs/planet.html",
         image: "https://casdoor.org/zh/img/casdoor.png",
         githubUser: 'wu-clan',

docs/.vuepress/navbar.ts

@@ -106,7 +106,7 @@ export const myNavbar = defineNavbarConfig([
     {
         text: '插件系统',
         icon: 'unjs:unplugin',
-        badge: { text: 'New' },
+        badge: { text: 'NEW' },
         link: '/plugin/before'
     },
     {
@@ -122,7 +122,7 @@ export const myNavbar = defineNavbarConfig([
     {
         text: '互动',
         icon: 'game-icons:talk',
-        badge: { text: 'Hot', type: 'danger' },
+        badge: { text: 'HOT', type: 'danger' },
         link: '/group'
     },
     {

docs/.vuepress/sidebar.ts

@@ -88,7 +88,7 @@ export const mySidebar: ThemeSidebarMulti = {
             text: '市场',
             collapsed: false,
             items: [
-                { text: '插件市场', badge: { text: 'New' }, link: 'market' },
+                { text: '插件市场', badge: { text: 'NEW' }, link: 'market' },
             ]
         }
     ],

docs/README.md

@@ -10,7 +10,7 @@ config:
       actions:
         - theme: brand
           text: 快速开始 ->
-          link: /backend/summary/quick-start
+          link: /backend/summary/intro
         - theme: alt
           text: 伪三层架构?
           link: /backend/summary/intro#伪三层架构

docs/backend/summary/intro.md

@@ -103,9 +103,11 @@ mvc 架构作为常规设计模式，在 python web 中很常见，但是三层
 
 [![Stargazers over time](https://starchart.cc/fastapi-practices/fastapi_best_architecture.svg?variant=adaptive)](https://starchart.cc/fastapi-practices/fastapi_best_architecture)
 
-## 相关
-
-> [!IMPORTANT]
-> 特此感谢 [无名](https://github.com/lvright) 为此架构无偿设计的 LOGO
->
-> LOGO 寓意：包含了 FBA 三个字母抽象结合，形成了一个类似从地面扩散投影上来的闪电
+## 特别鸣谢
+
+- [downdawn](https://github.com/downdawn) 为此项目的创建提供大力支持
+- [无名](https://github.com/lvright) 精心设计的 LOGO（包含了 FBA 三个字母抽象结合，形成了一个类似从地面扩散投影上来的闪电）
+- [vuepress-theme-plume](https://github.com/pengzhanbo/vuepress-theme-plume) 为官网文档提供驱动支持
+- FastAPI、SQLAlchemy、Pydantic 等开源先行者
+- 此项目的所有贡献者、参与者和使用者
+- 赞助商们（包含所有渠道）的现金流支持

docs/plugin/market.md

@@ -6,22 +6,13 @@ watermark: true
 
 ::: info 标签说明
 
-<Badge text="MySQL" color="#006484" bg-color="rgba(0, 100, 132, 0.1)" border-color="rgba(0, 100, 132, 0.2)" /> [+MySQL] | 
-<Badge text="PostgreSQL" color="#336699" bg-color="rgba(51, 102, 153, 0.1)" border-color="rgba(51, 102, 153, 0.2)" /> [+PostgreSQL] | 
-<Badge text="fba" color="#8b5cf6" bg-color="rgba(139, 92, 246, 0.1)" border-color="rgba(139, 92, 246, 0.2)" /> [+fba] | 
-<Badge text="fba_ui" color="#a855f7" bg-color="rgba(168, 85, 247, 0.1)" border-color="rgba(168, 85, 247, 0.2)" /> [+fba_ui] | 
-<Badge text="app" color="#f97316" bg-color="rgba(249, 115, 22, 0.1)" border-color="rgba(249, 115, 22, 0.2)" /> [+app] | 
-<Badge text="extra" color="#64748b" bg-color="rgba(100, 116, 139, 0.1)" border-color="rgba(100, 116, 139, 0.2)" /> [+extra]
+- <Badge text="MySQL" color="#006484" bg-color="rgba(0, 100, 132, 0.1)" border-color="rgba(0, 100, 132, 0.2)" /> - 支持 MySQL
+- <Badge text="PostgreSQL" color="#336699" bg-color="rgba(51, 102, 153, 0.1)" border-color="rgba(51, 102, 153, 0.2)" /> - 支持 PostgreSQL
+- <Badge text="后端" color="#009485" bg-color="rgba(0,148,133,0.1)" border-color="rgba(0,148,133,0.2)" /> - 后端代码插件
+- <Badge text="前端" color="#a855f7" bg-color="rgba(168, 85, 247, 0.1)" border-color="rgba(168, 85, 247, 0.2)" /> - 前端 [Vben Admin Antd](https://github.com/fastapi-practices/fastapi_best_architecture_ui) 代码插件
 
 :::
 
-[+MySQL]: 支持 MySQL
-[+PostgreSQL]: 支持 PostgreSQL
-[+fba]: 仅后端代码插件
-[+fba_ui]: 包含前端 [Vben Admin Antd](https://github.com/fastapi-practices/fastapi_best_architecture_ui) 代码插件
-[+app]: 应用级插件
-[+extra]: 扩展级插件
-
 <script setup lang="ts">
 import { pluginItems } from '@source/.vuepress/data/plugin'
 </script>

docs/plugin/publish.md

@@ -8,7 +8,7 @@ title: 发布
 社区的 [插件系统](https://discord.com/channels/1185035164577972344/1349951379560599572) 频道与我们分享
 
 > [!IMPORTANT]
-> 发布插件需满足以下要求：
+> 发布插件必须满足以下要求：
 >
 > - 提供插件 GitHub 仓库地址
 > - 在插件仓库内提供至少一种您的（任意）联系方式用于技术支持