优化更新

DjangoAdmin_FastAPI_NaiveVue/zh/volume7/doc-standard.md

@@ -133,7 +133,7 @@ query = query.filter(self._soft_col() == 0)
 ```
 document/                           # 补充文档
 ├── 数据库迁移_runbook.md           # 数据库迁移操作手册
-└── djangoadmin.fastapi.elevue.sql  # 数据库结构 SQL
+└── djangoadmin.fastapi.naivevue.sql  # 数据库结构 SQL
 
 wiki/                               # VitePress 文档站
 ├── zh/                             # 中文文档

DjangoAdmin_FastAPI_NaiveVue/zh/volume7/fe-component.md

@@ -2,11 +2,11 @@
 
 ## 概述
 
-前端基于 Vue3 + ElementPlus + 自定义组件库构建。页面统一使用 `PageWrapper` + `BasicForm` + `BasicTable` + `TableAction` 四件套，分页由 `BasicTable` 内置处理，无需单独引入分页组件。
+前端基于 Vue3 + NaiveUI + 自定义组件库构建。页面统一使用 `PageWrapper` + `BasicForm` + `BasicTable` + `TableAction` 四件套，分页由 `BasicTable` 内置处理，无需单独引入分页组件。
 
 :::tip 技术栈
 - Vue3（Composition API + `<script setup>`）
-- ElementPlus
+- NaiveUI
 - 自定义组件（BasicTable / BasicForm / TableAction / PageWrapper）
 - Pinia 状态管理
 - Vue Router 路由管理
@@ -56,7 +56,7 @@ ui/src/
 ├── utils/                # 工具函数
 ├── hooks/                # 组合式函数
 ├── styles/               # 全局样式
-├── plugins/              # 插件注册（ElementPlus、自定义组件、指令）
+├── plugins/              # 插件注册（NaiveUI、自定义组件、指令）
 └── main.ts               # 入口文件
 ```
 
@@ -79,12 +79,12 @@ ui/src/
 <template>
   <PageWrapper>
     <!-- 搜索表单 -->
-    <el-card :bordered="false" class="pt-3 mb-3 proCard">
+    <n-card :bordered="false" class="pt-3 mb-3 proCard">
       <BasicForm @register="register" @submit="handleSubmit" @reset="handleReset" />
-    </el-card>
+    </n-card>
 
     <!-- 数据表格 -->
-    <el-card :bordered="false" class="proCard">
+    <n-card :bordered="false" class="proCard">
       <BasicTable
         :columns="columns"
         :request="loadDataTable"
@@ -94,22 +94,22 @@ ui/src/
         @selection-change="onSelectionChange"
       >
         <template #tableTitle>
-          <el-button type="primary" @click="handleAdd" v-perm="['sys:param:add']">
-            <el-icon><PlusOutlined /></el-icon>
+          <n-button type="primary" @click="handleAdd" v-perm="['sys:param:add']">
+            <n-icon><PlusOutlined /></n-icon>
             添加参数
-          </el-button>
-          <el-button
-            type="danger"
+          </n-button>
+          <n-button
+            type="error"
             @click="handleDelete()"
             :disabled="!selectionData.length"
             v-perm="['sys:param:batchDelete']"
           >
-            <el-icon><Delete /></el-icon>
+            <n-icon><Delete /></n-icon>
             删除
-          </el-button>
+          </n-button>
         </template>
       </BasicTable>
-    </el-card>
+    </n-card>
 
     <!-- 编辑弹窗（懒加载） -->
     <editDialog
@@ -133,7 +133,7 @@ ui/src/
 ```typescript
 // views/data/param/columns.ts
 import { h } from 'vue';
-import { ElTag } from 'element-plus';
+import { NTag } from 'naive-ui';
 
 export const columns = [
   { type: 'selection' },                    // 多选列
@@ -146,7 +146,7 @@ export const columns = [
     prop: 'type',
     minWidth: 100,
     render(record) {
-      return h(ElTag,
+      return h(NTag,
         { type: record.row.type == 0 ? 'primary' : 'warning' },
         { default: () => (record.row.type == 0 ? '系统' : '业务') }
       );
@@ -157,8 +157,8 @@ export const columns = [
     prop: 'status',
     minWidth: 100,
     render(record) {
-      return h(ElTag,
-        { type: record.row.status == 1 ? 'success' : 'danger' },
+      return h(NTag,
+        { type: record.row.status == 1 ? 'success' : 'error' },
         { default: () => (record.row.status == 1 ? '正常' : '禁用') }
       );
     },
@@ -172,8 +172,8 @@ export const columns = [
 ```typescript
 // 状态标签
 render(record) {
-  return h(ElTag,
-    { type: record.row.status == 1 ? 'success' : 'danger' },
+  return h(NTag,
+    { type: record.row.status == 1 ? 'success' : 'error' },
     { default: () => record.row.statusText }  // 使用后端 serialize_maps 返回的 xxxText
   );
 }
@@ -251,7 +251,7 @@ const actionColumn = reactive({
         {
           label: '删除',
           icon: 'Delete',
-          type: 'danger',
+          type: 'error',
           onClick: handleDelete.bind(null, record),
           auth: ['sys:param:delete'],
         },

DjangoAdmin_FastAPI_NaiveVue/zh/volume7/service.md

@@ -73,6 +73,9 @@ position_service = PositionService()
 | `serialize_maps` | dict | 枚举显示名映射 | `{'status': {1: '在用', 2: '停用'}}` |
 | `file_fields` | tuple | 文件字段 | `('cover', 'image')` |
 | `rich_text_fields` | tuple | 富文本字段 | `('content',)` |
+| `file_dir` | str | 文件存储子目录名 | 默认从表名去掉 `DB_PREFIX` 推导 |
+| `serialize_extra` | Callable | 列表/详情共用序列化钩子，返回需合并进字典的额外字段 | — |
+| `detail_serialize` | Callable | 详情专用序列化钩子，仅在 `get_detail` 时合并 | — |
 
 :::tip 单例模式
 每个模块在文件末尾创建 Service 实例（如 `position_service`），供 Endpoint 层使用。