feat(admin): normalize Persian/Arabic digits in every numeric field

Users typing on a Persian keyboard produced two distinct failures. Fields with
type="number" silently returned an empty string — the browser rejects Persian
digits, so the value was lost and saved as empty or zero. Text fields passed the
Persian characters straight through to the database, where a mobile stored as
۰۹۱۲… never matches 09… again. The secretary form hit the second case with no
validation at all.

Frontend:
- Adds digitsOnly() and the national-code schemas to lib/utils, plus lib/forms
  with numericField()/latinDigitsField() wrappers for React Hook Form fields.
- Converts every type="number" input to type="text" inputMode="numeric" with
  digit normalization; none remain. Fields that legitimately carry non-digits
  (sheba, landline) only get the digits translated, keeping IR and separators.
- Points the patient national-code and mobile schemas at the shared normalizing
  schemas, which accept Persian input instead of rejecting it.
- Drops two duplicate local digit converters in favour of the shared helper.

Backend:
- Adds NumericFieldNormalizerSubscriber, translating digits in whitelisted
  numeric keys of JSON request bodies under /api/v1/ before controllers run, so
  nobat724_front and clinic-pro-tauri are covered too. Translation only — no
  characters are stripped, non-string values and other keys are untouched.

Three component tests asserted on role="spinbutton" and numeric input values;
both are properties of type="number", so they were updated to match the new
text inputs.

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

assets/admin/lib/forms.ts

@@ -0,0 +1,44 @@
+import type { UseFormRegisterReturn } from 'react-hook-form';
+import { digitsOnly, toEnglishDigits } from './utils';
+
+/**
+ * فیلدهای عددی React Hook Form: ارقام فارسی/عربی را حین تایپ به لاتین تبدیل می‌کند.
+ *
+ * چرا `type="text"`؟ چون `type="number"` روی ارقام فارسی مقدار را نامعتبر می‌داند
+ * و `e.target.value` رشتهٔ خالی برمی‌گرداند — یعنی داده از دست می‌رود و هیچ
+ * onChange‌ای نجاتش نمی‌دهد.
+ */
+type NumericFieldProps = UseFormRegisterReturn & {
+  type: 'text';
+  inputMode: 'numeric';
+  dir: 'ltr';
+};
+
+function wrap(
+  reg: UseFormRegisterReturn,
+  normalize: (raw: string) => string,
+): NumericFieldProps {
+  return {
+    ...reg,
+    type: 'text',
+    inputMode: 'numeric',
+    dir: 'ltr',
+    onChange: (event: { target: any; type?: any }) => {
+      event.target.value = normalize(String(event.target.value ?? ''));
+      return reg.onChange(event);
+    },
+  };
+}
+
+/** فقط ارقام لاتین — برای موبایل، کد ملی، مبلغ، درصد، تعداد. */
+export function numericField(reg: UseFormRegisterReturn, maxDigits?: number): NumericFieldProps {
+  return wrap(reg, (raw) => digitsOnly(raw, maxDigits));
+}
+
+/**
+ * فقط ترجمهٔ رقم؛ جداکننده‌ها و حروف حفظ می‌شوند — برای شبا (`IR…`) و
+ * تلفن ثابت (`021-1234…`).
+ */
+export function latinDigitsField(reg: UseFormRegisterReturn): NumericFieldProps {
+  return wrap(reg, toEnglishDigits);
+}

assets/admin/lib/utils.test.ts

@@ -1,5 +1,10 @@
 import { describe, it, expect } from 'vitest';
+import { z } from 'zod';
 import {
+    digitsOnly,
+    persianSafeNumber,
+    iranNationalCodeSchema,
+    iranNationalCodeOptionalSchema,
     formatRial,
     rialToToman,
     tomanToRial,
@@ -130,6 +135,45 @@ describe('toEnglishDigits', () => {
     });
 });
 
