提交

openspec/changes/zkxw-engineering-standards/specs/ui-conventions/spec.md

@@ -54,6 +54,23 @@ Web 管理端弹窗 SHALL 遵循规范：表单 `label-position="top"`；遮罩
 - **WHEN** 展示商品列表缩略图
 - **THEN** 图片区域 SHALL 为 1:1 且使用 `aspectFill`（与规范 §7.0.1 一致）
 
+### Requirement: 页面不展示顶部 page-head 大标题与描述
+
+`web-admin` 所有左侧菜单对应的页面 **SHALL NOT** 包含顶部 `<header class="page-head">`（或 `<div class="page-head">`）区块，即不在页面顶部展示 `<h1>` 大标题和 `<p class="page-desc">` 描述文字。页面内容 SHALL 直接从 `<section class="panel">`（或 `<div class="panel">`）开始。
+
+**理由**：左侧菜单已提供当前页面名称，顶部大标题和描述属于冗余信息，移除后页面更简洁、内容区更大。
+
+#### Scenario: 新增菜单页面无 page-head
+
+- **WHEN** 新增一个左侧菜单对应的页面
+- **THEN** 该页面 SHALL NOT 包含 `<header class="page-head">` 或 `<div class="page-head">` 元素
+- **THEN** 页面模板 SHALL 直接以 `<section class="panel">` 或 `<div class="panel">` 作为第一个子内容块
+
+#### Scenario: Code review 检查 page-head
+
+- **WHEN** PR 包含新增或修改的页面文件（`src/views/**/*.vue`）
+- **THEN** 审查者 SHALL 确认该页面不包含 `class="page-head"` 元素
+
 ### Requirement: 列表面板主标题装饰
 
 `web-admin` 中列表面板 `panel-top` 下的主标题（`h2.title-bar-heading`）SHALL 在标题文案前展示 **主色竖条**（与全局 `app.scss` 中 `h2.title-bar-heading::before` 一致）；含「租户」「用户」等易歧义文案的标题 SHALL 通过 `App.vue` 中 `panelTitleBarTextRules` 显式纳入竖条样式，避免子串误匹配为其它图标。
@@ -907,7 +924,7 @@ import { protocolStatusLabel, protocolStatusTagType } from '@/utils/status-tag-r
 
 **各模式 SHALL 级要点（摘要）：**
 
-- **P01**：`page-head` → `filter-block` → `list-toolbar`（已选 N 项在前）→ `list-table stripe` → 分页；`dialog-form-layout` 编辑 + `SystemViewDialog` 查看。
+- **P01**：`filter-block` → `list-toolbar`（已选 N 项在前）→ `list-table stripe` → 分页；`dialog-form-layout` 编辑 + `SystemViewDialog` 查看。
 - **P02**：在 P01 基础上增加状态筛选、操作列多按钮、业务弹窗（审核/状态变更）。
 - **P03**：`el-table` 树形、无分页；路径展示遵循「树形主数据展示规则」Requirement。
 - **P04**：左 `el-tree` + 右 P01 列表；组织全路径用 `tree-path.ts`。