ow

uniapp/youjiala/src/md/admin-pages.md

@@ -14,15 +14,15 @@
 
 - **保留** `bindOption` 数据模型（后端列名 / `Type` / `Operator` / `SelectOptions`）与查询语义（分页、条件、`orderby`），因为后端 `FindBySearchCriteria` 吃的就是这个形状；
 - **砍掉** 多列网格、列配置、打印、排序表头——手机没有对应交互；
-- **重写** 列表为卡片流、详情为单列卡、选择为"真跳一页再回传"。
+- **重写** 列表为卡片流、详情为单列卡、选择为"页内底部弹窗"（`admin-pick-popup`，见 §3.3）。
 
 复用分三层，边界清楚，换域移植（Group/Function/Dms/Publish…）时机械部分零改动：
 
 | 层 | 文件 | 认识什么 | 不认识什么 |
 | --- | --- | --- | --- |
 | 纯函数 | `admin/admin-filter.ts`、`admin-date.ts`、`admin-column.ts`、`admin-types.ts` | SearchFilter / BindOption / 日期口径 | vue、uni、service |
-| composable | `useAdminList`、`useAdminPick`、`useAdminMenu` | 上面那层 + vue 响应式 | z-paging、service、权限名 |
-| 组件 | `admin-list`、`admin-form`、`admin-filter-drawer` | z-paging + uview-pro | service、**权限** |
+| composable | `useAdminList`、`useAdminPick`、`usePickerConfigs`、`useAdminMenu` | 上面那层 + vue 响应式 | z-paging、service、权限名 |
+| 组件 | `admin-list`、`admin-form`、`admin-filter-drawer`、`admin-pick-popup` | z-paging / u-popup + uview-pro | service、**权限** |
 
 **组件不判权限**：按钮由页面按 `canCreate/canAmend/canDelete` 组好数组（详情）或用 `v-if`（列表工具条）传进来。这样公共组件不需要知道任何一个域的权限名。
 
@@ -34,7 +34,7 @@
 | --- | --- | --- | --- |
 | `userEnquiry` | `pages/security/user-enquiry` | `UserEnquiry.vue` | 用户列表：三条筛选（用户名/中文名/创建日期区间）、每页 20、按创建日期倒序、行点进详情、多选批量作废 |
 | `userOperation` | `pages/security/user-operation` | `UserOperation.vue` | 用户详情：查看/新增/修改，`?id=&mode=`；角色明细在 `#extra` 插槽自绘 |
-| `actorEnquiry` | `pages/security/actor-enquiry` | `ActorEnquiry.vue` | 角色查询，**双用途**（见 §3.3） |
+| `actorEnquiry` | `pages/security/actor-enquiry` | `ActorEnquiry.vue` | 角色查询，纯列表页（选角色改由调用方弹窗，见 §3.3） |
 | `dashboard` | `pages/dashboard/dashboard` | `layout` 菜单 | 入口九宫格，`FindMenuByUsername` 驱动（见 §5） |
 
 列表页写法（`user-enquiry.vue` 为准）：`reactive(bindOptions)` + 一个只碰具体 service 的 `fetchData(query)` 交给 `useAdminList`；解构出的 `filterCount/filterVisible/draft/searchToken` 是 ref/computed，模板自动 unwrap，方法仍走 `state.xxx`。取数排在 `useAuthGuard` 之后（`admin-list` 的 `auto` 默认 false，首屏手动 `listRef.refresh()` 一次）。
@@ -53,16 +53,20 @@
 ### 3.2 user-operation 的取数与保存
 `onLoad` 读 `id`（=`UserName`）与 `mode`；`FindByKey` 取 `SecurityUserData`，取不到提示"记录不存在"。保存按有无 `CreatedBy` 决定 `Update`/`Insert`，成功后用后端回写的档案刷新、回填主键、退回只读。密码编辑的是 `SecurityUserDisplayData.OrgUserPassword`（留空即不改），只在编辑态出现。
 
