feat(web): 定制项目页与搜索/表单交互统一(审计 C1/C2/C7 + A4)

- 定制项目三个 tab 卡头统一:本周进展加卡头(标题+条数+本期标签)、年度任务卡头加标题;
  renderCustomWeekly/renderCustomAnnual 删掉从未使用的 hdr 形参与传参。
- 项目总览卡头新增「含归档项目」开关(customArchived=false|all,与自研产品同款交互),
  切换回第 1 页;UI_FIELDS 已含 customArchived,刷新后保持。
- 关键字搜索统一为一个行为:bindKeyword 删掉 enter:true 分支——所有页内搜索框与顶栏
  全局搜索同款 320ms 防抖实时查询(此前项目/定制页内要回车、顶栏不回车,同一列表两套口径)。
- 抽屉表单报错统一:新增 formError(id, msg) 助手,fdErr/cdErr/dwErr 三处重复的
  textContent+display 六行收敛成一行;顺带修复 fdSave 校验缺「预计完成时间」时
  保存按钮被提前禁用后不再恢复的卡死 bug(校验全部前置)。
- README 设计语言章节补:反馈矩阵 / 按钮文案 / 搜索防抖 / 归档过滤 四条统一规范;
  图标条目同步(48 个、删掉的 names() 与 .kcol-title 说明)。
- node --check 通过
main
mula.liu 2026-11-04 01:26:07 +08:00
parent cf0f3a121e
commit 271104620c
2 changed files with 46 additions and 47 deletions

View File

@ -406,13 +406,16 @@ python scripts/legacy/add_entry_date.py --force # 全部重算
- **重点色只出现在三处**:图标、关键数字/文本、小面积 tinted 底板(`.ic-badge`、`.tag-mini`、`.kpi.accent-*`)。状态色(`statusMeta`)与阶段色(`stageMeta`)是唯一配色来源,避免各页面自己调色。
- **图标系统**:`web/icons.js` 内置 48 个 24×24 线性 SVG(每个都被界面或状态/阶段/标题映射引用,死图标随手删),`stroke=currentColor`,颜色跟着文字走。对外 API:
`svg(name)` 裸图标;`badge(name)` 图标 + tinted 底板(KPI 用);`status()` / `stage()` / `pipe()` 按状态·阶段·交付环节取图标;
`nameOfStatus()` / `nameOfStage()` / `statusBadge()` 出文案与徽标;`hydrate()` 填 `[data-icon]`;`auto()` 自动补前导图标;`names()` 列全部图标名。
- **自动图标**:`auto()` + `MutationObserver` 在每次渲染后按标题关键词给 `.card-head h4` / `.sec-title` / `.kcol-title` / `.wk-group-head` / `.notice` / `.empty` 加前导图标,并填充 `[data-icon]`;用 `data-ico` 属性防重复,标题里**自带** `<svg class="ic">`(如阶段看板按阶段取图标)时跳过自动补图,不会出现两个图标。新增区块只要标题里带对应关键词就自动带图标,不用手写。
- **阶段看板列头不带色条**:列头用 `Ico.stage(code)` + `--c` 注入阶段色(`.kcol-title .ic { color: var(--c) }`),早期那种 `border-top:3px solid 阶段色` 的彩条已去掉。
`nameOfStatus()` / `nameOfStage()` / `statusBadge()` 出文案与徽标;`hydrate()` 填 `[data-icon]`;`auto()` 自动补前导图标。
- **自动图标**:`auto()` + `MutationObserver` 在每次渲染后按标题关键词给 `.card-head h4` / `.sec-title` / `.wk-group-head` / `.notice` / `.empty` 加前导图标,并填充 `[data-icon]`;用 `data-ico` 属性防重复,标题里**自带** `<svg class="ic">`(如阶段看板按阶段取图标)时跳过自动补图,不会出现两个图标。新增区块只要标题里带对应关键词就自动带图标,不用手写。
- **交付环节图标按 `code` 取**:后端 `CUSTOM_PIPELINE` 下发的字段是 **`code`**(不是 `key`),前端一律 `Ico.pipe(s.code)`;写成 `s.key` 会静默退化成通用圆点。
- **表格防竖排**:`table.tbl th` / `.pill` / `.tag-mini` 统一 `white-space:nowrap`,容易挤窄的列(区域、负责人)在 `<td>` 上加 `class="nowrap"`;实在挤不下交给 `.tbl-wrap { overflow:auto }` 横向滚动。
- **抽屉不被内容撑破**:`.form-row > div { min-width: 0 }`(grid 子项默认 `min-width:auto`,会被交付环节步骤条撑出整表横向滚动),步骤条本身 `flex:1 1 132px`(132px = 日期输入框含日历图标的最小可用宽度)。
- **报错一律中文**:Pydantic 422 与未捕获 500 在 `app/main.py` 的 exception handler 统一换成中文 `detail`(「提交的数据有误:…」/「服务器内部错误…」),前端 `api()` 原样 toast,界面不中英夹杂。新增 `/export/*` 必须登记 `security.EXPORT_MENU` 权限归属,未登记一律 403(fail-closed,防「忘挂权限 = 登录即可下载」)。
- **反馈矩阵(只有这三条通道)**:弹窗内报错 → `modalError()`(`#mErr` 行内提示);抽屉表单报错 → `formError("fdErr|cdErr|dwErr", msg)`(行内提示,传空串清除);其余一律 `toast()`;破坏性动作只走 `confirmDialog()`。异步写处理器先本地 try/catch 提示并**中断后续刷新/重开**,全局 `unhandledrejection` 兜底只兜漏网之鱼。
- **弹窗主按钮文案**:新建=`创建`、编辑=`保存`、动作确认=`确认+动词`(确认下线 / 确认清空);提交即 `disabled` 防重复提交,失败恢复。危险动作的触发按钮用 `.btn.danger` / `.icon-btn.danger`,配套 `confirmDialog({danger:true})`。
- **关键字搜索全应用一个行为**:页内搜索框(`bindKeyword`)与顶栏全局搜索同为 **320ms 防抖实时查询**,共用 `state.keyword`,不再区分回车/实时两套。列表卡头「共 N 条」一律取**过滤后**条数,与分页器一致。
- **归档过滤统一**:自研产品 / 重点工作 / 定制项目用「含归档」`switch` 开关(`state.showArchived` / `focusArchived` / `customArchived`=`false|all`),人员花名册用三态下拉(在用 / 已归档 / 全部,导出跟随同一状态)。
> 备注:历史遗留的 `.pcard`、`.board-grid`、`.svg-chart`、`.legend`、`.risk-item` 等零引用样式已随死代码清理删除(2026-10-29)。

