════════════════════════════════════════════════════════════════
  إصلاح جولة 2: cannot commit transaction / bad parameter (21)
════════════════════════════════════════════════════════════════

■ الخبر الكويس الأول:
"database is locked" اختفت تمامًا من اللوج — إصلاح القاعدة السابق
اشتغل. المشكلة المتبقية دي باج كامن قديم في كود الاستيراد نفسه
اتكشف بعد ما الأقفال اتشالت.

■ سبب الخطأين الجداد:

1) asg: cannot commit transaction - SQL statements in progress
   كتلة إسناد الشركة للمستخدم كانت بتفتح transaction وجواها
   SELECT مع fetchColumn() — و fetchColumn في PDO SQLite بيسيب
   مؤشر القراءة مفتوح، فالـ commit بيفشل دايمًا (خطأ 5).
   ده كان بيحصل لكل شركة موجودة = فيض الأخطاء اللي في اللوج.

2) insertCompany: General error: 21 bad parameter or other API misuse
   نتيجة مباشرة للخطأ الأول: لما الـ commit بيفشل والـ rollback
   بيفشل برضه (لنفس السبب)، بتفضل transaction زومبي مفتوحة
   ومؤشرات معلّقة على الاتصال → أي INSERT بعدها بيرمي خطأ 21 →
   الشركة بتقع → فولدرها كله بيتخطى → "0 ملف".

■ الحل في الملفين جوة المضغوط ده:

1) public/import_arc_folder.php  ← استبدل ملفك كله بده
   ▸ كتلة إسناد الشركة بقت INSERT OR IGNORE واحد من غير
     transaction ولا SELECT خالص (الجدول فيه UNIQUE(company_id,
     user_id) فالتكرار بيرفض تلقائيًا — أسرع وأضمن).
   ▸ كل SELECT بيتقفل مؤشره فورًا بعد القراءة (closeCursor).
   ▸ قبل أي transaction جديدة: لو فيه معلّقة قديمة بتتفضّى.
   ▸ زي ما هو من الجولة اللي فاتت: retry أقوى + منع النقر المزدوج.

2) config/database.php  ← نفس النسخة المحسّنة (WAL + busy_timeout
   30 ثانية). لو سبق واستبدلته مش محتاج تلمسه تاني، بس موجود
   هنا عشان الحزمة تكون مكتملة.

■ ملاحظة عن نسخة الصفحة:
اللوج بيوصل بـ [import_arc_folder] asg/insertCompany — ده معناه
إن اللي شغال على السيرفر دلوقتي هو نسختنا الموحدة. لو كان عندك
قبل كده قسم ترقيم مخصص («مدخل كل شركة» / «أخطاء أنشاء الرقم») و
عايز ترجّعه، ابعتلي نسخة السيرفر القديمة وهدمجهالك على النسخة
السليمة دي.

■ خطوات التطبيق:
   1) انسخ الملفين فوق القديمين (نفس المسارات جوة مجلد archive-system).
   2) Ctrl+Shift+R في المتصفح.
   3) شغّل الاستيراد تاني — آمن تمامًا ومفيش حاجة هتتكرر:
      ▸ الشركات اللي عملت قبله هتتلم بالاسم وتستخدم زي ما هي.
      ▸ الملفات اللي اترفعت هيتخطاها فحص التكرار.
      ▸ الشركات اللي فشلت (خطأ 21) هتتعمل، وملفاتها هتترفع.
      ▸ إسناد الشركات لأرشيفك هيتصلح تلقائيًا (كان بيعلق مع
        كل خطأ asg).
   4) انقر زر الاستيراد مرة واحدة بس واستنى النتيجة.
   5) راقب اللوج — المفروض ميظهر أي asg أو insertCompany خالص،
      ولو ظهر حرف "database is locked" يبقى في عملية تانية
      شغالة على القاعدة في نفس الوقت.
