wangjia
f97ae8186b
对照 design/ui_kits mobile+tablet 原型逐屏补齐 Flutter 客户端: - l10n 资源层(strings_zh/en,单显)+ Riverpod 状态层(连接状态机/免费额度/ 节点选择/语言/主题),UI 与数据解耦,mock 数据接 API 不动 UI。 - 连接键严格三态(off 虚线轨道环 / connecting 旋转弧 / on 满环+计时+光晕), 状态来自 connectionProvider,点击只派发事件——禁止乐观显示。 - 节点页置顶「智能选择」推荐卡(clay 渐变 zap + 推荐胶囊,默认选中); 免费额度卡(剩余分钟+进度条 ≤3 分钟切 warning + 看广告解锁变绿)。 - Tab 左右滑动切换(手势竞技场仲裁,子页滚动不误触发,200ms 方向感知滑入)。 - iPad/宽屏 ≥900 LayoutBuilder 切侧栏分栏(导航行高 ≥48,连接页双栏/节点双列网格), 复用同一批原子组件,不 fork 页面。 - 语义 token 零硬编码;文案全部走 l10n;套餐数字对齐 §7;无支付表单/emoji 国旗。 - CI 红线词扫描扩展到 client/lib;新增 Flutter analyze+test CI 任务。 - 测试:连接状态机/额度/节点单测、连接键三态与卡片组件测试、 golden(连接键三态/推荐卡/额度卡 × 明暗)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
54 lines
1.8 KiB
Dart
54 lines
1.8 KiB
Dart
// quota_provider.dart — 免费版每日额度状态机(Riverpod,mock 数据)
|
|
//
|
|
// 设计约定(design/CLAUDE.md §7 / §2):免费额度权威在服务端,本地仅展示。
|
|
// 这里以 mock 实现 UI 与数据层解耦的接口形态:剩余分钟 + 是否已看广告解锁。
|
|
// 接 API 时只替换本通知器内部,UI 不动。
|
|
import 'package:flutter_riverpod/flutter_riverpod.dart';
|
|
|
|
/// 免费额度快照。
|
|
class FreeQuotaState {
|
|
const FreeQuotaState({
|
|
this.totalMinutes = 10,
|
|
this.remainingMinutes = 6,
|
|
this.adUnlocked = false,
|
|
});
|
|
|
|
/// 每日总额度(分钟)。§7:免费版每日 10 分钟。
|
|
final int totalMinutes;
|
|
|
|
/// 今日剩余分钟(展示值,权威以服务端为准)。
|
|
final int remainingMinutes;
|
|
|
|
/// 今日是否已观看激励视频解锁。
|
|
final bool adUnlocked;
|
|
|
|
/// 进度(0–1),用于进度条宽度。
|
|
double get progress =>
|
|
totalMinutes == 0 ? 0 : (remainingMinutes / totalMinutes).clamp(0.0, 1.0);
|
|
|
|
/// 是否进入低额度警示(≤3 分钟切 warning 色)。
|
|
bool get isLow => remainingMinutes <= 3;
|
|
|
|
FreeQuotaState copyWith({int? totalMinutes, int? remainingMinutes, bool? adUnlocked}) =>
|
|
FreeQuotaState(
|
|
totalMinutes: totalMinutes ?? this.totalMinutes,
|
|
remainingMinutes: remainingMinutes ?? this.remainingMinutes,
|
|
adUnlocked: adUnlocked ?? this.adUnlocked,
|
|
);
|
|
}
|
|
|
|
class QuotaController extends StateNotifier<FreeQuotaState> {
|
|
QuotaController([FreeQuotaState? initial])
|
|
: super(initial ?? const FreeQuotaState());
|
|
|
|
/// 观看激励视频后解锁今日使用。
|
|
void watchAd() => state = state.copyWith(adUnlocked: true);
|
|
|
|
/// 演示重置(回到未解锁)。
|
|
void reset() => state = const FreeQuotaState();
|
|
}
|
|
|
|
final quotaProvider = StateNotifierProvider<QuotaController, FreeQuotaState>(
|
|
(ref) => QuotaController(),
|
|
);
|