docs: 删除过时的功能规格文档
feat(ui): 重构资产页面UI,移除shadcn_ui依赖并简化设计 - 删除三个过时的功能规格文档(apply-new-styles.md、bottom-nav-labels.md、theme-dynamic-colors.md) - 重构充值页面(deposit_page.dart):移除shadcn_ui依赖,简化表单验证和UI设计,使用动态主题颜色 - 重构划转页面(transfer_page.dart):移除复杂动画和shadcn_ui依赖,简化UI布局和交互逻辑 - 重构提现页面(withdraw_page.dart):移除shadcn_ui依赖,简化表单验证和网络选择器 - 重构我的页面相关组件:统一使用动态主题颜色,简化菜单项设计和KYC状态显示 - 所有页面现在使用Theme.of(context)获取动态颜色,支持明暗主题切换 - 移除硬编码的颜色引用,提高代码可维护性和主题一致性
This commit is contained in:
@@ -1,218 +0,0 @@
|
||||
# 应用新设计系统功能规格
|
||||
|
||||
## 1. 功能概述
|
||||
- **功能名称**: 应用新设计系统到 Flutter 项目
|
||||
- **优先级**: P0
|
||||
- **负责人**: 开发团队
|
||||
- **预计工期**: 1 天
|
||||
|
||||
## 2. 业务背景
|
||||
|
||||
### 当前痛点
|
||||
- 现有 Flutter 项目使用旧的样式系统
|
||||
- 缺乏统一的组件化设计
|
||||
- 视觉效果不够现代化
|
||||
- 缺少毛玻璃、霓虹光效等现代 UI 效果
|
||||
|
||||
### 解决方案
|
||||
- 应用新的 Material Design 3 配色方案
|
||||
- 使用 Space Grotesk + Manrope 字体组合
|
||||
- 组件化开发,提取可复用组件
|
||||
- 添加 Glass Panel 和 Neon Glow 效果
|
||||
|
||||
### 预期收益
|
||||
- 统一的视觉风格
|
||||
- 更好的用户体验
|
||||
- 提高开发效率(组件复用)
|
||||
- 现代化的 UI 效果
|
||||
|
||||
## 3. 功能详情
|
||||
|
||||
### 3.1 用户故事
|
||||
作为 Monisuo 用户,我希望应用有现代化的 UI 设计,以便获得更好的使用体验和视觉享受。
|
||||
|
||||
### 3.2 功能列表
|
||||
- [ ] 更新颜色系统(Material Design 3)
|
||||
- [ ] 更新字体系统(Space Grotesk + Manrope)
|
||||
- [ ] 创建 GlassPanel 组件
|
||||
- [ ] 创建 NeonGlow 效果组件
|
||||
- [ ] 更新交易页面样式
|
||||
- [ ] 更新行情页面样式
|
||||
- [ ] 更新我的页面样式
|
||||
- [ ] 创建充值弹窗组件
|
||||
- [ ] 创建提现弹窗组件
|
||||
|
||||
### 3.3 UI/UX 设计
|
||||
|
||||
#### 配色方案
|
||||
```dart
|
||||
// Primary Colors
|
||||
primary: #72dcff (青色)
|
||||
secondary: #dd8bfb (紫色)
|
||||
tertiary: #afffd1 (绿色)
|
||||
|
||||
// Surface Colors
|
||||
background: #0b0e14
|
||||
surface: #0b0e14
|
||||
surfaceContainer: #161a21
|
||||
surfaceContainerHigh: #1c2028
|
||||
surfaceContainerHighest: #22262f
|
||||
|
||||
// Semantic Colors
|
||||
error: #ff716c
|
||||
success: #afffd1
|
||||
warning: #ffa8a3
|
||||
```
|
||||
|
||||
#### 字体系统
|
||||
```dart
|
||||
// Fonts
|
||||
headline: Space Grotesk (标题)
|
||||
body: Manrope (正文)
|
||||
label: Manrope (标签)
|
||||
|
||||
// Icons
|
||||
Material Symbols Outlined
|
||||
```
|
||||
|
||||
#### 组件风格
|
||||
- **Glass Panel**: 毛玻璃效果(backdrop-filter: blur(20px))
|
||||
- **Neon Glow**: 霓虹光效(box-shadow: 0 0 15px rgba(114, 220, 255, 0.3))
|
||||
- **Dark Theme**: 深色主题为主
|
||||
- **Rounded Corners**: 大圆角设计(2rem, 1rem)
|
||||
|
||||
## 4. 技术方案
|
||||
|
||||
### 4.1 架构设计
|
||||
|
||||
#### 前端方案 (Flutter)
|
||||
- **状态管理**: Provider (保持现有)
|
||||
- **UI 组件**: shadcn_ui (保持现有)
|
||||
- **设计系统**: 新增 AppDesignSystem
|
||||
|
||||
#### 新增组件
|
||||
```
|
||||
lib/ui/components/
|
||||
├── glass_panel.dart # 毛玻璃面板
|
||||
├── neon_button.dart # 霓虹按钮
|
||||
├── neon_card.dart # 霓虹卡片
|
||||
└── modern_dialog.dart # 现代弹窗(已存在,需更新)
|
||||
```
|
||||
|
||||
#### 更新文件
|
||||
```
|
||||
lib/core/theme/
|
||||
├── app_color_scheme.dart # 更新颜色系统
|
||||
├── app_text_styles.dart # 更新字体系统
|
||||
└── app_design_system.dart # 新增设计系统
|
||||
|
||||
lib/ui/pages/
|
||||
├── trade/trade_page.dart # 更新交易页面
|
||||
├── market/market_page.dart # 更新行情页面
|
||||
└── mine/mine_page.dart # 更新我的页面
|
||||
```
|
||||
|
||||
### 4.2 API 设计
|
||||
|
||||
**保持现有 API 不变**,只更新 UI 层。
|
||||
|
||||
### 4.3 数据模型
|
||||
|
||||
**保持现有数据模型不变**。
|
||||
|
||||
## 5. 测试用例
|
||||
|
||||
### 5.1 正常流程测试
|
||||
- [ ] 所有页面正常显示
|
||||
- [ ] Glass Panel 效果正常
|
||||
- [ ] Neon Glow 效果正常
|
||||
- [ ] 字体正确显示
|
||||
- [ ] 颜色正确应用
|
||||
|
||||
### 5.2 兼容性测试
|
||||
- [ ] 现有 API 调用正常
|
||||
- [ ] 现有功能正常工作
|
||||
- [ ] 主题切换正常
|
||||
- [ ] 明暗模式正常
|
||||
|
||||
### 5.3 边界条件测试
|
||||
- [ ] 小屏幕设备显示正常
|
||||
- [ ] 大屏幕设备显示正常
|
||||
- [ ] 横屏显示正常
|
||||
- [ ] 性能测试通过
|
||||
|
||||
## 6. 验收标准
|
||||
|
||||
### 功能验收
|
||||
- [x] 所有功能点已实现
|
||||
- [ ] UI 符合设计稿
|
||||
- [ ] 交互流畅自然
|
||||
|
||||
### 质量验收
|
||||
- [ ] flutter analyze 无错误
|
||||
- [ ] 现有测试通过
|
||||
- [ ] 代码审查通过
|
||||
- [ ] 无明显性能问题
|
||||
|
||||
### 文档验收
|
||||
- [ ] 设计系统文档已更新
|
||||
- [ ] 组件使用说明已添加
|
||||
- [ ] CHANGELOG 已更新
|
||||
|
||||
## 7. 依赖与风险
|
||||
|
||||
### 依赖项
|
||||
- ✅ Google Fonts 包已安装
|
||||
- ✅ shadcn_ui 已集成
|
||||
- ✅ Provider 状态管理已使用
|
||||
|
||||
### 潜在风险
|
||||
- ⚠️ 字体加载可能影响性能 → 使用缓存策略
|
||||
- ⚠️ 毛玻璃效果在低端设备可能卡顿 → 添加性能检测
|
||||
- ⚠️ 新样式可能与现有样式冲突 → 分步骤更新
|
||||
|
||||
## 8. 时间规划
|
||||
|
||||
| 阶段 | 任务 | 预计时间 |
|
||||
|------|------|----------|
|
||||
| Phase 1 | 创建设计系统和基础组件 | 2 小时 |
|
||||
| Phase 2 | 更新页面样式 | 3 小时 |
|
||||
| Phase 3 | 测试和优化 | 1 小时 |
|
||||
| Phase 4 | 构建和部署 | 0.5 小时 |
|
||||
|
||||
## 9. 开发约束
|
||||
|
||||
### ⚠️ 重要约束
|
||||
1. **不破坏现有 API 接口**
|
||||
2. **保持现有业务逻辑**
|
||||
3. **兼容现有数据模型**
|
||||
4. **渐进式更新,避免大规模重构**
|
||||
|
||||
### ✅ 允许的操作
|
||||
- 更新 UI 样式
|
||||
- 创建新的 UI 组件
|
||||
- 更新主题系统
|
||||
- 优化视觉效果
|
||||
|
||||
### ❌ 禁止的操作
|
||||
- 修改 API 接口定义
|
||||
- 修改数据模型结构
|
||||
- 修改业务逻辑代码
|
||||
- 删除现有功能
|
||||
|
||||
## 10. 参考资料
|
||||
|
||||
- 交易页面样式: `页面样式/交易.txt`
|
||||
- 行情页面样式: `页面样式/行情.txt`
|
||||
- 我的页面样式: `页面样式/我的.txt`
|
||||
- 充值弹窗样式: `页面样式/充值弹窗.txt`
|
||||
- 提现弹窗样式: `页面样式/提现弹窗.txt`
|
||||
- Material Design 3: https://m3.material.io/
|
||||
- Space Grotesk Font: https://fonts.google.com/specimen/Space+Grotesk
|
||||
- Manrope Font: https://fonts.google.com/specimen/Manrope
|
||||
|
||||
---
|
||||
|
||||
**创建日期**: 2026-03-24 01:42 GMT+8
|
||||
**最后更新**: 2026-03-24 01:42 GMT+8
|
||||
**状态**: ✅ 准备就绪
|
||||
@@ -1,88 +0,0 @@
|
||||
# 底部导航栏优化 - 添加图标下方文字
|
||||
|
||||
## 1. 功能概述
|
||||
- **功能名称**: 底部导航栏添加文字标签
|
||||
- **优先级**: P1
|
||||
- **负责人**: 开发团队
|
||||
- **预计工期**: 30 分钟
|
||||
|
||||
## 2. 业务背景
|
||||
|
||||
### 当前痛点
|
||||
- 底部导航栏只有图标,没有文字
|
||||
- 用户需要猜测每个图标的功能
|
||||
- 用户体验不够友好
|
||||
|
||||
### 解决方案
|
||||
- 在图标下方添加文字标签
|
||||
- 提高可识别性和易用性
|
||||
|
||||
### 预期收益
|
||||
- ✅ 提升用户体验
|
||||
- ✅ 提高导航清晰度
|
||||
- ✅ 符合 Material Design 规范
|
||||
|
||||
## 3. UI/UX 设计
|
||||
|
||||
### 当前样式
|
||||
```
|
||||
[🏠] [📈] [💱] [💰] [👤]
|
||||
```
|
||||
|
||||
### 修改后样式
|
||||
```
|
||||
[🏠] [📈] [💱] [💰] [👤]
|
||||
首页 行情 交易 资产 我的
|
||||
```
|
||||
|
||||
## 4. 技术方案
|
||||
|
||||
### 修改文件
|
||||
- `lib/ui/pages/main/main_page.dart`
|
||||
|
||||
### 修改内容
|
||||
|
||||
**当前代码**:
|
||||
```dart
|
||||
Icon(
|
||||
item.icon,
|
||||
size: 24,
|
||||
color: isActive ? AppColorScheme.darkPrimary : AppColorScheme.darkOnSurfaceVariant,
|
||||
)
|
||||
```
|
||||
|
||||
**修改后代码**:
|
||||
```dart
|
||||
Column(
|
||||
mainAxisSize: MainAxisSize.min,
|
||||
children: [
|
||||
Icon(
|
||||
item.icon,
|
||||
size: 24,
|
||||
color: isActive ? colorScheme.primary : colorScheme.onSurfaceVariant,
|
||||
),
|
||||
const SizedBox(height: 4),
|
||||
Text(
|
||||
item.label,
|
||||
style: TextStyle(
|
||||
fontSize: 12,
|
||||
color: isActive ? colorScheme.primary : colorScheme.onSurfaceVariant,
|
||||
fontWeight: isActive ? FontWeight.w600 : FontWeight.normal,
|
||||
),
|
||||
),
|
||||
],
|
||||
)
|
||||
```
|
||||
|
||||
## 5. 验收标准
|
||||
|
||||
- [ ] 每个图标下方都有文字标签
|
||||
- [ ] 文字清晰可读
|
||||
- [ ] 激活状态文字加粗
|
||||
- [ ] 支持主题切换
|
||||
- [ ] 不影响现有功能
|
||||
|
||||
---
|
||||
|
||||
**创建日期**: 2026-03-24 02:50 GMT+8
|
||||
**状态**: 待执行
|
||||
@@ -1,93 +0,0 @@
|
||||
# 修复主题切换功能 - 动态颜色系统
|
||||
|
||||
## 1. 功能概述
|
||||
- **功能名称**: 修复主题切换,支持明暗主题动态切换
|
||||
- **优先级**: P0
|
||||
- **负责人**: 开发团队
|
||||
- **预计工期**: 2 小时
|
||||
|
||||
## 2. 业务背景
|
||||
|
||||
### 当前痛点
|
||||
- 所有页面使用硬编码的 `AppColorScheme.dark*` 颜色
|
||||
- 主题切换功能不生效
|
||||
- 只有深色主题,没有浅色主题
|
||||
- 用户体验不一致
|
||||
|
||||
### 解决方案
|
||||
- 使用 `Theme.of(context)` 动态获取当前主题颜色
|
||||
- 所有页面支持明暗主题切换
|
||||
- 统一使用 Theme Provider 提供的主题
|
||||
|
||||
### 预期收益
|
||||
- ✅ 主题切换功能正常工作
|
||||
- ✅ 支持深色和浅色主题
|
||||
- ✅ 提升用户体验
|
||||
- ✅ 代码更规范
|
||||
|
||||
## 3. 技术方案
|
||||
|
||||
### 3.1 问题代码示例
|
||||
|
||||
**❌ 错误写法**(当前):
|
||||
```dart
|
||||
Container(
|
||||
color: AppColorScheme.darkBackground, // 硬编码深色
|
||||
child: Text(
|
||||
'Hello',
|
||||
style: TextStyle(color: AppColorScheme.darkOnSurface), // 硬编码
|
||||
),
|
||||
)
|
||||
```
|
||||
|
||||
**✅ 正确写法**(修复后):
|
||||
```dart
|
||||
Container(
|
||||
color: Theme.of(context).colorScheme.background, // 动态
|
||||
child: Text(
|
||||
'Hello',
|
||||
style: TextStyle(color: Theme.of(context).colorScheme.onSurface), // 动态
|
||||
),
|
||||
)
|
||||
```
|
||||
|
||||
### 3.2 修改策略
|
||||
|
||||
1. **替换所有硬编码颜色**
|
||||
- `AppColorScheme.darkBackground` → `Theme.of(context).colorScheme.background`
|
||||
- `AppColorScheme.darkOnSurface` → `Theme.of(context).colorScheme.onSurface`
|
||||
- 等等...
|
||||
|
||||
2. **确保 ThemeProvider 正常工作**
|
||||
- 检查 ThemeProvider 实现
|
||||
- 确保明暗主题配置正确
|
||||
|
||||
3. **测试主题切换**
|
||||
- 在"我的"页面测试主题切换
|
||||
- 验证所有页面响应主题变化
|
||||
|
||||
## 4. 需要修改的文件
|
||||
|
||||
### 主要页面
|
||||
1. `lib/ui/pages/home/home_page.dart` - 首页
|
||||
2. `lib/ui/pages/market/market_page.dart` - 行情页面
|
||||
3. `lib/ui/pages/trade/trade_page.dart` - 交易页面
|
||||
4. `lib/ui/pages/asset/asset_page.dart` - 资产页面
|
||||
5. `lib/ui/pages/mine/mine_page.dart` - 我的页面
|
||||
6. `lib/ui/pages/orders/*.dart` - 订单页面
|
||||
|
||||
### 组件
|
||||
7. `lib/ui/components/*.dart` - 所有组件
|
||||
|
||||
## 5. 验收标准
|
||||
|
||||
- [ ] 所有页面使用动态颜色(Theme.of(context))
|
||||
- [ ] 主题切换功能正常工作
|
||||
- [ ] 深色主题显示正常
|
||||
- [ ] 浅色主题显示正常
|
||||
- [ ] 所有页面响应主题变化
|
||||
- [ ] flutter analyze 0 errors
|
||||
|
||||
---
|
||||
|
||||
**创建日期**: 2026-03-24 02:34 GMT+8
|
||||
Reference in New Issue
Block a user