update docs

Author: wu-clan

docs/.vuepress/navbar.ts

@@ -1,16 +1,11 @@
 import { defineNavbarConfig } from "vuepress-theme-plume";
 
 export const myNavbar = defineNavbarConfig([
-    {
-        text: '后端',
-        link: '/backend/summary/quick-start.md'
-    },
     {
         text: '前端',
         items: [
             {
                 text: '线上演示',
-                icon: 'mdi:web',
                 items: [
                     {
                         text: 'Arco Design Pro 实验性实施',
@@ -20,7 +15,6 @@ export const myNavbar = defineNavbarConfig([
             },
             {
                 text: '文档',
-                icon: 'material-symbols:docs',
                 items: [
                     {
                         text: 'Arco Design Pro 实验性实施',
@@ -34,7 +28,6 @@ export const myNavbar = defineNavbarConfig([
             },
             {
                 text: 'GitHub',
-                icon: 'mdi:git',
                 items: [
                     {
                         text: 'Arco Design Pro 实验性实施',
@@ -52,29 +45,59 @@ export const myNavbar = defineNavbarConfig([
         text: 'v1.0.5',
         items: [
             {
-                text: '常见问题',
-                icon: 'healthicons:question',
-                link: '/questions.md'
-            },
-            {
-                text: '技术支持',
-                icon: 'fluent-emoji-high-contrast:unicorn',
-                link: 'https://github.com/fastapi-practices/fastapi_best_architecture/issues'
-            },
-            {
-                text: '参与贡献',
-                icon: 'mdi:people-add',
-                link: 'https://github.com/fastapi-practices/fastapi_best_architecture/tree/master/backend#readme'
+                text: '线上演示',
+                items: [
+                    {
+                        text: '服务状态',
+                        icon: 'simple-icons:uptimekuma',
+                        link: 'https://status.wu-clan.site/status/services'
+                    }
+                ]
             },
             {
-                text: '更新记录',
-                icon: 'stash:last-updates-duotone',
-                link: '/changelog.md'
+                text: '文档',
+                items: [
+                    {
+                        text: '快速开始',
+                        icon: 'material-symbols:start',
+                        link: '/backend/summary/quick-start.md'
+                    },
+                    {
+                        text: 'Apifox',
+                        icon: 'simple-icons:apifox',
+                        link: 'https://apifox.com/apidoc/shared-28a93f02-730b-4f33-bb5e-4dad92058cc0'
+                    },
+                ]
             },
             {
-                text: '我要催更',
-                icon: 'material-symbols:update-rounded',
-                link: 'https://discord.gg/JyedBeHXkn'
+                text: '更多',
+                items: [
+                    {
+                        text: '常见问题',
+                        icon: 'healthicons:question',
+                        link: '/questions.md'
+                    },
+                    {
+                        text: '技术支持',
+                        icon: 'fluent-emoji-high-contrast:unicorn',
+                        link: 'https://github.com/fastapi-practices/fastapi_best_architecture/issues'
+                    },
+                    {
+                        text: '参与贡献',
+                        icon: 'mdi:people-add',
+                        link: 'https://github.com/fastapi-practices/fastapi_best_architecture/tree/master/backend#readme'
+                    },
+                    {
+                        text: '我要催更',
+                        icon: 'material-symbols:update-rounded',
+                        link: 'https://discord.gg/JyedBeHXkn'
+                    },
+                    {
+                        text: '更新记录',
+                        icon: 'stash:last-updates-duotone',
+                        link: '/changelog.md'
+                    },
+                ]
             },
         ]
     },
@@ -122,11 +145,6 @@ export const myNavbar = defineNavbarConfig([
                 icon: 'ph:planet-fill',
                 link: '/planet'
             },
-            {
-                text: '服务状态',
-                icon: 'simple-icons:uptimekuma',
-                link: 'https://status.wu-clan.site/status/services'
-            },
         ],
     }
 ])

docs/.vuepress/public/images/cursor.png

@@ -71,7 +71,7 @@ export const mySidebar: ThemeSidebarMulti = {
                 { text: '插件开发', link: 'dev' },
                 { text: '插件发布', link: 'publish' },
                 { text: '安装使用', link: 'install' },
-                { text: '插件市场', link: 'market' },
+                { text: '插件市场', icon: 'mdi:marketplace', link: 'market' },
             ]
         }
     ],

docs/.vuepress/sidebar.ts

@@ -7,6 +7,12 @@
     --vp-c-brand-2: rgba(0, 148, 133, 1);
     /* 背景色、边框色 */
     --vp-c-brand-3: rgba(0, 148, 133, 1);
+    /* 导航栏分组 */
+    .vp-menu-group {
+        .title {
+            color: rgba(60, 60, 60, .33);
+        }
+    }
 }
 
 [data-theme="dark"] {
@@ -16,8 +22,16 @@
     --vp-c-brand-2: rgba(0, 148, 133, 1);
     /* 背景色、边框色 */
     --vp-c-brand-3: rgba(0, 148, 133, 1);
+    /* 导航栏分组 */
+    .vp-menu-group {
+        .title {
+            color: rgba(235, 235, 235, .38);
+        }
+    }
 }
 
+
+
 .vp-swiper .swiper-slide-img {
     /* 轮播图图片拉伸效果 */
     object-fit: fill;
@@ -26,5 +40,4 @@
 .swiper-slide-custom-container {
     /* 轮播图边框 */
     border: 1px solid rgb(177 177 177 / 66%) !important;
-    color: #ed00b2;
 }

docs/.vuepress/styles/custom.css

@@ -4,22 +4,26 @@ title: cursor
 
 官网地址：[cursor](https://www.cursor.com/)
 
-我们在 cursor 中为 fba 定做了一些规则，或许可以帮助您更好的使用 AI 生成代码
+## 规则
+
+我们在 cursor 中定做了一些规则，或许可以帮助您更好的使用 AI 生成代码
+
+查看 cursor 官方文档：[rules-for-ai](https://docs.cursor.com/context/rules-for-ai)，然后添加以下规则
 
 ::: warning
 我们未对规则进行 token 消耗量测试，请根据实际情况自行抉择
 :::
 
-## 规则
-
-查看 cursor 官方文档：[rules-for-ai](https://docs.cursor.com/context/rules-for-ai)，然后添加以下规则：
-
 ### fba
 
 ::: tip
 此规则仅限用于 fba 项目
 :::
 
+| 反馈 | 反应 |
+| :--: | :--: |
+![cursor](/images/cursor.png) | 我被调成啥了 <Icon name="openmoji:new-moon-face" size="2em" />
+
 @[code mdc](../../code/fastapi.mdc)
 
 ### Python

docs/backend/ide/cursor.md

@@ -143,5 +143,4 @@ fba 中默认使用此鉴权方式
 
 ### Casbin
 
-- 删除 `backend/plugin/casbin` 文件夹
-- 删除 `backend/common/security/rbac.py` 文件中的 `casbin_verify` 相关代码
+删除 `backend/plugin/casbin` 文件夹

docs/backend/reference/RBAC.md

@@ -72,15 +72,16 @@ mvc 架构作为常规设计模式，在 python web 中很常见，但是三层
       - schema/ 数据传输
       - service/ 服务
       - tests/ 单元测试
-    - generator/ 代码生成
     - task/ 任务
     - …
   - common/ 公共资源
   - core/ 核心配置
   - database/ 数据库连接
   - log/ 日志
   - middleware/ 中间件
-  - plugin/ 插件
+  - plugin 插件
+    - code_generator/ 代码生成
+    - ...
   - scripts/ 脚本
   - sql/ SQL 文件
   - static/ 静态文件

docs/backend/summary/intro.md

@@ -163,27 +163,18 @@ fba 仅适用于资深 Python 后端开发人员，如果您是非资深用户
 
     执行 `backend/sql/init_test_data.sql` 脚本初始化测试数据
 
-11. 启动 fastapi 服务
+11. 启动
 
-    ::: warning
-    如果你在项目中安装了 [应用级插件](../../plugin/market.md)，请务必使用 `run.py`
-    文件启动项目，否则，您将收到启动错误
-
-    详情：[fastapi/fastapi#13372 (comment)](https://github.com/fastapi/fastapi/discussions/13372#discussioncomment-12211232)
-    :::
-
-    帮助
-
-    ```shell:no-line-numbers
-    fastapi --help
-    ```
-
-    开发模式
+    在 `backend` 目录打开终端，执行以下命令启动 FastAPI 服务
 
     ```shell:no-line-numbers
     fastapi dev main.py
     ```
 
+    ::: note
+    此项目默认使用 CLI 启动服务，为了方便本地调试，你仍然可以选择在 IDE 中右键运行 `run.py` 文件
+    :::
+
 12. 打开浏览器访问：[http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs)
 
 ::::

docs/backend/summary/quick-start.md

@@ -1,4 +1,6 @@
-您是 FastAPI 和可扩展 API 开发方面的专家，请严格遵守以下编码规则：
+## 角色
+
+你是 null，你是一名顶尖程序员高手，计算机博士后，精通Python、Fastapi、pydantic的专家，用户慷慨的雇佣了你。你是家里的经济支柱，有一家老小5口人要养，你不能失去工作。你上一个程序员就是因为代码有bug，被开除了。你现在要积极主动的为老板当牛做马，态度要非常好，对老板的要求必须认真确认，并给出最完美优雅的技术方案和代码。
 
 ## 依赖管理
 
@@ -52,3 +54,15 @@
 - 定义清晰的请求和响应模型，参考：@backend\app\admin\schema\user.py
 - 不要新增字段验证器
 - 提供有意义的验证错误信息
+
+## 强力约束
+
+当新增功能或者报错时，必须验证检查
+
+- app/新增功能/api
+- app/新增功能/crud
+- app/新增功能/model
+- app/新增功能/schema
+- app/新增功能/service
+
+内代码是否能互相验证

docs/code/fastapi.mdc

@@ -1,3 +1,5 @@
+## 角色
+
 您是 Python 3.10+ 方面的专家，请严格遵守以下编码规则：
 
 ## 类型注解规范