feat: dukung penjualan produk per timbangan

Produk kini punya cara jual `unit` (cacah) atau `weight` (timbangan),
mengikuti kontrak backend di docs/integration-weight-based-products.md.

- tipe SellBy, domain/infrastructure unit baru, dan endpoint /api/v1/units
- dialog input berat saat produk timbangan ditambahkan ke keranjang
- tiap penimbangan jadi baris keranjang sendiri; total baris dihitung
  berat x harga satuan, sedangkan produk cacah tetap digabung
- request ke backend mengirim quantity 1 dan membawa berat
- migrasi DB v3: kolom sell_by, unit_id, unit_name, unit_abbreviation
  di tabel products supaya satuan tetap tampil saat offline
- tampilan keranjang, struk, split bill, void, dan refund memakai berat
- test/weight_based_products_test.dart menutup perilaku di atas (9 test)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

lib/common/function/app_function.dart

@@ -75,3 +75,25 @@ int generateRandomNumber() {
   final random = Random();
   return 1 + random.nextInt(10000);
 }
+
+/// Ambil pesan validasi dari amplop error standar backend.
+///
+/// Untuk produk timbangan pesannya menyebut nama produk — misalnya
+/// "product Ikan Tude is sold by weight and requires a weight" — jadi layak
+/// ditampilkan apa adanya ke kasir alih-alih diganti pesan generik.
+String? extractApiErrorCause(dynamic responseData) {
+  if (responseData is! Map) return null;
+
+  final errors = responseData['errors'];
+  if (errors is! List || errors.isEmpty) return null;
+
+  final causes = errors
+      .whereType<Map>()
+      .map((e) => (e['cause'] ?? e['message'])?.toString())
+      .where((cause) => cause != null && cause.isNotEmpty)
+      .cast<String>()
+      .toList();
+
+  if (causes.isEmpty) return null;
+  return causes.join('\n');
+}