+describe('digitsOnly', () => {
+    it('رقم فارسی و عربی مخلوط را نرمال و غیررقم را حذف می‌کند', () => {
+        expect(digitsOnly('۱۲٣٤-56 ب')).toBe('123456');
+    });
+    it('با maxLen برش می‌زند', () => {
+        expect(digitsOnly('۱۲۳۴۵۶۷۸۹۰۱۲', 10)).toBe('1234567890');
+    });
+    it('ورودی خالی → رشته خالی', () => {
+        expect(digitsOnly('')).toBe('');
+    });
+    it('فقط حروف → خالی', () => {
+        expect(digitsOnly('کد ملی')).toBe('');
+    });
+});
+
+describe('persianSafeNumber', () => {
+    it('رشته‌ی فارسی را قبل از عدد شدن نرمال می‌کند', () => {
+        const schema = persianSafeNumber(z.coerce.number());
+        expect(schema.parse('۱۲۳')).toBe(123);
+    });
+    it('عدد را دست‌نخورده رد می‌کند', () => {
+        const schema = persianSafeNumber(z.coerce.number());
+        expect(schema.parse(42)).toBe(42);
+    });
+});
+
+describe('iranNationalCodeSchema', () => {
+    it('کد ملی فارسی را می‌پذیرد و لاتین برمی‌گرداند', () => {
+        expect(iranNationalCodeSchema.parse('۰۰۱۲۳۴۵۶۷۸')).toBe('0012345678');
+    });
+    it('کمتر از ۱۰ رقم رد می‌شود', () => {
+        expect(() => iranNationalCodeSchema.parse('12345')).toThrow();
+    });
+    it('نسخه‌ی اختیاری خالی را می‌پذیرد', () => {
+        expect(iranNationalCodeOptionalSchema.parse('')).toBe('');
+        expect(() => iranNationalCodeOptionalSchema.parse('123')).toThrow();
+    });
+});
+
 describe('sanitizeMobileInput', () => {
     it('غیررقم حذف، رقم فارسی نرمال، حداکثر ۱۱ رقم', () => {
         expect(sanitizeMobileInput('۰۹۱۲-۳۴۵ ۶۷۸۹۰۱۲')).toBe('09123456789');

assets/admin/lib/utils.ts

@@ -102,7 +102,8 @@ export function cn(...classes: (string | undefined | null | false)[]): string {
   return classes.filter(Boolean).join(' ');
 }
 
-// تبدیل ارقام فارسی/عربی به انگلیسی + حذف هر کاراکتر غیرعددی.
+// ترجمه‌ی ارقام فارسی/عربی به لاتین. کاراکترهای غیرعددی دست‌نخورده می‌مانند
+// (برای شبا و تلفن ثابت که حرف و خط تیره دارند لازم است).
 export function toEnglishDigits(input: string): string {
   if (!input) return '';
   return input
@@ -110,11 +111,23 @@ export function toEnglishDigits(input: string): string {
     .replace(/[٠-٩]/g, (d) => String(d.charCodeAt(0) - 0x0660));
 }
 
+// فقط ارقام لاتین، با محدودیت طول اختیاری.
+export function digitsOnly(input: string, maxLen?: number): string {
+  const digits = toEnglishDigits(input).replace(/\D/g, '');
+  return maxLen ? digits.slice(0, maxLen) : digits;
+}
+
 // فقط ارقام انگلیسی، حداکثر ۱۱ رقم (برای فیلد موبایل).
 export function sanitizeMobileInput(input: string): string {
-  return toEnglishDigits(input).replace(/\D/g, '').slice(0, 11);
+  return digitsOnly(input, 11);
 }
 
+// z.coerce.number() روی رشته‌ی فارسی NaN می‌دهد. فیلدهای عددی پنل در مبدأ (numericField
+// در lib/forms.ts) نرمال می‌شوند، پس این wrapper فقط برای مصرف‌کننده‌های خارج از آن مسیر است.
+// روی resolverهای React Hook Form استفاده نکن — z.preprocess تایپ ورودی را unknown می‌کند.
+export const persianSafeNumber = <T extends z.ZodTypeAny>(schema: T) =>
+  z.preprocess((v) => (typeof v === 'string' ? toEnglishDigits(v) : v), schema);
+
 // regex شماره موبایل ایران
 export const IRAN_MOBILE_RE = /^09\d{9}$/;
 
@@ -133,3 +146,16 @@ export const iranMobileOptionalSchema = z
   .string()
   .transform((v) => toEnglishDigits(v).replace(/\D/g, ''))
   .refine((v) => v === '' || IRAN_MOBILE_RE.test(v), 'شماره موبایل نامعتبر است');
+
+// regex کد ملی ایران (۱۰ رقم؛ صحت رقم کنترلی اینجا بررسی نمی‌شود)
+export const IRAN_NATIONAL_CODE_RE = /^\d{10}$/;
+
+export const iranNationalCodeSchema = z
+  .string()
+  .transform((v) => digitsOnly(v, 10))
+  .refine((v) => IRAN_NATIONAL_CODE_RE.test(v), 'کد ملی باید ۱۰ رقم باشد');
+
+export const iranNationalCodeOptionalSchema = z
+  .string()
+  .transform((v) => digitsOnly(v, 10))
+  .refine((v) => v === '' || IRAN_NATIONAL_CODE_RE.test(v), 'کد ملی باید ۱۰ رقم باشد');