View File

@ -481,11 +481,9 @@
return `<input id="${id}" class="search" type="search" placeholder="${esc(placeholder)}" value="${esc(state.keyword)}" style="width:${width}px;height:30px" />`;
}
/** 绑定页内搜索。
默认:防抖实时搜索;opts.enter=true 时只在「回车 / 清空(×)」后才查询。
/** 绑定页内搜索:与顶栏全局搜索完全同款——320ms 防抖实时查询,共用 state.keyword。
重绘后把光标放回搜索框,连续操作不中断。 */
function bindKeyword(id, opts) {
opts = opts || {};
function bindKeyword(id) {
const el = $("#" + id);
if (!el) return;
const apply = (v) => {
@ -496,21 +494,12 @@
$("#globalSearch").value = v;
refresh();
};
if (opts.enter) {
// 输入阶段不查询;回车提交后才检索
el.addEventListener("keydown", (e) => {
if (e.key === "Enter") { e.preventDefault(); apply(el.value); }
});
// type=search 的清除「×」会触发 search 事件
el.addEventListener("search", () => apply(el.value));
} else {
let t = null;
el.addEventListener("input", (e) => {
clearTimeout(t);
const v = e.target.value.trim();
t = setTimeout(() => apply(v), 320);
});
}
let t = null;
el.addEventListener("input", () => {
clearTimeout(t);
const v = el.value.trim();
t = setTimeout(() => apply(v), 320);
});
if (keywordFocus) {
keywordFocus = false;
el.focus();
@ -546,6 +535,14 @@
e.style.display = msg ? "" : "none";
}
/** 抽屉表单里的行内报错(#fdErr / #cdErr / #dwErr):给文案显示,给空串清除 */
function formError(id, msg) {
const e = $("#" + id);
if (!e) return;
e.textContent = msg || "";
e.style.display = msg ? "" : "none";
}
/** 需要用户明确点确认才继续;requireText 时还必须逐字输入该文本 */
function confirmDialog(o) {
return new Promise((resolve) => {
@ -1585,13 +1582,12 @@
on("#fdCancel", () => (mode === "create" ? closeDrawer() : openFocusDrawer(fid, "view")));
on("#fdSave", async () => {
const btn = $("#fdSave");
const err = $("#fdErr");
const content = $("#fdContent").value.trim();
if (!content) { err.textContent = "请填写工作内容"; err.style.display = ""; return; }
btn.disabled = true;
err.style.display = "none";
if (!content) return formError("fdErr", "请填写工作内容");
const due = $("#fdDue").value;
if (!due) { err.textContent = "请选择预计完成时间"; err.style.display = ""; return; }
if (!due) return formError("fdErr", "请选择预计完成时间");
btn.disabled = true;
formError("fdErr", "");
const body = {
content: content,
detail: $("#fdDetail").value,
@ -1606,8 +1602,7 @@
else await patch("/focus/" + fid, body);
} catch (e) {
btn.disabled = false;
err.textContent = "保存失败:" + e.message;
err.style.display = "";
formError("fdErr", "保存失败:" + e.message);
return;
}
toast(mode === "create" ? "已添加「" + content + "」" : "已保存");
@ -1726,7 +1721,7 @@
host.innerHTML = body;
bindKeyword("pKeyword", { enter: true });
bindKeyword("pKeyword");
bindPager(host, renderProjects);
const pc = $("#pCat");
if (pc) pc.addEventListener("change", () => {
@ -1950,8 +1945,8 @@
};
host.innerHTML = tabs + (
state.customTab === "weekly" ? renderCustomWeekly(allRows, head)
: state.customTab === "annual" ? renderCustomAnnual(head)
state.customTab === "weekly" ? renderCustomWeekly(allRows)
: state.customTab === "annual" ? renderCustomAnnual()
: renderCustomList(allRows, head));
host.querySelectorAll("[data-ctab]").forEach((b) =>
@ -1968,7 +1963,13 @@
if (st) st.addEventListener("change", () => { state.customStatus = st.value; renderCustom(); });
const rk = $("#cRisk");
if (rk) rk.addEventListener("change", () => { state.customRisk = rk.value; renderCustom(); });
if (isList) bindKeyword("cKeyword", { enter: true });
if (isList) bindKeyword("cKeyword");
const ca = $("#csArchived");
if (ca) ca.addEventListener("change", () => {
state.customArchived = ca.checked ? "all" : "false";
state.pager.custom = 1;
renderCustom();
});
const bn = $("#btnNewCustom");
if (bn) bn.addEventListener("click", () => openNewCustomDialog(() => afterWrite()));
const bex = $("#btnExportCustom");
@ -2029,7 +2030,7 @@
? `<span class="tag-mini" style="background:#fff4e0;color:#b45309">${dirty.join(" · ")}</span>` : "";
return `<div class="card">
${cardHead({ tools: hdr.tools + dirtyTag })}
${cardHead({ fields: `<label class="switch"><input type="checkbox" id="csArchived" ${state.customArchived === "all" ? "checked" : ""} /> 含归档项目</label>`, tools: hdr.tools + dirtyTag })}
${statBar}
${view.length ? customTableHtml(pageRows) : `<div class="empty">${state.keyword ? "没有匹配「" + esc(state.keyword) + "」的定制项目" : "当前筛选条件下没有定制项目"}</div>`}
${pagerBar("custom", view.length)}
@ -2122,8 +2123,7 @@
}
/** 本周进展:更新时间落在「顶栏选中周期」内的项目;并按 验收/下单/提前交付/进行中 分类统计 */
function renderCustomWeekly(allRows, hdr) {
hdr = hdr || {};
function renderCustomWeekly(allRows) {
const sc = scopeRange();
if (!sc) return `<div class="empty">没有取到当前周期的起止日期</div>`;
const start = sc.start, end = sc.end;
@ -2148,6 +2148,7 @@
`;
return `<div class="card">
${cardHead({ title: "本期更新的定制项目", count: rows.length, fields: `<span class="tag-mini">${esc(sc.label || "")}</span>` })}
${statBar}
${rows.length
? customTableHtml(pagedRows(
@ -2160,8 +2161,7 @@
/** 年度任务:四季度的计收目标(万元,可在页面编辑)+ 后端回填的完成数据。
* 完成数据按「验收年度 + 验收季度」归集,跨年不会串;下单列按下单时间所在季度归集。 */
function renderCustomAnnual(hdr) {
hdr = hdr || {};
function renderCustomAnnual() {
const a = (state.finance || {}).annual || {};
const year = a.year || new Date().getFullYear();
const quarters = a.quarters || [];
@ -2196,7 +2196,7 @@
<td class="num">${toWan(u.sign_amount)}</td>
</tr>`;
return `<div class="card">
${cardHead({ tools: canW("custom") ? `<button class="btn sm primary" id="atSave">${editing ? "保存" : "编辑"}</button>` : "" })}
${cardHead({ title: year + " 年度任务", tools: canW("custom") ? `<button class="btn sm primary" id="atSave">${editing ? "保存" : "编辑"}</button>` : "" })}
<div class="tbl-wrap">
<table class="tbl">
<thead><tr>
@ -2567,9 +2567,8 @@
on("#cdCancel", () => openCustomDrawer(cid, "view"));
on("#cdSave", async () => {
const btn = $("#cdSave");
const err = $("#cdErr");
btn.disabled = true;
err.style.display = "none";
formError("cdErr", "");
try {
await patch("/custom/projects/" + cid, {
name: $("#cdName").value.trim(),
@ -2591,8 +2590,7 @@
});
} catch (e) {
btn.disabled = false;
err.textContent = "保存失败:" + e.message;
err.style.display = "";
formError("cdErr", "保存失败:" + e.message);
return;
}
toast("已保存");
@ -3310,9 +3308,8 @@
on("#dwCancel", () => openDrawer(pid, "view"));
on("#dwSave", async () => {
const btn = $("#dwSave");
const err = $("#dwErr");
btn.disabled = true;
err.style.display = "none";
formError("dwErr", "");
try {
await patch("/projects/" + pid, {
name: $("#dwName").value.trim(),
@ -3325,8 +3322,7 @@
});
} catch (e) {
btn.disabled = false;
err.textContent = "保存失败:" + e.message;
err.style.display = "";
formError("dwErr", "保存失败:" + e.message);
return;
}
toast("已保存");