Files
halobestie-clone/client_app/lib/features/payment/widgets/payment_icon.dart
Ramadhan Sjamsani 2c95fd040d Phase 5.x payment revamp + Xendit Stage-8 prep
- Backend wraps idn-finlogos npm at /assets/payment-icons/<slug>.svg with
  1y immutable cache. Mobile drops bundled SVGs (only placeholder remains)
  and fetches via flutter_cache_manager. payment_methods.icon is now a
  CSV of slugs; catalog emits icon_urls[]. CARDS tile renders Visa + MC +
  JCB side by side.
- Per-method min/max amount bounds (BIGINT, nullable). Picker greys out
  out-of-range tiles with subtitle; backend gates with INVALID_PAYMENT_AMOUNT
  (422). Defense in depth against stale-catalog clients.
- Xendit channel codes corrected from authoritative docs
  (BCA_VA -> BCA_VIRTUAL_ACCOUNT, CREDIT_CARD -> CARDS, ovo -> ovo-new,
  shopeepay -> shopee-pay, ...). 18 methods x 5 groups seeded with
  Xendit-published per-channel min/max.
- Re-runnable seed (ON CONFLICT DO NOTHING on payment_code + new unique
  index on group name). Operator CC edits never clobbered across re-runs.
  One-shot reset + inspect scripts under backend/.dev/.
- Customer redirect HTML pages at /payment/return/{success,failure},
  brand-styled with "Buka HaloBestie" CTA firing halobestie:// deeplink.
  URL scheme registered on Android (intent-filter w/ BROWSABLE on
  MainActivity) and iOS (CFBundleURLTypes). Waiting-payment poller still
  owns confirmation; deeplink just brings the activity to foreground.
- Control center payment-catalog page: min/max inputs + columns. Other
  CC pages restyled with new theme tokens (separate work, bundled here).

169/169 backend tests pass. See requirement/phase5-payment-revamp-2026-05-27.md
for the full revamp doc. Stage 8 (E2E) still pending: webhook URL routing
decision + two client_app follow-ups (legacy /chat/request removal,
extension Custom Tab).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-27 21:33:51 +08:00

73 lines
2.4 KiB
Dart

import 'package:flutter/material.dart';
import 'package:flutter_cache_manager/flutter_cache_manager.dart';
import 'package:flutter_svg/flutter_svg.dart';
import '../../../core/api/api_client.dart';
import '../../../core/theme/halo_tokens.dart';
/// Renders a payment-method brand mark fetched from the backend.
///
/// `iconUrl` comes from `payment_methods.icon_url` on the catalog response.
/// Relative paths (the common case — `/assets/payment-icons/<slug>.svg`) are
/// resolved against [ApiClient.baseUrl]. Absolute URLs (operator override)
/// are used as-is.
///
/// First fetch hits the network; the file is then persisted to disk by
/// [DefaultCacheManager] (30-day idle LRU) and served locally on subsequent
/// renders. While the cache lookup is in flight or when [iconUrl] is null,
/// the bundled placeholder is shown so the picker never displays a spinner.
class PaymentIcon extends StatelessWidget {
final String? iconUrl;
final double size;
final Color color;
const PaymentIcon({
super.key,
required this.iconUrl,
this.size = 24,
this.color = HaloTokens.brandDark,
});
String? get _resolvedUrl {
final raw = iconUrl;
if (raw == null || raw.isEmpty) return null;
if (raw.startsWith('http://') || raw.startsWith('https://')) return raw;
return '${ApiClient.baseUrl}$raw';
}
@override
Widget build(BuildContext context) {
final url = _resolvedUrl;
if (url == null) return _placeholder();
return FutureBuilder<FileInfo?>(
future: DefaultCacheManager().getFileFromCache(url),
builder: (context, cachedSnap) {
final cached = cachedSnap.data?.file;
if (cached != null) {
return SvgPicture.file(cached, width: size, height: size);
}
// Cache miss: render placeholder while the download lands, then swap
// in. We fire the download in the same FutureBuilder body so the next
// rebuild picks up the freshly-cached file.
return FutureBuilder(
future: DefaultCacheManager().getSingleFile(url),
builder: (context, snap) {
if (snap.hasData) {
return SvgPicture.file(snap.data!, width: size, height: size);
}
return _placeholder();
},
);
},
);
}
Widget _placeholder() => SvgPicture.asset(
'assets/payment_icons/placeholder.svg',
width: size,
height: size,
colorFilter: ColorFilter.mode(color, BlendMode.srcIn),
);
}