docs: brainstorm,brief and prd

This commit is contained in:
2025-10-15 23:40:13 +08:00
parent 28e620573c
commit 6b4c227d3c
15 changed files with 3423 additions and 0 deletions

View File

@@ -0,0 +1,27 @@
# Goals and Background Context
### Goals
- 在 1 个月内完成 MVP验证 PropertyGrid 和 UserGuide 的核心功能
- 建立基于 Semi Design 和苹果颜色系统的多主题框架,支持至少 2 种主题(浅色、暗色)和运行时切换
- 实现支持国际化扩展的架构MVP 阶段默认使用一种语言,预留语言切换扩展点
- 完成 PropertyGrid 控件支持常用属性类型string, int, double, bool, enum, DateTime实现自动 UI 生成、属性分组和基础验证
- 完成 UserGuide 系列控件,包括新手引导流程和增强 Tooltip提升用户体验
- 确保架构设计考虑未来 AOT 编译支持MVP 阶段允许使用反射
- 在开发过程中产出 5+ 个可复用的基础控件和工具类TwoColumnLayout、Overlay、RichTooltip、ThemeManager 等)
- 为后续控件开发LoggingControl、TextEditor 等)打下坚实基础
### Background Context
当前 Avalonia 生态主要聚焦于基础控件库Button、TextBox 等),但真正加速开发的是**业务场景集成控件**PropertyGrid、LoggingControl、UserGuide这些在上位机和 AI 桌面应用场景中尤为关键。开发者被迫在每个项目中重复实现相似的复合控件,平均花费 30-50% 的时间在这些重复工作上。此外,许多现有库为了兼容旧版本(.NET Framework、Avalonia 0.x牺牲了现代特性AOT 支持不完善。
本项目旨在填补这一空白,采用**自顶向下开发策略**:先定义业务控件需求,再从中分解必要的基础控件。我们专注于上位机和 AI 桌面应用场景,基于 .NET 8+、Avalonia 11.x、ReactiveUI 和 Semi Design 样式系统,打造一套现代化、高度场景化的业务控件库。与传统控件库追求极致通用性不同,我们允许合理的取舍,优先满足目标场景的核心需求,确保开发效率和技术栈的前瞻性。
### Change Log
| Date | Version | Description | Author |
|------------|---------|----------------------|----------|
| 2025-10-15 | 1.0 | Initial PRD creation | PM Agent |
---