# احراز هویت و ثبت حساب بانکی

ثبت اطلاعات و مدارک، استعلام‌های مستقل و معنای وضعیت‌های پرونده.

وضعیت: نیازمند پیکربندی | مخاطب: کاربران و تیم پشتیبانی
بازبینی مستندات: ۲۰۲۶/۰۹/۲۴ · ۲ مهر ۱۴۰۵

## مسیر کاربر

کاربر دارای موبایل تأییدشده، درخواست احراز را شروع می‌کند، مشخصات لازم را می‌نویسد و تصویر کارت ملی و تصویر همراه کد درخواست را می‌فرستد. ارسال نهایی به رضایت صریح، مدارک لازم و اعتبار کد وابسته است.

کد ملی ده‌رقمی با رقم کنترل بررسی می‌شود؛ شماره شناسنامه یک تا ده رقم و کد پستی ده رقم است. نام‌ها بین ۲ تا ۸۰ نویسه و نشانی بین ۱۵ تا ۱۰۰۰ نویسه پذیرفته می‌شوند. درست‌بودن قالب، تأیید هویت یا مالکیت نیست.

## وضعیت پرونده و استعلام

| وضعیت | معنا |
| --- | --- |
| draft | پیش‌نویس کاربر |
| pending | در انتظار بررسی مدیر |
| documents_approved | مدارک تأیید شده‌اند؛ استعلام‌ها هنوز باید کامل شوند |
| verified | شواهد موردنیاز مسیر تأیید کامل شده است |
| rejected | مدارک یا اطلاعات نیاز به اصلاح دارد |
| superseded | درخواست تازه لازم است |
| not_connected / pending / passed / failed / error | وضعیت مستقل هر استعلام: متصل نیست، منتظر، تطبیق، عدم تطبیق یا خطا |

## سطح اولیه و کامل

مدل داده مسیر هویتی برای سطح اولیه و مسیر هویتی‌وبانکی برای سطح کامل را از سطح فعلی حساب جدا نگه می‌دارد. در طرح مرحله‌بندی، اطلاعات، مدارک، استعلام‌ها و تأیید نهایی مراحل بررسی‌اند.

سطح اولیه به بررسی مدارک و شواهد هویت و مالکیت موبایل وابسته است. سطح کامل علاوه بر آن به تطبیق حساب بانکی نیاز دارد. وجود کد این قابلیت در مخزن، نصب مهاجرت مربوط در هر محیط را اثبات نمی‌کند.

## ثبت شبا و کارت

ثبت حساب با شبا، عنوان اختیاری، کارت اختیاری، شناسهٔ درخواست و رضایت انجام می‌شود. بانک از شبا شناسایی و تطبیق شبا با کد ملی از سرویس معتبر درخواست می‌شود؛ کارت اختیاری نیز در صورت ورود باید با شبا تطبیق داشته باشد.

در نبود آداپتور یا کلید لازم، حساب تأییدشده ساخته نمی‌شود. عدم تطبیق بانکی با خطای ارتباط تفاوت دارد. حداکثر ده حساب بانکی تعریف شده و انتخاب حساب اصلی و حذف حساب از جریان موجود پشتیبانی می‌شود.

## مدارک خصوصی و ویرایش هم‌زمان

برای هر تصویر احراز، JPG، PNG یا WebP تا ۵ مگابایت پذیرفته می‌شود و نوع واقعی فایل با هدر اعلام‌شده تطبیق داده می‌شود. مدارک در فضای خصوصی قرار دارند؛ خواندن مدرک نیازمند نشست و مجوز همان درخواست است.

شناسه و نسخهٔ پرونده هنگام ذخیره و ارسال بررسی می‌شوند تا تغییر هم‌زمان بی‌صدا بازنویسی نشود. نامعتبر یا منقضی‌شدن درخواست، تغییر موبایل و قفل‌شدن مشخصات باید با پیام مشخص پیگیری شوند.

## مراجع پیاده‌سازی

- lib/identity.ts
- lib/identity-server.ts
- lib/identity-files.ts
- lib/bank-registration.ts
- app/api/identity/route.ts
- app/api/identity/photo/route.ts
- app/api/dashboard/route.ts
- IDENTITY_VERIFICATION.md
- CUSTOMER_BANK_REGISTRATION.md
- supabase/migrations/202609200001_identity_review_levels.sql