提交

docs/superpowers/plans/2026-08-01-portal-mega-panel-min-width.md

@@ -0,0 +1,21 @@
+# 门户大面板最小宽度（方案 B）
+
+> **For agentic workers:** 仅改前端定位；完成后人工在窄权限账号下点开一级验证。
+
+**Goal:** 一级菜单较少时，二级大面板仍有足够宽度（最小约 720px），相对一级居中。
+
+**Architecture:** 在 `ArtPortalMegaMenu.syncPanelPosition` 中计算 `max(一级宽, min(720, 视口−32))`，再按一级中心水平居中并钳制边距。
+
+**Tech Stack:** Vue 3 · `art-portal-mega-menu/index.vue`
+
+---
+
+### Task 1: 更新面板定位
+
+**Files:**
+- Modify: `web-admin/src/components/core/layouts/art-portal-mega-menu/index.vue`
+- Modify: `docs/superpowers/specs/2026-08-01-portal-mega-menu-design.md`（已补充规则）
+
+**Step:** 改写 `syncPanelPosition` 按方案 B 计算 `left` / `width`；`top` 仍为一级底边。
+
+**Verify:** 一级仅 2/4 项时面板宽 ≈ 720；一级很多时面板随一级变宽；窗口很窄时不超出视口。

docs/superpowers/plans/2026-08-01-quote-approver-setting.md

