docs: standardize echarts chart architecture

docs/ui-architecture.md

@@ -46,10 +46,10 @@
 
 已移除活动源码中的 `src/catalyst-ui-kit`、Headless UI ApplicationSwitcher、旧 `FormSelect` DOM API、旧 Table 兼容解析和页容量 Select。业务列表与只读 Excel 导入预览均使用 HeroUI Pro DataGrid。
 
-Native HeroUI 静态架构门禁已通过：`src/xinyuan-portable.css` 与 ECharts 已移除，页面目录无私有 CSS/Less/SCSS；仅保留与确认基准逐字节一致的共享样式层。HeroUI 与 HeroUI Pro 的样式分别通过 `@heroui/styles/css` 和 `@heroui-pro/react/css` 显式加载；包根 `@heroui/styles` 是 JavaScript 样式工具入口，不能替代 CSS 入口。2026-08-26 已完成四视口、深浅主题、权限、通知和文件事务的运行态浏览器门禁。
+Native HeroUI 静态架构门禁已通过：`src/xinyuan-portable.css` 已移除，业务图表统一保留并使用 ECharts 适配器，页面目录无私有 CSS/Less/SCSS；仅保留与确认基准逐字节一致的共享样式层。HeroUI 与 HeroUI Pro 的样式分别通过 `@heroui/styles/css` 和 `@heroui-pro/react/css` 显式加载；包根 `@heroui/styles` 是 JavaScript 样式工具入口，不能替代 CSS 入口。2026-08-26 已完成四视口、深浅主题、权限、通知和文件事务的运行态浏览器门禁。
 # 共享 UI 架构补充
 
-`XinyuanEChart` 是图表唯一渲染适配器，页面仅提供业务数据和 ECharts option；适配器统一主题、Tooltip、坐标轴和 Pie 扇区样式。相同分类维度的多个数据项使用 `createResolvedXinyuanChartColorMap` 和 `XINYUAN_CHART_CATEGORY_PALETTE` 按稳定顺序分配颜色，标准顺序为红 → 粉 → 橙 → 黄 → 蓝 → 紫 → 青 → 中性灰；单一指标或多指标系列使用与“审计项目管理”一致的 `XINYUAN_CHART_SEMANTIC` 语义色，页面不得写入硬编码颜色，单一指标不得按柱子拆成多色。年度分布单系列柱图显示顶部真实数值，使用紧凑柱宽和规范圆角，单年份数据保持平衡。`XinyuanModal` 统一使用 `bg-background` Dialog Surface。列表分页由 `DataTablePagination` 统一承载容量选择器与页码状态：容量使用 HeroUI Autocomplete 受控单选，标准选项为 `20 / 50 / 100 条/页`、默认值必须属于选项集合，固定少量选项时关闭 `showSearch` 与 `isClearable`，切换容量回到第 1 页。
+`XinyuanEChart` 是图表唯一渲染适配器，页面仅提供业务数据和 ECharts option；适配器统一主题、Tooltip、坐标轴和 Pie 扇区样式。相同分类维度的多个数据项使用 `createResolvedXinyuanChartColorMap` 和 `XINYUAN_CHART_CATEGORY_PALETTE` 按稳定顺序分配颜色，标准顺序为红 → 粉 → 橙 → 黄 → 蓝 → 紫 → 青 → 中性灰；单一指标或多指标系列使用与“审计项目管理”一致的 `XINYUAN_CHART_SEMANTIC` 语义色，页面不得写入硬编码颜色，单一指标不得按柱子拆成多色。年度分布单系列柱图显示顶部真实数值，使用紧凑柱宽和规范圆角，单年份数据保持平衡。业务源码禁止直接导入 Recharts 或 HeroUI Pro 图表组件；`recharts` 依赖仅因当前 HeroUI Pro `KPI` 包的静态运行时解析而保留，不作为应用图表渲染器。`XinyuanModal` 统一使用 `bg-background` Dialog Surface。列表分页由 `DataTablePagination` 统一承载容量选择器与页码状态：容量使用 HeroUI Autocomplete 受控单选，标准选项为 `20 / 50 / 100 条/页`、默认值必须属于选项集合，固定少量选项时关闭 `showSearch` 与 `isClearable`，切换容量回到第 1 页。
 
 驾驶舱模块标题沿用“审计项目管理”基准的 HeroUI `Card.Header` 左对齐横向结构；`Card.Title` 使用共享 `.rc-module-title`（16px/600、24px 行高、主题前景色）与 `min-w-0 flex-1 text-left`，操作或描述信息放在标题右侧，不通过页面私有 CSS 改写字号、颜色或字重。
 

