拼ui 一些业务逻辑x实现

2026-03-19 06:15:09 +08:00
parent f5c6f143c0
commit 49e45ac464
1118 changed files with 246518 additions and 5368 deletions
@@ -0,0 +1,172 @@
+# 更新计划（Roadmap / Update Plan）
+
+本章用于说明 EasyChart 后续整体更新方向与计划项。
+
+- 本文件**不按版本阶段拆分**（后续会在各类型章节中再做细化计划）
+- 本文件以“能力分类”组织：你可以把它当作路线图的目录
+
+## Free / Pro 版本划分（发布策略）
+
+### Free（独立包）
+
+- 定位：覆盖 AssetStore 最常见使用场景，做到“可配置 + 可预览 + 可运行时注入数据”的闭环。
+- 包含：现有基础 2D 图表类型、运行时注入（`ChartFeed` / `ApplyJson`）、`EasyChartLibraryWindow` 等编辑器工作流。
+
+### Pro（独立包，包含 Free 全量）
+
+- 定位：在 Free 的基础上提供明显的差异化能力与长期扩展路线。
+- 包含：Free 全量 + Pro 增量功能（高级效果 / 新图表类型 / 3D / 工具链等）。
+
+### 兼容策略
+
+- Free 遇到 Pro-only 资产/配置：允许直接报错（不做降级兼容）。
+
+### Pro 首批卖点优先级
+
+- A：新增图表类型
+- B：3D 图表
+- C：2D 高级视觉效果（如贴图UV动画、特效类渲染能力）
+
+---
+
+## 附录：版本计划（含时间，暂定）
+
+> 说明：以下为“按月/季度”的暂定节奏，具体日期可在确定团队人力与上架窗口后再收敛。
+
+### 2026 Q1（1-3 月）：稳定化 + Free 完整闭环
+
+- 2026-01（Free v1.0.x）：
+  - 修复/收尾：JSON Injection 面板与示例生成/解析的稳定性（按当前 TODO）
+  - 文档与示例：对齐最新数据结构与面板能力
+- 2026-02（Free v1.1.0）：
+  - 2D 体验增强（Free 范围）：Bar 圆角、hover 效果（如尚未实现则在此版本落地）
+  - 编辑器体验：LibraryWindow 常用 workflow 小优化（不引入 Pro 依赖）
+- 2026-03（Free v1.1.x）：
+  - 回归修复 + 性能/GC 优化（大数据量刷新、tooltip/交互稳定性）
+
+### 2026 Q2（4-6 月）：Pro v1.0（新图表类型优先）
+
+每个类型的Series都加一个动画组件集合，可以添加一些类型的动画例如Point的闪烁,TextureFill的UV动画这些，
+- 2026-04（Pro v1.0.0）：
+  - 完成 Pro 包结构与发布流程固化（Pro 包含 Free 全量）
+  - 新图表类型（第一批）：Gauge / Funnel（二选一或都做，按复杂度控制）
+- 2026-05（Pro v1.0.x）：
+  - 新图表类型（第二批）：BoxPlot / Candlestick（优先实现其中一个）
+  - Pro-only 报错提示与 Editor 侧可读错误信息完善
+- 2026-06（Free v1.2.0 + Pro v1.1.0）：
+  - Free：继续补齐 2D 常用能力与稳定性
+  - Pro：新图表类型扩展（Treemap / Sunburst 预研或首版）
+
+### 2026 H2（7-12 月）：3D 路线与特效能力
+
+- 2026 Q3（7-9 月）（Pro v2.0 或 v1.2+）：
+  - 3D 图表（第一批）：3D Bar / 3D Scatter（优先其中一个可用闭环）
+  - 3D 渲染管线与交互基础（按最小可用集拆分迭代）
+- 2026 Q4（10-12 月）：
+  - 3D Surface（预研/试验性）
+  - 2D 高级视觉效果（Pro）：贴图 UV 动画（以及后续更复杂特效能力）
+  - 工具链增强：Theme / 网络直连 / 自动化测试（择一作为质量提升主线）
+
+---
+
+## 1. 图表类型扩展计划（Chart Types）
+
+### 1.1 2D 图表（现有体系增强）
+
+- 目标：在不增加过多 `SerieType` 的前提下，用“settings/variant”补齐常用表达。
+- 候选方向（示例）：
+  - Line：更多线型/填充/标注能力（如更丰富的标记/阈值线等），贴图UV动画（Pro）
+  - Bar：更多堆叠模式、百分比堆叠、瀑布等模式化能力，Bar头部圆角（Free），hover效果（Free），贴图UV动画（Pro）
+  - Scatter：更多映射维度（size/color）、密度表达（如聚合/栅格化）
+  - Pie：更多布局与聚合策略、标签策略与交互
+
+### 1.2 新增图表类型（可能新增 `SerieType`）
+
+- 目标：支持 AssetStore 更常见的“独立图表品类”。
+- 候选方向（示例）：
+  - Gauge / 仪表盘（进度、刻度、阈值）
+  - Funnel / 漏斗图
+  - BoxPlot / 箱线图
+  - Candlestick / K 线（OHLC）
+  - Treemap / Sunburst（层级可视化）
+  - Sankey / Graph（更复杂的结构类图表，后置）
+
+### 1.3 3D 图表（3D Charts）
+
+- 目标：提供一套 3D 图表能力（可能是独立渲染管线）。
+- 候选方向（示例）：
+  - 3D Bar / 3D Column
+  - 3D Scatter
+  - 3D Surface（难度更高，后置）
+
+---
+
+## 2. 多轴与坐标系能力（Multi-Axis & Coordinate Systems）
+
+- 目标：在保持语义清晰的前提下，增强多轴场景。
+- 方向：
+  - 支持更多轴组合（双 Y 轴、顶/底 X 轴、左右 Y 轴的混搭）
+  - 更清晰的轴绑定策略（Serie 绑定到哪个轴、tooltip/label 使用哪个轴格式化）
+  - 坐标系切换/混用的约束与提示（避免用户配置混乱）
+
+---
+
+## 3. 字体与文本系统（Font & Text）
+
+- 目标：统一文本渲染的观感与可配置项，降低 UI Toolkit 不同平台的差异。
+- 方向：
+  - 更完整的文字样式（字体、字号、粗细、颜色、描边/阴影等）
+  - 文本布局策略（自动换行、截断、省略号、对齐与锚点）
+  - 数值格式化能力增强（千分位、单位、百分比、科学计数法等）
+
+---
+
+## 4. 时间轴与 Log 轴（Time Axis & Log Axis）
+
+- 目标：增强对“时间序列”和“数量级跨度很大”的数据表达能力。
+- 方向：
+  - 时间轴：时间刻度、格式化、间隔策略（天/周/月/年）
+  - Log 轴：log10/log2 等刻度与标签
+  - 与数据注入配合（如何喂时间数据、如何处理缺失点）
+
+---
+
+## 5. 主题系统（Theme / Palette）
+
+- 目标：把“配色/字体/默认样式”从单个 Profile 抽象成可复用主题。
+- 方向：
+  - Theme 资产（Palette + 字体 + 默认样式）
+  - Profile 与 Theme 的覆盖策略（主题默认 vs Profile 局部覆盖）
+  - 主题预览、主题切换、主题库
+
+---
+
+## 6. 网络接口直连（Direct Networking / Data Binding）
+
+- 目标：降低“从网络接口到图表”的接入成本。
+- 方向：
+  - 提供基于 `ChartFeed` 的标准输入协议
+  - 提供可选的 API Envelope 支持（如 `{code,message,data}`）
+  - 提供示例：HTTP 拉取 -> 解析 -> Apply
+  - 缓存、节流、错误提示与降级策略
+
+---
+
+## 7. 自动化测试与质量保障（Automated Tests & QA）
+
+- 目标：降低迭代风险，让重构更安全。
+- 方向：
+  - 数据结构迁移测试（序列化兼容性）
+  - 渲染回归测试（截图对比/像素容差，或关键顶点/mesh 断言）
+  - 交互测试（tooltip/hit test 的稳定性）
+  - 性能基准（大数据量刷新、GC、帧耗时）
+
+---
+
+## 8. 编辑器工作流与工具链（Editor Workflow & Tooling）
+
+- 目标：让配置、预览、注入与复用更顺手。
+- 方向：
+  - LibraryWindow：模板/复制/导入导出/批量处理
+  - JSON Injection：更强的协议兼容、错误定位、示例生成
+  - 更清晰的手册与示例工程