@@ -0,0 +1,761 @@
+# 报价单审批人设置 Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** 新增租户级「报价单审批人设置」，提交审批弹窗自动预填默认审批人（可改）；未配置时行为与现网一致。
+
+**Architecture:** 新表 `crm_quote_approver_setting` 存有序 `approver_ids` + 启用状态；CRM POST 风格 get/save API；前端设置页维护配置；报价提交弹窗打开时 GET 并预填。`submitQuote` 入参与审批链路不变。
+
+**Tech Stack:** FastAPI + SQLAlchemy + MySQL；Vue 3 + Element Plus（web-admin）；菜单权限 `crm:quote:approverSetting`
+
+**Spec:** `docs/superpowers/specs/2026-08-01-quote-approver-setting-design.md`  
+**UI Demo:** `docs/fresh-mint-quote-approver-setting-demo.html`  
+**UI 模式:** 单对象配置表单页（对照 Demo；非 P01 列表）。PR 注明「配置表单 + 提交预填」。
+
+---
+
+## File map
+
+| File | Responsibility |
+|------|----------------|
+| `backend/scripts/migrate_20260801_crm_quote_approver_setting.sql` | 建表 + 菜单 |
+| `docs/sql/shanxia2.0.sql` | 同步 CREATE TABLE / 菜单 INSERT（与 migrate 一致） |
+| `backend/app/models/crm_models.py` | `CrmQuoteApproverSetting` |
+| `backend/app/crud/crm/quote_approver_setting.py` | parse/join helpers + get/save upsert |
+| `backend/app/schemas/crm/quote_approver_setting.py` | Save body |
+| `backend/app/api/crm_quote_routes.py` | 注册 get/save 路由 |
+| `backend/tests/test_quote_approver_setting.py` | 纯函数单测 |
+| `web-admin/src/api/crm/quote/index.ts` + `types.ts` | 前端 API/类型 |
+| `web-admin/src/views/crm/quote/approver-setting/index.vue` | 设置页 |
+| `web-admin/src/router/modules/sqxp.ts` | 路由 |
+| `web-admin/src/views/crm/quote/index.vue` | 提交弹窗预填 |
+| `web-admin/src/views/crm/quote/components/QuoteFormPanel.vue` | 提交弹窗预填 |
+| `web-admin/src/views/crm/quote/components/ApproverSelector.vue` | 打开时预填（若仍被调用） |
+
+---
+
+### Task 1: 纯函数与单测（TDD）
+
+**Files:**
+- Create: `backend/app/crud/crm/quote_approver_setting.py`（先只放 helpers）
+- Create: `backend/tests/test_quote_approver_setting.py`
+
+- [ ] **Step 1: 写失败单测**
+
+```python
+# backend/tests/test_quote_approver_setting.py
+from app.crud.crm.quote_approver_setting import (
+    join_approver_ids,
+    parse_approver_ids,
+    prefill_approver_ids,
+)
+
+
+def test_parse_and_join_roundtrip():
+    assert parse_approver_ids("a,b,c") == ["a", "b", "c"]
+    assert parse_approver_ids(" a,, b ") == ["a", "b"]
+    assert parse_approver_ids("") == []
+    assert parse_approver_ids(None) == []
+    assert join_approver_ids(["a", "b", ""]) == "a,b"
+
+
+def test_prefill_requires_enabled_and_nonempty():
+    assert prefill_approver_ids(None) == []
+    assert prefill_approver_ids({"status": "1", "approverIds": ["u1"]}) == []
+    assert prefill_approver_ids({"status": "0", "approverIds": []}) == []
+    assert prefill_approver_ids({"status": "0", "approverIds": ["u1", "u2"]}) == ["u1", "u2"]
+
+
+def test_prefill_filters_against_valid_ids():
+    setting = {"status": "0", "approverIds": ["u1", "gone", "u2"]}
+    assert prefill_approver_ids(setting, valid_ids={"u1", "u2"}) == ["u1", "u2"]
+    assert prefill_approver_ids(setting, valid_ids=set()) == []
+```
+
+- [ ] **Step 2: 跑测确认失败**
+
+```bash
+cd backend && source venv/bin/activate && pytest tests/test_quote_approver_setting.py -v
+```
+
+Expected: FAIL（模块/函数不存在）
+
+- [ ] **Step 3: 实现 helpers**
+
+```python
+# backend/app/crud/crm/quote_approver_setting.py
+from __future__ import annotations
+
+from typing import Any, Dict, Iterable, List, Optional, Set
+
+
+def parse_approver_ids(raw: Optional[str]) -> List[str]:
+    if not raw:
+        return []
+    out: List[str] = []
+    for part in str(raw).split(","):
+        pid = part.strip()
+        if pid:
+            out.append(pid)
+    return out
+
+
+def join_approver_ids(ids: Iterable[str]) -> str:
+    return ",".join([str(i).strip() for i in ids if str(i).strip()])
+
+
+def prefill_approver_ids(
+    setting: Optional[Dict[str, Any]],
+    *,
+    valid_ids: Optional[Set[str]] = None,
+) -> List[str]:
+    """返回可预填的审批人 ID 列表；不可用则空列表。"""
+    if not setting:
+        return []
+    if str(setting.get("status") or "") != "0":
+        return []
+    ids = list(setting.get("approverIds") or [])
+    if valid_ids is not None:
+        ids = [i for i in ids if str(i) in valid_ids]
+    return [str(i) for i in ids if str(i).strip()]
+```
+
+- [ ] **Step 4: 再跑测确认通过**
+
+```bash
+cd backend && source venv/bin/activate && pytest tests/test_quote_approver_setting.py -v
+```
+
+Expected: PASS
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add backend/app/crud/crm/quote_approver_setting.py backend/tests/test_quote_approver_setting.py
+git commit -m "$(cat <<'EOF'
+feat(crm): add quote approver setting id helpers and unit tests
+
+EOF
+)"
+```
+
+---
+
+### Task 2: SQL 迁移（表 + 菜单）
+
+**Files:**
+- Create: `backend/scripts/migrate_20260801_crm_quote_approver_setting.sql`
+- Modify: `docs/sql/shanxia2.0.sql`（在 `crm_quote_approval` 表段落后插入 CREATE；在报价单管理菜单附近插入菜单行）
+
+- [ ] **Step 1: 写 migrate SQL**
+
+```sql
+-- backend/scripts/migrate_20260801_crm_quote_approver_setting.sql
+
+CREATE TABLE IF NOT EXISTS `crm_quote_approver_setting` (
+  `id` varchar(64) NOT NULL COMMENT '主键ID（UUID）',
+  `approver_ids` varchar(1000) NOT NULL DEFAULT '' COMMENT '有序审批人用户ID，逗号分隔',
+  `status` char(1) NOT NULL DEFAULT '0' COMMENT '0启用 1停用',
+  `tenant_no` varchar(64) NOT NULL DEFAULT 'shanxia2.0' COMMENT '租户编号',
+  `order_num` int(11) DEFAULT NULL COMMENT '排序号',
+  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
+  `create_by` varchar(64) DEFAULT NULL COMMENT '创建者',
+  `create_dept_id` varchar(64) NOT NULL DEFAULT '' COMMENT '创建部门',
+  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  `update_by` varchar(64) DEFAULT NULL COMMENT '更新者',
+  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `del_flag` smallint(6) NOT NULL DEFAULT '0' COMMENT '删除标志',
+  PRIMARY KEY (`id`),
+  KEY `idx_tenant_no` (`tenant_no`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-报价单审批人设置（租户级）';
+
+-- 说明：MySQL 5.7 无部分唯一索引；租户「有效一条」由 save_setting upsert 保证，不加 (tenant_no, del_flag) 唯一键。
+
+-- 菜单：报价单审批人设置（CRM 根下，紧挨报价单管理）
+INSERT INTO `sys_menu` (
+  `id`, `menu_name`, `parent_id`, `menu_type`, `path`, `component`, `perms`,
+  `is_frame`, `visible`, `status`, `tenant_no`, `order_num`, `remark`,
+  `create_by`, `create_dept_id`, `create_time`, `update_by`, `update_time`, `del_flag`
+) VALUES (
+  'CRM3000000000000000000000000015',
+  '报价单审批人设置',
+  'CRM00000000000000000000000000001',
+  'C',
+  'quote-approver-setting',
+  '/crm/quote/approver-setting/index',
+  'crm:quote:approverSetting',
+  1, '1', '1', 'shanxia2.0', 55,
+  '租户级默认报价审批人',
+  'system', '', NOW(), NULL, NOW(), 0
+)
+ON DUPLICATE KEY UPDATE
+  `menu_name`=VALUES(`menu_name`),
+  `component`=VALUES(`component`),
+  `perms`=VALUES(`perms`),
+  `path`=VALUES(`path`);
+```
+
+- [ ] **Step 2: 同步 `docs/sql/shanxia2.0.sql`**
+
+将相同 `CREATE TABLE` 与 `INSERT INTO sys_menu` 片段并入快照（位置：报价相关表/菜单附近），避免文档与库漂移。
+
+- [ ] **Step 3: 在本地库执行 migrate**（开发环境）
+
+```bash
+# 按本地 .env 连接执行；示例：
+mysql -h... -u... -p... your_db < backend/scripts/migrate_20260801_crm_quote_approver_setting.sql
+```
+
+Expected: 表与菜单创建成功。
+
+- [ ] **Step 4: 给需要维护配置的角色勾选新菜单**
+
+在「角色管理」中为管理员角色勾选「报价单审批人设置」（或按环境向 `sys_role_menu` 插入对应 `menu_id`）。`super_admin` 本身放行，可不依赖角色菜单。
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add backend/scripts/migrate_20260801_crm_quote_approver_setting.sql docs/sql/shanxia2.0.sql
+git commit -m "$(cat <<'EOF'
+feat(crm): add quote approver setting table and menu SQL
+
+EOF
+)"
+```
+
+---
+
+### Task 3: Model + CRUD upsert + Schema
+
+**Files:**
+- Modify: `backend/app/models/crm_models.py`（在 `CrmQuoteApproval` 前或后新增模型）
+- Modify: `backend/app/crud/crm/quote_approver_setting.py`（补 get/save）
+- Create: `backend/app/schemas/crm/quote_approver_setting.py`
+
+- [ ] **Step 1: 增加 SQLAlchemy 模型**
+
+```python
+class CrmQuoteApproverSetting(Base):
+    """CRM-报价单审批人设置（租户级）"""
+
+    __tablename__ = "crm_quote_approver_setting"
+
+    id = Column(String(64), primary_key=True, comment="主键ID（UUID）")
+    approver_ids = Column(String(1000), nullable=False, default="", comment="有序审批人用户ID，逗号分隔")
+    status = Column(String(1), nullable=False, default="0", comment="0启用 1停用")
+    tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
+    order_num = Column(Integer, nullable=True, comment="排序号")
+    remark = Column(String(500), nullable=True, comment="备注")
+    create_by = Column(String(64), nullable=True, comment="创建者")
+    create_dept_id = Column(String(64), nullable=False, default="", comment="创建部门")
+    create_time = Column(DateTime, nullable=False, default=datetime.now, comment="创建时间")
+    update_by = Column(String(64), nullable=True, comment="更新者")
+    update_time = Column(DateTime, nullable=False, default=datetime.now, onupdate=datetime.now, comment="更新时间")
+    del_flag = Column(SmallInteger, nullable=False, default=0, comment="删除标记")
+```
+
+- [ ] **Step 2: Schema**
+
+```python
+# backend/app/schemas/crm/quote_approver_setting.py
+from typing import List, Optional
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class QuoteApproverSettingSaveBody(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    approverIds: List[str] = Field(default_factory=list)
+    status: str = Field(default="0")  # 0启用 1停用
+```
+
+- [ ] **Step 3: 实现 get_setting / save_setting**
+
+在 `quote_approver_setting.py` 追加（要点）：
+
+```python
+from datetime import datetime
+from sqlalchemy.orm import Session
+
+from app.core.utils import generate_uuid
+from app.models.crm_models import CrmQuoteApproverSetting
+from app.models.models import SysUser
+
+
+def _row_to_dict(row: CrmQuoteApproverSetting) -> Dict[str, Any]:
+    return {
+        "id": row.id,
+        "approverIds": parse_approver_ids(row.approver_ids),
+        "status": row.status or "0",
+        "tenantNo": row.tenant_no,
+        "updateTime": row.update_time.isoformat(sep=" ") if row.update_time else None,
+    }
+
+
+def get_setting(db: Session, *, tenant_no: str) -> Optional[Dict[str, Any]]:
+    row = (
+        db.query(CrmQuoteApproverSetting)
+        .filter(
+            CrmQuoteApproverSetting.tenant_no == tenant_no,
+            CrmQuoteApproverSetting.del_flag == 0,
+        )
+        .order_by(CrmQuoteApproverSetting.update_time.desc())
+        .first()
+    )
+    return _row_to_dict(row) if row else None
+
+
+def _assert_users_exist(db: Session, *, tenant_no: str, approver_ids: List[str]) -> None:
+    ids = [str(i).strip() for i in approver_ids if str(i).strip()]
+    if not ids:
+        return
+    rows = (
+        db.query(SysUser.id)
+        .filter(SysUser.id.in_(ids), SysUser.del_flag == 0)
+        .all()
+    )
+    found = {str(r[0]) for r in rows}
+    missing = [i for i in ids if i not in found]
+    if missing:
+        raise ValueError(f"审批人无效或不存在：{','.join(missing)}")
+
+
+def save_setting(
+    db: Session,
+    *,
+    tenant_no: str,
+    approver_ids: List[str],
+    status: str,
+    user_id: str = None,
+    dept_id: str = "",
+) -> Dict[str, Any]:
+    status_norm = "1" if str(status) == "1" else "0"
+    ids = [str(i).strip() for i in (approver_ids or []) if str(i).strip()]
+    _assert_users_exist(db, tenant_no=tenant_no, approver_ids=ids)
+
+    row = (
+        db.query(CrmQuoteApproverSetting)
+        .filter(
+            CrmQuoteApproverSetting.tenant_no == tenant_no,
+            CrmQuoteApproverSetting.del_flag == 0,
+        )
+        .first()
+    )
+    now = datetime.now()
+    if row:
+        row.approver_ids = join_approver_ids(ids)
+        row.status = status_norm
+        row.update_by = user_id
+        row.update_time = now
+    else:
+        row = CrmQuoteApproverSetting(
+            id=generate_uuid(),
+            approver_ids=join_approver_ids(ids),
+            status=status_norm,
+            tenant_no=tenant_no,
+            create_by=user_id,
+            create_dept_id=dept_id or "",
+            create_time=now,
+            update_by=user_id,
+            update_time=now,
+            del_flag=0,
+        )
+        db.add(row)
+    db.commit()
+    db.refresh(row)
+    return _row_to_dict(row)
+```
+
+注意：若 `SysUser` 有租户字段且项目惯例按租户过滤用户，在 `_assert_users_exist` 中追加与现有用户查询一致的 `tenant_no` 条件。
+
+- [ ] **Step 4: 再跑 Task 1 单测**（确保 helpers 未破坏）
+
+```bash
+cd backend && source venv/bin/activate && pytest tests/test_quote_approver_setting.py -v
+```
+
+Expected: PASS
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add backend/app/models/crm_models.py backend/app/crud/crm/quote_approver_setting.py backend/app/schemas/crm/quote_approver_setting.py
+git commit -m "$(cat <<'EOF'
+feat(crm): implement quote approver setting model and upsert CRUD
+
+EOF
+)"
+```
+
+---
+
+### Task 4: API 路由
+
+**Files:**
+- Modify: `backend/app/api/crm_quote_routes.py`
+
+- [ ] **Step 1: 在 `register_quote_routes` 末尾注册两个 POST**
+
+风格对齐现有 `/quote/*`（POST + body），路径：
+
+- `POST /quote-approver-setting/get` — `Depends(require_admin_or_super_admin)`（业务员可读以预填）
+- `POST /quote-approver-setting/save` — `Depends(require_menu_code("crm:quote:approverSetting"))`
+
+```python
+from app.core.menu_guard import require_admin_or_super_admin, require_menu_code
+from app.crud.crm.quote_approver_setting import get_setting, save_setting
+from app.schemas.crm.quote_approver_setting import QuoteApproverSettingSaveBody
+
+# 在 register_quote_routes 内：
+
+@router.post("/quote-approver-setting/get")
+async def quote_approver_setting_get(
+    _user: dict = Depends(require_admin_or_super_admin),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = get_tenant_no(db, _user)
+        data = get_setting(db, tenant_no=tenant_no)
+        return success_response(data or {"approverIds": [], "status": "0"})
+    except Exception as e:
+        return error_response(500, str(e))
+
+
+@router.post("/quote-approver-setting/save")
+async def quote_approver_setting_save(
+    body: QuoteApproverSettingSaveBody,
+    _user: dict = Depends(require_menu_code("crm:quote:approverSetting")),
+    db: Session = Depends(get_db),
+):
+    try:
+        tenant_no = get_tenant_no(db, _user)
+        user_info = crm_user_info(_user)
+        data = save_setting(
+            db,
+            tenant_no=tenant_no,
+            approver_ids=body.approverIds or [],
+            status=body.status or "0",
+            user_id=user_info.get("user_id") or _user.get("user_id"),
+            dept_id=user_info.get("dept_id") or "",
+        )
+        return success_response(data, message="保存成功")
+    except ValueError as e:
+        return error_response(400, str(e))
+    except Exception as e:
+        return error_response(500, str(e))
+```
+
+未配置时 GET 返回 `{ approverIds: [], status: "0" }`（表单默认启用；`approverIds` 为空故预填仍为空）。勿用 `status:"1"` 作为空配置哨兵，否则设置页首次打开会落到「停用」。
+
+- [ ] **Step 2: 手工用已登录 token 冒烟**（Swagger `/docs` 或 curl）
+
+Expected: get 返回空配置；save 后 get 带回 `approverIds`；无菜单权限用户 save → 403。
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add backend/app/api/crm_quote_routes.py
+git commit -m "$(cat <<'EOF'
+feat(crm): expose quote approver setting get/save APIs
+
+EOF
+)"
+```
+
+---
+
+### Task 5: 前端 API 与类型
+
+**Files:**
+- Modify: `web-admin/src/api/crm/quote/types.ts`
+- Modify: `web-admin/src/api/crm/quote/index.ts`
+
+- [ ] **Step 1: 类型**
+
+```ts
+export interface QuoteApproverSettingVO {
+  id?: string
+  approverIds: (string | number)[]
+  status: '0' | '1' | string
+  updateTime?: string
+}
+
+export interface QuoteApproverSettingForm {
+  approverIds: (string | number)[]
+  status: '0' | '1'
+}
+```
+
+- [ ] **Step 2: API**
+
+```ts
+const SETTING_BASE = '/web/crm/quote-approver-setting'
+
+export async function getQuoteApproverSetting() {
+  const res = await request.post({ url: `${SETTING_BASE}/get`, data: {} })
+  const data = unwrapData(res) || {}
+  return {
+    data: {
+      id: data.id,
+      approverIds: (data.approverIds || []).map(String),
+      status: data.status ?? '1',
+      updateTime: data.updateTime
+    } as QuoteApproverSettingVO
+  }
+}
+
+export function saveQuoteApproverSetting(data: QuoteApproverSettingForm) {
+  return request.post({
+    url: `${SETTING_BASE}/save`,
+    data: {
+      approverIds: (data.approverIds || []).map(String),
+      status: data.status
+    }
+  })
+}
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add web-admin/src/api/crm/quote/types.ts web-admin/src/api/crm/quote/index.ts
+git commit -m "$(cat <<'EOF'
+feat(web-admin): add quote approver setting API client
+
+EOF
+)"
+```
+
+---
+
+### Task 6: 设置页 + 路由
+
+**Files:**
+- Create: `web-admin/src/views/crm/quote/approver-setting/index.vue`
+- Modify: `web-admin/src/router/modules/sqxp.ts`（在 `CrmQuote` 路由后插入）
+
+- [ ] **Step 1: 路由**
+
+```ts
+{
+  id: 'CRM3000000000000000000000000015',
+  name: 'CrmQuoteApproverSetting',
+  path: 'quote-approver-setting',
+  component: '/crm/quote/approver-setting/index',
+  meta: {
+    title: '报价单审批人设置',
+    keepAlive: true,
+    menuCode: 'crm:quote:approverSetting'
+  }
+},
+```
+
+- [ ] **Step 2: 页面骨架（对齐 Demo / Fresh Mint）**
+
+要点：
+
+- `page-container` → `section.panel` → `panel-top` + `h2.title-bar-heading`「报价单审批人设置」
+- `el-form`：`label-position="top"`，`form-grid-2`
+- 字段：
+  - 默认审批人：`el-select` multiple（复用报价页 `fetchUserOptions` / 同款 label 格式）
+  - 状态：`el-radio-group` 启用 `0` / 停用 `1`
+- 底栏：重置 + 保存（`el-icon` Close/RefreshLeft + Check；保存 `type="primary"`）
+- `onMounted` 调 `getQuoteApproverSetting` 回填；保存调 `saveQuoteApproverSetting`
+- 审批人允许空数组保存（清空后不再预填）
+
+参考结构（精简）：
+
+```vue
+<template>
+  <div class="page-container">
+    <section class="panel">
+      <div class="panel-top">
+        <h2 class="title-bar-heading">报价单审批人设置</h2>
+      </div>
+      <div class="panel-body" style="padding: 16px 20px 24px">
+        <el-form ref="formRef" :model="form" label-position="top" class="crm-dialog-form">
+          <div class="form-grid-2">
+            <el-form-item class="form-col-span-2">
+              <template #label>
+                默认审批人<span class="form-label-tip">支持多人，按选择顺序依次审批</span>
+              </template>
+              <el-select v-model="form.approverIds" multiple filterable placeholder="请选择审批人" style="width: 100%">
+                <el-option
+                  v-for="user in userList"
+                  :key="user.userId"
+                  :label="formatApproverOptionLabel(user)"
+                  :value="user.userId"
+                />
+              </el-select>
+            </el-form-item>
+            <el-form-item label="状态">
+              <el-radio-group v-model="form.status">
+                <el-radio value="0">启用</el-radio>
+                <el-radio value="1">停用</el-radio>
+              </el-radio-group>
+            </el-form-item>
+          </div>
+        </el-form>
+        <div style="display:flex;justify-content:flex-end;gap:8px;margin-top:16px">
+          <el-button @click="loadSetting"><el-icon><RefreshLeft /></el-icon>重置</el-button>
+          <el-button type="primary" :loading="saving" @click="handleSave">
+            <el-icon><Check /></el-icon>保存设置
+          </el-button>
+        </div>
+      </div>
+    </section>
+  </div>
+</template>
+```
+
+（`el-radio` 的 `value`/`label` 写法与项目 Element Plus 版本保持一致。）
+
+- [ ] **Step 3: 本地验证**
+
+打开 `/#/crm/quote-approver-setting`（需菜单权限）→ 选人保存 → 刷新仍在。
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add web-admin/src/views/crm/quote/approver-setting/index.vue web-admin/src/router/modules/sqxp.ts
+git commit -m "$(cat <<'EOF'
+feat(web-admin): add quote approver setting page and route
+
+EOF
+)"
+```
+
+---
+
+### Task 7: 提交审批弹窗预填
+
+**Files:**
+- Modify: `web-admin/src/views/crm/quote/index.vue`
+- Modify: `web-admin/src/views/crm/quote/components/QuoteFormPanel.vue`
+- Modify: `web-admin/src/views/crm/quote/components/ApproverSelector.vue`（若 `open` 仍被使用）
+
+- [ ] **Step 1: 抽共用预填逻辑（可内联，避免过度抽象）**
+
+在打开提交弹窗处（`handleSubmit` / 表单内提交）：
+
+```ts
+import { getQuoteApproverSetting } from '@/api/crm/quote'
+// 若后端 helpers 不在前端，前端等价：
+async function resolvePrefillApproverIds(userList: { userId: string | number }[]) {
+  try {
+    const { data } = await getQuoteApproverSetting()
+    if (!data || String(data.status) !== '0') return [] as string[]
+    const valid = new Set(userList.map((u) => String(u.userId)))
+    return (data.approverIds || []).map(String).filter((id) => valid.has(id))
+  } catch {
+    return []
+  }
+}
+```
+
+- [ ] **Step 2: `index.vue` 的 `handleSubmit` / 详情内提交**
+
+在 `loadUserList()` 之后：
+
+```ts
+const prefillIds = await resolvePrefillApproverIds(userList.value)
+submitForm.value = {
+  id,
+  approverIds: prefillIds,
+  remark: ''
+}
+submitPrefillTip.value = prefillIds.length > 0
+submitDialog.visible = true
+```
+
+模板中审批人表单项上方（有预填时）：
+
+```vue
+<el-alert
+  v-if="submitPrefillTip"
+  type="success"
+  :closable="false"
+  show-icon
+  title="已按「报价单审批人设置」预填审批人，可修改后提交"
+  style="margin-bottom: 12px"
+/>
+```
+
+- [ ] **Step 3: `QuoteFormPanel.vue` 同样改造**打开提交对话框的逻辑。
+
+- [ ] **Step 4: `ApproverSelector.vue`**
+
+在 `open()` 内 `loadUsers` 后预填 `form.approverIds`（类型与选项 `userId` 一致；若当前是 `number[]`，统一为 `string[]` 更稳妥）。
+
+- [ ] **Step 5: 手工验收**
+
+1. 设置页启用并保存张经理→李总  
+2. 报价列表提交审批：弹窗已预填，提示出现  
+3. 改人后提交成功  
+4. 设置停用或清空：弹窗为空，须手选  
+5. 断网/接口失败：弹窗仍可打开，审批人为空  
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add web-admin/src/views/crm/quote/index.vue \
+  web-admin/src/views/crm/quote/components/QuoteFormPanel.vue \
+  web-admin/src/views/crm/quote/components/ApproverSelector.vue
+git commit -m "$(cat <<'EOF'
+feat(web-admin): prefill quote submit approvers from tenant setting
+
+EOF
+)"
+```
+
+---
+
+### Task 8: 收尾
+
+**Files:**
+- Modify: `docs/superpowers/specs/2026-08-01-quote-approver-setting-design.md`（状态改为「已实现」）
+- Optional: `docs/web-admin-ui-pattern-index.md` 追加一行业务页对照（报价审批人设置 → 配置表单）
+- Run: `./scripts/update-graph.sh backend` 与 `./scripts/update-graph.sh frontend`（或 `all`），若本会话改了代码
+
+- [ ] **Step 1: 更新设计文档状态**
+
+将 **状态：** 改为 `已实现`。
+
+- [ ] **Step 2: 回归 pytest + 关键页面**
+
+```bash
+cd backend && source venv/bin/activate && pytest tests/test_quote_approver_setting.py -v
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add docs/superpowers/specs/2026-08-01-quote-approver-setting-design.md docs/web-admin-ui-pattern-index.md
+git commit -m "$(cat <<'EOF'
+docs: mark quote approver setting design implemented
+
+EOF
+)"
+```
+
+---
+
+## Spec coverage checklist
+
+| Spec 项 | Task |
+|---------|------|
+| 租户级设置表 | Task 2–3 |
+| GET/PUT（实现为 POST get/save） | Task 4 |
+| 提交可改预填 | Task 7 |
+| 菜单权限维护 | Task 2 + 4 save 守卫 |
+| 未配置=手选 | Task 4 空响应 + Task 7 |
+| 不做默认备注 | 全任务未引入 |
+| 无效用户过滤/校验 | Task 3 save + Task 7 prefill |
+| 验收标准 1–5 | Task 7 Step 5 |
+
+## Self-review notes
+
+- API 与设计文档的 GET/PUT 字面差异：本计划按 CRM 既有 **POST** 风格落地，语义等价。
+- 租户单条有效配置靠 `save_setting` upsert，不加部分唯一索引（MySQL 5.7）。
+- 前端不强制单测文件（与仓库现状一致）；后端用 helpers 单测锁预填语义。

docs/superpowers/specs/2026-08-01-portal-mega-menu-design.md

@@ -0,0 +1,37 @@
+# 门户顶栏大面板菜单（方案 A）
+
+## 目标
+
+将 web-admin 门户布局从「顶栏一级下拉 + 左侧二/三级树」改为「顶栏横排一级 + 点击展开大面板」，取消左侧常驻菜单，内容区全宽。
+
+## 交互
+
+1. 顶栏横排展示全部一级模块。
+2. 点击一级展开大面板；再点同一级或遮罩关闭。
+3. 面板内左右两栏，二级行左右均分（如 12→6+6）；建议每栏可见约 5 行，超出后面板整体纵向滚动。
+4. 每行：左侧二级标题（不可点）+ 右侧三级文字链（可点）。
+5. 二级无子节点且自身可导航时：生成与二级同名的虚拟三级，路由继承该二级。
+6. 点击三级跳转并关闭面板。
+
+## 范围
+
+- 仅 `MenuTypeEnum.PORTAL` 布局。
+- 不改后端菜单数据模型；虚拟三级仅在前端展示层生成。
+
+## 非目标
+
+- 方案 B（5 列网格）本期不落地。
+- 面板内搜索可后续增强。
+
+## 面板宽度（一级较少时）
+
+权限导致一级模块仅 2～4 个时，一级横排区域会变窄。大面板宽度不得简单等于一级区域宽度。
+
+**策略（已确认）：最小宽度 + 相对一级居中**
+
+1. `width = max(一级区域宽度, min(720px, 视口宽度 − 32px))`
+2. 水平以一级区域中心为基准居中；左右各保留约 16px，避免贴边溢出
+3. 一级区域已 ≥ 720px 时，面板仍跟随一级区域宽度（与原先「同宽」一致）
+4. 纵向仍贴在一级栏下方；面板内部左右分栏布局不变
+
+参考 Demo：`docs/portal-mega-panel-width-demo.html`

docs/superpowers/specs/2026-08-01-quote-approver-setting-design.md

@@ -65,8 +65,8 @@
 
 | 方法 | 路径（示意） | 说明 |
 |------|----------------|------|
-| GET | `/api/web/admin/crm/quote-approver-setting` | 返回当前租户配置；无记录返回空对象/`null`（前端当未配置） |
-| PUT | `/api/web/admin/crm/quote-approver-setting` | Body：`{ approverIds: string[], status: '0'\|'1' }`；有则更新、无则创建 |
+| POST | `/api/web/.../crm/quote-approver-setting/get` | 返回当前租户配置；无记录返回 `{ approverIds: [], status: '0' }`（空列表不预填；默认启用避免设置页首次落到停用） |
+| POST | `/api/web/.../crm/quote-approver-setting/save` | Body：`{ approverIds: string[], status: '0'\|'1' }`；有则更新、无则创建 |
 
 约束：