docs/ui-migration-checklist.md

@@ -15,7 +15,7 @@
 - [x] Login：迁移 HeroUI 原生控件、验证码、filled/autofill 和响应式结构
 - [x] Shell：迁移品牌、offcanvas、用户菜单、主题和 base-aware 导航
 - [x] 应用切换：同步 `model_analysis` HeroUI Modal、`site.group` 动态分组、真实数量、“其他应用”/“全部应用”回退和 36px identity well
-- [x] 驾驶舱：移除 ECharts/手写 KPI，改用 HeroUI Pro KPI、PieChart、BarChart、ComposedChart、ChartTooltip
+- [x] 驾驶舱：KPI 使用 HeroUI Pro KPI compound API，所有业务图表统一通过共享 `XinyuanEChart`（ECharts）适配器渲染
 - [x] 党风廉政 Tabs、结构化筛选与透明工具栏 SearchField；无刷新/查询按钮并保持自动筛选
 - [x] 党风廉政 DataGrid、选择、ActionBar、20/50/100 页容量 Pagination；默认 20，切换后回到第 1 页且无清除图标/搜索框
 - [x] 新建/编辑、导入、批量修改、删除确认 Modal

docs/xinyuan-ui-audit.md

@@ -58,10 +58,10 @@
 - Catalyst、Headless UI、旧 Select/Table 兼容层与多余 pnpm lockfile 已从活动源码移除。
 - Login、Shell、党风廉政筛选/DataGrid/Modal/DropZone 已完成原生 HeroUI/HeroUI Pro 结构迁移。应用切换进一步同步 `model_analysis` 当前基准：保留 `/application/info` 与用户权限合并，读取 `/info -> site.group` 动态分组，显示真实组数并处理“其他应用”/“全部应用”回退。
 - 党风廉政筛选对齐问题整改基线：Surface 内前三项等宽排列，溢出条件通过 Disclosure 展开；移除刷新和查询按钮，字段变化后自动请求，关键词采用约 300ms 延迟。
-- 驾驶舱已移除 ECharts，KPI 使用 HeroUI Pro `KPI` compound API，图表使用 Pro `PieChart`、`BarChart`、`ComposedChart` 与 `ChartTooltipContent`。
+- 驾驶舱 KPI 使用 HeroUI Pro `KPI` compound API；所有业务图表统一使用共享 `XinyuanEChart`（底层 `echarts-for-react`/ECharts）适配器，页面只提供业务数据和 ECharts option。
 - `src/xinyuan-portable.css` 已删除；页面目录不存在私有 CSS/Less/SCSS。`theme.css` 与 Skill 权威副本一致，`tokens.css`、`shell.css`、`tailwind.css`、`global.less` 与确认基准逐字节一致。
 - 广义关键词已移到透明列表工具栏的 HeroUI `SearchField`，结构化筛选 Surface 仅保留年份和分类关键字段。
-- 2026-08-19 最终静态门禁：`npm run build`、`git diff --check`、鑫元审计脚本均成功；旧组件、ECharts、页面私有视觉类、跨项目依赖、本机路径和授权值均无有效源码命中。
+- 2026-08-19 最终静态门禁：`npm run build`、`git diff --check`、鑫元审计脚本均成功；旧组件、非 ECharts 图表库调用、页面私有视觉类、跨项目依赖、本机路径和授权值均无有效源码命中。
 - HeroUI Pro 的 CSS、入口文件和 sidebar/navbar/data-grid/drop-zone/action-bar/empty-state ESM 导入均可用。
 - 依赖树的应用与 Pro 主路径统一使用 HeroUI 3.2.2 / React Aria Components 1.19.0；Adobe Spectrum 的间接依赖仍包含 React Aria Components 1.20.0，不进入应用直接组件边界。
 - 2026-08-26 修改前开发服务以 `npm run dev` 启动于 `http://localhost:8003/incorrupt_party_build/`，base/publicPath 为 `/incorrupt_party_build/`；未登录状态跳转 `/login?redirect=%2F`，控制台无错误或警告。应用切换改动后的四视口、深浅主题和打开态结果记录在迁移清单中。