update docs

Author: wu-clan

docs/.vuepress/_bulletin.md

@@ -2,9 +2,11 @@
 🎉 v1.11.0 已发布 🎉
 :::
 
-**重大变化**
+::: warning 重大变化
 
-- 🚀 重构外键约束为逻辑外键
+- 🚀 重构外键约束为逻辑外键（升级需重新创建数据库表并清理缓存）
+
+:::
 
 **cc 推荐**
 

docs/.vuepress/styles/custom.css

@@ -32,6 +32,7 @@
     }
 }
 
+/* 首页非全屏样式 */
 .vp-home-hero:not(.full) .hero-container {
     padding-top: 166px !important;
     padding-bottom: 96px !important;
@@ -68,7 +69,7 @@
     border: 1px solid rgb(177 177 177 / 66%) !important;
 }
 
-/* 文档页左侧边栏赞助位，如果提供 top 插槽，则更新 */
+/* 文档页左侧边栏赞助位，如果提供 top 插槽，则删除 */
 #SidebarNav > div.custom-content {
     position: sticky;
     top: 0;

docs/.vuepress/theme.ts

@@ -49,6 +49,7 @@ export const myTheme: Theme = plumeTheme({
     ],
     navbarSocialInclude: ['github', 'gitee'],
     editLinkText: '编辑此页面',
+    lastUpdated: false,
     contributors: false,
     //watermark: true,
     markdown: {

docs/README.md

@@ -5,7 +5,6 @@ watermark: false
 signDown: true
 config:
   - type: hero
-    effect: prism
     hero:
       name: FastAPI Best Architecture
       tagline: 企业级后端架构解决方案

docs/code/data_perm.py

@@ -1,25 +1,23 @@
-def filter_data_permission(request: Request, model: Any) -> ColumnElement[bool]:
+def filter_data_permission(request_user: GetUserInfoWithRelationDetail, model: Any) -> ColumnElement[bool]:
     """
-    过滤用户数据权限
+    过滤数据权限，控制用户可见数据范围
 
-    :param request: 接口请求对象
+    使用场景：
+        - 控制用户能看到哪些数据
+
+    :param request_user: 请求用户
     :param model: 需要进行数据过滤的 sqlalchemy 模型
     :return:
     """
-    user = request.user
-
     # 超级管理员可查看所有数据
-    if user.is_superuser:
+    if request_user.is_superuser:
         return or_(1 == 1)
 
-    user_id = user.id
-    user_roles = user.roles
-
     # 无角色只能查看自己数据
-    if not user_roles:
-        return or_(getattr(model, 'created_by') == user_id if hasattr(model, 'created_by') else 1 == 0)
+    if not request_user.roles:
+        return or_(getattr(model, 'created_by') == request_user.id if hasattr(model, 'created_by') else 1 == 0)
 
-    data_scope = min(role.data_scope for role in user_roles if role.status == 1)
+    data_scope = min(role.data_scope for role in request_user.roles if role.status == 1)
     user_dept_id = user.dept_id
 
     # 全部数据权限
@@ -28,8 +26,8 @@ def filter_data_permission(request: Request, model: Any) -> ColumnElement[bool]:
 
     # 自定义数据权限
     elif data_scope == 1:
-        dept_ids = select(sys_role_dept.c.dept_id).where(
-            sys_role_dept.c.role_id.in_(role.id for role in user_roles if role.status == 1)
+        dept_ids = select(role_dept.c.dept_id).where(
+            role_dept.c.role_id.in_(role.id for role in request_user.roles if role.status == 1)
         )
         return or_(getattr(model, 'dept_id').in_(dept_ids) if hasattr(model, 'dept_id') else 1 == 0)
 
@@ -44,7 +42,7 @@ def filter_data_permission(request: Request, model: Any) -> ColumnElement[bool]:
 
     # 仅本人数据权限
     elif data_scope == 4:
-        return or_(getattr(model, 'created_by') == user_id if hasattr(model, 'created_by') else 1 == 0)
+        return or_(getattr(model, 'created_by') == request_user.id if hasattr(model, 'created_by') else 1 == 0)
 
     # 默认
     else:

package.json

@@ -21,16 +21,14 @@
     "@vuepress/plugin-baidu-analytics": "2.0.0-rc.118",
     "@vuepress/plugin-llms": "2.0.0-rc.118",
     "@vuepress/plugin-umami-analytics": "2.0.0-rc.118",
-    "vue": "^3.5.22",
+    "vue": "^3.5.24",
     "vuepress": "2.0.0-rc.26",
-    "vuepress-theme-plume": "1.0.0-rc.175"
+    "vuepress-theme-plume": "1.0.0-rc.176"
   },
   "dependencies": {
-    "@iconify/json": "^2.2.402",
+    "@iconify/json": "^2.2.406",
     "@vueuse/core": "^12.8.2",
     "mermaid": "^11.12.1",
-    "ogl": "^1.0.11",
-    "swiper": "^12.0.3",
-    "three": "^0.180.0"
+    "swiper": "^12.0.3"
   }
 }