-### 3.3 选择页回传协议（useAdminPick / useAdminPickTarget）
-旧系统的"选角色"是 Operation 用 `<dragModal>` 内嵌 Enquiry + `provide/inject`。移动端改成**真跳一页再回传**：
+### 3.3 选择器：`admin-pick-popup` 页内底部弹窗
+旧系统的"选角色/选权限/选功能"是 Operation 用 `<dragModal>` 内嵌 Enquiry + `provide/inject`。移动端第一版改成"真跳一页再回传"，但多数选择页 `show-nav-back=false` 且没有取消按钮，用户进去就退不出来。现已改为**页内弹窗**：
 
-- 调用方 `useAdminPick<T>(channel).open({ page, params }, onPicked)`——先退订再订阅，`onUnmounted` 兜底清理；
-- 目标页（`actor-enquiry`）`useAdminPickTarget()` 在 `onLoad` 里 `readOptions(options)` 存下 `channel`/`multiple`，确定时 `deliver(rows)`（`uni.$emit('admin:pick:'+channel, rows)` + `navigateBack`）；
-- `actor-enquiry` 因此**同一个列表两种用法**：菜单进入（无 `channel`）是普通查询；被带 `?channel=&multiple=1` 打开就是选择器，单选点行即回传、多选底部"完成"批量回传。
+- 组件 `components/admin-pick-popup/admin-pick-popup.vue`：`u-popup mode="bottom"`（80vh）+ `scroll-view` 手动分页（**不能用 z-paging**：它默认 `position:fixed` 撑满视口，在弹层内会打架）；
+- Props `visible / title / columns / loader / rowKey / titleKey / multiple / fixedFilters / pageSize`，Emits `update:visible / close / confirm(rows)`；
+- 数据源在 `composables/usePickerConfigs.ts`：每个被选数据一个工厂函数（`usePermissionPickConfig`、`useDependentPickConfig`、`useActorPickConfig`、`useGroupPickConfig`、`useUserPickConfig`、`useFunctionPickConfig`、`useHelpFeaturePickConfig`），返回 `{ columns, loader, rowKey, titleKey, fixedFilters }`；
+- 调用方只需 `const xxxConfig = useXxxPickConfig(); const showXxxPicker = ref(false);`，点入口置 `true`，`@confirm` 里做原来的去重合并逻辑。需要动态过滤（如扩展权限按 `dependent`）时写 `xxxConfig.fixedFilters.value = { dependent }`；
+- 单选点行即 `confirm` + 关闭；多选勾选后点确定；X / 遮罩 / 取消三条退路都通。
 
-**协议参数一律不做 `encodeURIComponent`**：H5 侧 uni/vue-router 拼 URL 用 `encodeURI`，预编码会把 `%` 再编成 `%25`。`channel` 与 `params` 的值只允许字母/数字/下划线/连字符/点/斜杠。
+**security 域的 enquiry 页因此回归纯列表页**：`isPick` / `pickTarget` / `onLoad(channel)` / `deliver()` 全部删除，`:show-nav-back="true"` 恒定，`+` 新增入口不再被选择器态隐藏。
 
-> 命名订正：这个页面就叫 `actor-enquiry`（旧系统本是 `ActorEnquiry.vue`），早期草稿里的 `actor-pick` 是造错的概念——"选择"只是它带 `channel` 打开时的一种模式，不是另一张页面。
+`useAdminPick` / `useAdminPickTarget` 机制本身**保留**：`family-person-enquiry` 仍作为「族员选择器」被首页 dashboard 以 `?channel=person` 调起。那条老路子的协议参数一律不做 `encodeURIComponent`（H5 侧 uni/vue-router 拼 URL 用 `encodeURI`，预编码会把 `%` 再编成 `%25`）。
+
+> 命名订正：`actor-enquiry` 就是旧 `ActorEnquiry.vue` 的移植，早期草稿里的 `actor-pick` 是造错的概念——它现在只是普通查询页，选择能力在调用方的弹窗里。
 
 ---