مبرمج .NET + PostgreSQL لحل مشكلة ربط زاتكا (Phase 2)

لدي نظام POS محلي يعمل على:

Backend: .NET 8

Database: PostgreSQL

Local API: http://127.0.0.1:5290

تم تنفيذ شاشة ربط زاتكا (Phase 2) وتوليد CSR بنجاح، لكن عند تنفيذ:

POST /api/zatca/onboarding/compliance

يظهر الخطأ:

Invalid-CSR

? المطلوب بدقة:

مراجعة توليد CSR والتأكد أنه مطابق 100% لمتطلبات ZATCA

التأكد أن جميع القيم المستخدمة في CSR تأتي من واجهة المستخدم (zatca_settings.html) فقط، وليس من أي قيم مخزنة أو fallback

إصلاح أي خطأ في:

subject

subjectAltName (DirName)

serial number format

certificateTemplateName

key type (EC P-256)

التأكد من أن CSR الناتج مقبول من ZATCA (simulation)

⚠️ ملاحظات مهمة:

تم التحقق أن البيانات تصل من الشاشة وتظهر داخل CSR

لكن ZATCA ترفض CSR (Invalid-CSR)

لا أريد حلول نظرية، أريد إصلاح فعلي + اختبار ناجح

✅ النتيجة المطلوبة:

تنفيذ CSR صالح 100%

نجاح endpoint:

POST /api/zatca/onboarding/compliance

الحصول على:

binarySecurityToken + secret

? يفضل:

خبرة سابقة في ZATCA Phase 2

أو خبرة في OpenSSL و CSR structure

? المطلوب تسليم:

الكود المعدل جاهز

أوامر PowerShell للتطبيق

شرح مختصر لما تم إصلاحه

ملاحظات مهمة:

تم التأكد أن البيانات المدخلة من شاشة zatca_settings.html تصل فعليًا وتُستخدم في توليد CSR

تم التحقق أن القيم تظهر داخل:

input_dump.txt

last_zatca.cnf

وداخل CSR نفسه

نوع المفتاح EC (P-256) مستخدم

لكن ZATCA ترفض الطلب برسالة:

Invalid-CSR

تم تجربة أكثر من تعديل على:

Organization Name

Serial Number (SN)

Address

Device ID

والمشكلة مستمرة

المطلوب ليس تحليل نظري، بل تحديد السبب الفعلي وإصلاحه مع اختبار ناجح

✅ النتيجة المطلوبة:

توليد CSR مطابق 100% لمتطلبات ZATCA (Phase 2 - Simulation)

نجاح الطلب:

POST /api/zatca/onboarding/compliance

الحصول على:

binarySecurityToken

secret

التأكد أن جميع البيانات المستخدمة في CSR تأتي من الشاشة فقط (بدون أي fallback أو قيم مخزنة)

? يفضل:

خبرة سابقة في ZATCA Phase 2 (E-Invoicing)

أو خبرة قوية في:

OpenSSL

CSR generation

X509 extensions

subjectAltName (DirName)

? متطلبات إضافية مهمة:

* النظام يجب أن يكون قابل للاستخدام لأي عميل جديد بدون تدخل برمجي

* جميع بيانات زاتكا يتم إدخالها من خلال شاشة:

zatca_settings.html فقط

---

? تجربة المستخدم المطلوبة:

* المستخدم (غير تقني) يستطيع:

* إدخال بياناته بسهولة

* فهم كل حقل ماذا يعني

* معرفة ما المطلوب منه بالضبط

* يجب أن تحتوي الشاشة على:

* شرح واضح لكل خانة (مثال أو Placeholder)

* رسائل تنبيه فورية عند نقص البيانات

* عدم السماح بالتنفيذ في حال وجود نقص

---

? رسائل الأخطاء:

* يجب أن تكون رسائل الخطأ:

* واضحة بالعربي

* مفهومة لغير المبرمج

* توضح السبب الحقيقي للمشكلة

مثال:

❌ بدل: Invalid-CSR

✅ يظهر: "يوجد خطأ في بيانات الشهادة (CSR)، تأكد من اسم المتجر والعنوان باللغة الإنجليزية"

---

? التشخيص الذكي:

* النظام يجب أن يساعد المستخدم على معرفة:

* أين المشكلة تحديدًا

* أي حقل هو السبب

* ماذا يجب عليه تعديله

---

⚙️ السلوك المطلوب:

* لا يتم استخدام أي بيانات مخزنة مسبقًا بدون علم المستخدم

* جميع البيانات المستخدمة في CSR يجب أن تكون من الشاشة فقط

* أي تغيير في الشاشة ينعكس مباشرة في CSR

---

? الهدف النهائي:

أن يتمكن أي عميل جديد من:

1. الدخول للشاشة

2. تعبئة بياناته

3. الضغط على "تنفيذ الربط"

4. نجاح الربط مباشرة بدون تدخل تقني

---

? المطلوب:

تحويل شاشة الربط الحالية إلى واجهة احترافية موجهة للمستخدم النهائي

وليست مجرد شاشة تقنية للمطورين