change

design-qa.md

@@ -0,0 +1,40 @@
+# 福利项目分组配置设计验收
+
+- Source visual truth: `C:\Users\mayn\AppData\Local\Temp\codex-clipboard-73344a5b-ced8-4cca-952c-84eb3ad96fdd.png`、`C:\Users\mayn\AppData\Local\Temp\codex-clipboard-673ddf31-6705-49b0-8342-51f1f46c92da.png`
+- Implementation screenshots: `F:\coding\zhgh_zjvtit_v4\target\codex-preview\welfare-group-initial.png`、`F:\coding\zhgh_zjvtit_v4\target\codex-preview\welfare-group-dialog-v2.png`
+- Comparison images: `F:\coding\zhgh_zjvtit_v4\target\codex-preview\compare-initial.png`、`F:\coding\zhgh_zjvtit_v4\target\codex-preview\compare-dialog-v2.png`
+- Viewport: 1912 × 956 CSS px，device scale factor 1
+- Source pixels: overall page 1737 × 906；dialog 1912 × 956
+- Implementation pixels: overall component 1912 × 956；dialog 1912 × 956
+- Density normalization: dialog uses equal pixel dimensions; overall page comparison focuses on the welfare-option region because the local harness intentionally excludes unrelated project form fields.
+- State: group-required switch enabled; three welfare options, group values `1`、`1`、empty; configuration dialog open with one deduplicated group.
+
+## Findings
+
+- No remaining P0/P1/P2 visual mismatch in the requested welfare-option and group-configuration regions.
+- Fonts and typography: implementation inherits the project Element UI and Microsoft YaHei/Helvetica font stack; headings, table labels, input text and button weights align with the reference hierarchy.
+- Spacing and layout rhythm: toolbar is right-aligned, the group column sits beside the welfare name, and the dialog uses the reference-like 52% width and 560 px minimum height with the footer anchored at the bottom.
+- Colors and visual tokens: implementation uses the existing project primary, border, muted text, overlay and danger tokens rather than introducing new colors.
+- Image quality and assets: no new raster assets are required; upload and action icons use the existing Element UI icon font.
+- Copy and content: `分组必选`、`配置分组选择数量`、`分组数据`、`最少选择数量`、`最多选择数量` and footer actions match the supplied reference.
+
+## Interaction Evidence
+
+- Switch on: configuration button visible.
+- Switch off: configuration button hidden.
+- Switch on again: configuration button restored.
+- Group extraction: duplicate group `1` is shown once and the empty group is filtered out.
+- Defaults: minimum is `1`, maximum is `0`.
+- Console: no browser errors were recorded.
+
+## Comparison History
+
+1. Initial dialog capture found a P2 height mismatch: the dialog collapsed to its table content instead of matching the tall reference dialog.
+2. Added a dedicated dialog class with a 560 px minimum height and flex body layout.
+3. The second capture matches the reference dialog proportions and keeps the footer at the bottom; no actionable P0/P1/P2 issue remains.
+
+## Follow-up Polish
+
+- None required for the requested scope.
+
+final result: passed

src/main/resources/db/welfare_project_add_group_selection_config.sql

@@ -0,0 +1,11 @@
+-- 福利项目增加分组必选开关，默认关闭以兼容历史项目。
+ALTER TABLE `welfare_project`
+  ADD COLUMN `groupRequired` tinyint(1) NOT NULL DEFAULT 0 COMMENT '是否启用分组必选';
+
+-- 福利选项增加分组名称；空值选项不参与分组选择数量配置。
+ALTER TABLE `welfare_project_subject_option`
+  ADD COLUMN `groupName` varchar(50) DEFAULT NULL COMMENT '分组名称';
+
+-- 分组配置以 JSON 数组形式存放在现有福利项目题目表中，不新建业务表。
+ALTER TABLE `welfare_project_subject`
+  ADD COLUMN `groupSelectionConfigs` json DEFAULT NULL COMMENT '分组选择数量配置';