feat(client/invite): 邀请页真实化(邀请区+战绩+TG 任务卡)+ 六语 l10n

client/lib/screens/invite_page.dart

@@ -1,17 +1,20 @@
-// invite_page.dart — 邀请好友(占位屏)
+// invite_page.dart — 邀请好友:邀请区(码/链接)+ 战绩 + TG 任务卡。
 //
-// TODO(spec-2): 邀请码/链接由后端签发,奖励进度来自 /v1/invite。当前码/链接/奖励进度
-// 均为静态占位,仅供 IA 走查——接后端前不接任何真实业务逻辑。
+// 数据来自 inviteProvider(Task 11,`/v1/invite`);未登录/加载/出错回退占位文案,
+// 不接任何静态 demo 数据。
 import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:url_launcher/url_launcher.dart';
 
 import '../l10n/app_text.dart';
 import '../pangolin_theme.dart';
+import '../services/channel_launch.dart';
+import '../services/invite_api.dart';
+import '../state/invite_provider.dart';
+import '../widgets/pangolin_button.dart';
 import '../widgets/pangolin_icons.dart';
-
-const String _kDemoInviteCode = 'PANGOLIN-DEMO';
-const String _kDemoInviteLink = 'https://pangolin.app/i/PANGOLIN-DEMO';
+import '../widgets/pangolin_toast.dart';
 
 class InviteScreen extends ConsumerWidget {
   const InviteScreen({super.key, required this.t, this.onBack, this.embedded = false});
@@ -30,29 +33,113 @@ class InviteScreen extends ConsumerWidget {
     }
   }
 
+  // 验证领取:拉 deep_link 后外部打开。canLaunchUrl + try-catch 双保险,
+  // 失败给可见 toast(与 payment_page._openRedirectUrl 同法)。
+  Future<void> _verifyAndClaim(BuildContext context, WidgetRef ref) async {
+    try {
+      final link = await ref.read(inviteApiProvider).telegramStartLink();
+      final uri = link.isEmpty ? null : Uri.tryParse(link);
+      if (uri == null) {
+        if (context.mounted) showPangolinToast(context, t.lang.loadFailedRetry);
+        return;
+      }
+      final can = await canLaunchUrl(uri);
+      if (!can) {
+        if (context.mounted) showPangolinToast(context, t.lang.loadFailedRetry);
+        return;
+      }
+      final ok = await launchUrl(uri, mode: LaunchMode.externalApplication);
+      if (!ok && context.mounted) showPangolinToast(context, t.lang.loadFailedRetry);
+      if (ok) await ref.read(inviteProvider.notifier).refresh();
+    } catch (_) {
+      if (context.mounted) showPangolinToast(context, t.lang.loadFailedRetry);
+    }
+  }
+
   @override
   Widget build(BuildContext context, WidgetRef ref) {
     final c = context.pangolin;
+    final inviteAsync = ref.watch(inviteProvider);
 
-    Widget body = ListView(
+    Widget body = inviteAsync.when(
+      loading: () => const Center(child: CircularProgressIndicator()),
+      error: (_, __) => _Placeholder(t: t),
+      data: (info) => info == null
+          ? _Placeholder(t: t)
+          : _InviteContent(t: t, info: info, onCopy: _copy, onVerifyAndClaim: (ctx) => _verifyAndClaim(ctx, ref)),
+    );
+
+    if (embedded) return body;
+    return Scaffold(
+      backgroundColor: c.bg,
+      body: SafeArea(
+        child: Column(crossAxisAlignment: CrossAxisAlignment.start, children: [
+          Padding(
+            padding: const EdgeInsets.fromLTRB(8, 6, 16, 10),
+            child: Row(children: [
+              IconButton(
+                onPressed: onBack ?? () => Navigator.of(context).maybePop(),
+                icon: Icon(PangolinIcons.arrowLeft, size: 22, color: c.fg1),
+              ),
+              Text(t.inviteTitle, style: PangolinText.h3.copyWith(color: c.fg1, fontWeight: FontWeight.w700)),
+            ]),
+          ),
+          Expanded(child: body),
+        ]),
+      ),
+    );
+  }
+}
+
+/// loading/error/未登录 的统一回退占位(保留原 IA 走查态)。
+class _Placeholder extends StatelessWidget {
+  const _Placeholder({required this.t});
+  final AppText t;
+  @override
+  Widget build(BuildContext context) {
+    final c = context.pangolin;
+    return Center(
+      child: Padding(
+        padding: const EdgeInsets.all(24),
+        child: Column(mainAxisSize: MainAxisSize.min, children: [
+          Icon(PangolinIcons.gift, size: 26, color: c.fg3),
+          const SizedBox(height: 10),
+          Text('—', style: PangolinText.body.copyWith(color: c.fg3)),
+        ]),
+      ),
+    );
+  }
+}
+
+class _InviteContent extends StatelessWidget {
+  const _InviteContent({required this.t, required this.info, required this.onCopy, required this.onVerifyAndClaim});
+  final AppText t;
+  final InviteInfo info;
+  final Future<void> Function(BuildContext, String, String) onCopy;
+  final Future<void> Function(BuildContext) onVerifyAndClaim;
+
+  @override
+  Widget build(BuildContext context) {
+    final c = context.pangolin;
+    return ListView(
       padding: const EdgeInsets.fromLTRB(20, 4, 20, 24),
       children: [
         _CopyCard(
           icon: PangolinIcons.gift,
           label: t.inviteCodeLabel,
-          value: _kDemoInviteCode,
+          value: info.code,
           mono: true,
           copyLabel: t.inviteCopyCode,
-          onCopy: () => _copy(context, _kDemoInviteCode, t.copied),
+          onCopy: () => onCopy(context, info.code, t.copied),
         ),
         const SizedBox(height: 14),
         _CopyCard(
           icon: PangolinIcons.link,
           label: t.inviteLinkLabel,
-          value: _kDemoInviteLink,
+          value: info.link,
           mono: false,
           copyLabel: t.inviteCopyLink,
-          onCopy: () => _copy(context, _kDemoInviteLink, t.copied),
+          onCopy: () => onCopy(context, info.link, t.copied),
         ),
         const SizedBox(height: 20),
         Padding(
@@ -82,44 +169,120 @@ class InviteScreen extends ConsumerWidget {
         ),
         Container(
           width: double.infinity,
-          padding: const EdgeInsets.all(24),
           decoration: BoxDecoration(
             color: c.surface,
             borderRadius: BorderRadius.circular(PangolinRadius.lg),
             border: Border.all(color: c.border),
             boxShadow: PangolinShadow.sm,
           ),
-          child: Column(children: [
-            Icon(PangolinIcons.gift, size: 26, color: c.fg3),
-            const SizedBox(height: 10),
-            Text('—', style: PangolinText.body.copyWith(color: c.fg3)),
+          child: Row(children: [
+            _StatCell(value: '${info.invited}', label: t.inviteStatInvited),
+            _StatDivider(color: c.border),
+            _StatCell(value: '${info.converted}', label: t.inviteStatConverted),
+            _StatDivider(color: c.border),
+            _StatCell(value: '${info.earnedDays}', label: t.inviteStatDays),
           ]),
         ),
+        if (info.tgEnabled) ...[
+          const SizedBox(height: 20),
+          Padding(
+            padding: const EdgeInsets.fromLTRB(2, 0, 2, 10),
+            child: Text(t.inviteTasksTitle, style: PangolinText.sm.copyWith(color: c.fg2, fontWeight: FontWeight.w700, fontSize: 13)),
+          ),
+          _TgTaskCard(t: t, info: info, onVerifyAndClaim: onVerifyAndClaim),
+        ],
       ],
     );
+  }
+}
 
-    if (embedded) return body;
-    return Scaffold(
-      backgroundColor: c.bg,
-      body: SafeArea(
-        child: Column(crossAxisAlignment: CrossAxisAlignment.start, children: [
-          Padding(
-            padding: const EdgeInsets.fromLTRB(8, 6, 16, 10),
-            child: Row(children: [
-              IconButton(
-                onPressed: onBack ?? () => Navigator.of(context).maybePop(),
-                icon: Icon(PangolinIcons.arrowLeft, size: 22, color: c.fg1),
-              ),
-              Text(t.inviteTitle, style: PangolinText.h3.copyWith(color: c.fg1, fontWeight: FontWeight.w700)),
-            ]),
-          ),
-          Expanded(child: body),
+class _StatCell extends StatelessWidget {
+  const _StatCell({required this.value, required this.label});
+  final String value;
+  final String label;
+  @override
+  Widget build(BuildContext context) {
+    final c = context.pangolin;
+    return Expanded(
+      child: Padding(
+        padding: const EdgeInsets.symmetric(vertical: 18),
+        child: Column(children: [
+          Text(value, style: PangolinText.h3.copyWith(color: c.fg1, fontWeight: FontWeight.w700)),
+          const SizedBox(height: 4),
+          Text(label, style: PangolinText.caption.copyWith(color: c.fg3)),
         ]),
       ),
     );
   }
 }
 
+class _StatDivider extends StatelessWidget {
+  const _StatDivider({required this.color});
+  final Color color;
+  @override
+  Widget build(BuildContext context) => SizedBox(height: 48, child: VerticalDivider(width: 1, color: color));
+}
+
+class _TgTaskCard extends StatelessWidget {
+  const _TgTaskCard({required this.t, required this.info, required this.onVerifyAndClaim});
+  final AppText t;
+  final InviteInfo info;
+  final Future<void> Function(BuildContext) onVerifyAndClaim;
+
+  @override
+  Widget build(BuildContext context) {
+    final c = context.pangolin;
+    return Container(
+      padding: const EdgeInsets.all(18),
+      decoration: BoxDecoration(
+        color: c.surface,
+        borderRadius: BorderRadius.circular(PangolinRadius.xl),
+        border: Border.all(color: c.border),
+        boxShadow: PangolinShadow.sm,
+      ),
+      child: Column(crossAxisAlignment: CrossAxisAlignment.start, children: [
+        Row(children: [
+          Container(
+            width: 32, height: 32,
+            decoration: BoxDecoration(color: c.accentSubtle, borderRadius: BorderRadius.circular(PangolinRadius.sm)),
+            child: Icon(PangolinIcons.send, size: 17, color: c.accent),
+          ),
+          const SizedBox(width: 10),
+          Expanded(
+            child: Text(t.inviteJoinTgTitle,
+                style: PangolinText.sm.copyWith(color: c.fg1, fontWeight: FontWeight.w700, fontSize: 13.5)),
+          ),
+        ]),
+        const SizedBox(height: 14),
+        if (info.tgJoined)
+          PangolinButton(
+            label: t.inviteTaskDone,
+            icon: PangolinIcons.checkCircle,
+            variant: PangolinButtonVariant.secondary,
+            expand: true,
+            onPressed: null,
+          )
+        else
+          Column(children: [
+            PangolinButton(
+              label: t.inviteJoinTgBtn,
+              variant: PangolinButtonVariant.secondary,
+              expand: true,
+              onPressed: () => launchChannel(info.channel),
+            ),
+            const SizedBox(height: 10),
+            PangolinButton(
+              label: t.inviteVerifyBtn,
+              variant: PangolinButtonVariant.primary,
+              expand: true,
+              onPressed: () => onVerifyAndClaim(context),
+            ),
+          ]),
+      ]),
+    );
+  }
+}
+
 class _CopyCard extends StatelessWidget {
   const _CopyCard({
     required this.icon,