العودة إلى كل المقالات
برمجة وتطوير آخر تحديث: 10 نوفمبر 2026

يظهر 10 قبل 2 في كتالوج SQLite: افصل الرقم عن تسمية العرض

ثلاث بطاقات بالأرقام 2 و10 و11 في حامل خشبي بجوار مطبوعة لمبنى خزفي أخضر وقلم رصاص
بطاقات مرتبة من 2 إلى 11 بجوار مطبوعة لمبنى خزفي أخضر.

أعاد الاستعلام الأول التسميات بهذا الترتيب: `02` ثم `10` ثم `11` ثم `2` ثم `2draft`. لم تختفِ صورة من الكتالوج. العمود الذي استخدمه الاستعلام للفرز يحفظ التسميات كنص. لذلك ظهرت 10 قبل 2. إذا كان المطلوب ترتيباً حسب رقم الإطار، فاجعل هذا الرقم قيمة مستقلة عن النص الذي يراه المحرر.

تحتفظ التجربة بجدولين في ملف SQLite محلي. الأول يعرض ما يحدث عند فرز النص وعند استخدام `CAST`. الثاني يحتفظ بالنص مع رقم يتحقق منه المستورد قبل الكتابة. ظهرت `2draft` بقيمة 2 في استعلام التحويل، لكنها لم تدخل الجدول المصحح. هذه المقارنة مفيدة عندما يبدو ترتيب الاستعلام أقرب إلى المطلوب مع أنه يقبل صفاً لا تتفق تسميته مع سياسة المشروع.

تتبع خمسة صفوف من المصدر إلى الاستعلام

أنشأ المثال خمس سجلات بمعرفات قصيرة حتى نستطيع التمييز بين الصفوف عند تساوي الأرقام. يحمل الصف `a` التسمية `10`، ويحمل `b` القيمة `2`، ويحمل `c` القيمة `11`، ويحمل `d` القيمة `02`، ويحمل `e` القيمة `2draft`. أدخلت القيم كنص في `raw_frames`. لا يعتمد المثال على أسماء ملفات حقيقية أو ترتيب قراءتها من مجلد. الصفوف هي بيانات تجريبية مملوكة للمشروع.

استخدم `ORDER BY label, item` لقراءة نسخة الجدول الأول. يرجع الاستعلام تسمية كل صف بالترتيب، ويسجل الكود النتيجة في `ordered.json`. تبدأ المقارنة في هذه العينة من المحارف. تقع التسمية التي تبدأ بـ0 قبل التسميات التي تبدأ بـ1، وتسبق هذه التسميات `2`. هذا يفسر ترتيب القائمة كما رآها الاستعلام. لا يصح أن تتوقع القيمة العددية من المظهر وحده عندما تقارن قاعدة البيانات نصوصاً وفق قواعدها النصية.

تعطي العينة أيضاً حالة `2draft` بعد `2`. هذا ليس صفاً جديداً ظهر أثناء الفرز، بل صف موجود في الإدخال ويبدأ بنفس المحرف. احتفظ به في المثال لأنه يكشف الفرق بين فرز السجلات وبين التحقق مما يجوز أن يدخل في قائمة مرتبة بالأرقام. قد يكون `draft` وصفاً مفيداً في مشروع حقيقي، لكن يجب عندئذ تحديد هل هو حالة مراجعة مستقلة، أم جزء من الاسم، أم سبب لاستبعاد الصف من هذا المسار.

يأخذ CAST إلى INTEGER البادئة العددية الصحيحة من النص وقد يتجاهل بقية المحارف. SQLite SQL expressions and CAST

عند تشخيص مشروعك، اطلب من الاستعلام أن يعرض المعرف والتسمية قبل تمرير الصفوف إلى واجهة العرض. ثم قارن تلك النتائج بما تراه الشاشة. إذا جاء ترتيب النص من قاعدة البيانات نفسها، لن يفسره تغيير خط العرض أو ترجمة الأرقام. وإذا وصلت الصفوف مرتبة ثم بدلت الواجهة ترتيبها، يكون التحقيق في موضع آخر. تجربة صغيرة تحوي `2` و`10` تجعل الفرق واضحاً بسرعة دون الحاجة إلى تصدير الكتالوج كله.

اقرأ نتيجة التحويل قبل أن تعتمدها

يضيف الاستعلام الثاني تعبير `CAST(label AS INTEGER)`. يحتفظ بنص التسمية في عمود الناتج الأول ويعرض قيمة التحويل في العمود الثاني. يستخدم `ORDER BY 2, item` لترتيب النتيجة حسب العمود الثاني، ثم حسب المعرف. هنا يكون الرقم 2 في عبارة الترتيب موضع عمود في قائمة النتائج. وهو مختلف عن القيمة 2 التي خرجت من التحويل. عند شرح الاستعلام لمراجع، من المفيد تسمية تعبير العمود أو توضيح موقعه لكي لا يُخلط بين المعنيين.

يعيد هذا المسار `(2, 2)` ثم `(02, 2)` ثم `(2draft, 2)` ثم `(10, 10)` ثم `(11, 11)` عند قراءة كل زوج كتسمية أصلية ورقم محول. تبدو `10` في موضع عددي صحيح الآن. لكن `2draft` أخذت القيمة نفسها التي أخذتها التسميتان الصالحتان. تعرض وثائق SQLite قاعدة البادئة عند تحويل النص إلى عدد صحيح. نفذنا الاستعلام في النسخة المحلية للتأكد من أثرها على هذه الحالة بالتحديد.

لا يكتب هذا الاستعلام قيمة جديدة في `raw_frames`. يعرض نتيجة حسابية أثناء القراءة. إذا كان مشروعك يجرّب تفسير سجل قديم، فقد يكون هذا العرض مفيداً لكشف القيم التي ستصبح متساوية بعد التحويل. استخدم الناتج في مراجعة منفصلة قبل أن تقرر أنه يمثل رقماً صالحاً للمهمة. المثال يختبر وجود الزوج `(2draft, 2)` لأنه دليل مباشر على أن التحويل لا يطبق قاعدة محارف الرقم التي يحتاجها المستورد.

يسمح جدول STRICT بمحاولة التحويل إلى النوع المطلوب عندما يمكن ذلك دون فقد، ولذلك لا يحدد وحده صيغة النص الوارد. SQLite STRICT Tables

قد يفيد `CAST` إذا كان لديك عقد سابق يضمن شكل النص بالفعل وتريد إجراءً خاصاً في استعلام. لكن لا تستمد ضمان شكل النص من نتيجة التحويل. في هذه العينة، ظهر رقم من تسمية تخالف القاعدة. إذا دمجت هذه التسميات بحسب الرقم الناتج فقط، قد تفقد الفرق بين سجل يحمل رقم إطار وبين سجل يحتاج تفسيراً. قارن في تقريرك القيمة الأصلية بالرقم المعروض، واتخذ قرار التحقق قبل أن يصبح الرقم مدخلاً إلى أي كتابة جديدة.

أعط رقم الإطار قواعد يمكن شرحها لصاحب البيانات

تستقبل `frame_index` نصاً وتفحصه بالكامل بالتعبير `[0-9]{1,6}`. تقبل من محرف واحد إلى ستة محارف من المجموعة المحددة. لا تستعمل `strip()` في هذا العقد، فلا تعالج الفراغ الطرفي تلقائياً. ولا تقبل إشارة أو لاحقة. ثم تستعمل `int(text)` بعد نجاح الفحص. لهذا لا تعيد الدالة العدد 2 عندما تمرر إليها `2draft`. ترفع `ValueError` في تلك الحالة.

يسمح العقد بالصفر وبالأصفار في بداية النص. معنى ذلك أن `02` صالح كتسمية لرقم 2 في المثال. لا يوجد قرار بإعادة كتابة التسمية إلى `2`. إذا كان مشروعك يشترط بدء الإطارات من 1 أو يرفض الأصفار الأولية، ضع ذلك في قواعده. لا تستنتجه من كلمة «رقم إطار» وحدها. قد تبدأ أداة ترميز بالرقم 0 بينما يبدأ كتالوج مراجعة بالرقم 1. ينبغي أن يُكتب هذا الاختيار في الاختبار وفي قاعدة التحقق التي تعمل فعلاً.

توقع أرقام ASCII قرار لهذه العينة. إذا جاءت الأسماء من واجهة عربية تسمح بتمثيلات أخرى للأرقام، يمكنك اختيار تحويل صريح قبل إجراء التحقق. احتفظ بالنص الأصلي إذا كان سيظهر للمستخدم أو يساعده على مطابقة الملف. اختبر النصوص التي تسمح بها الواجهة والنص الذي يجمع صيغاً لا تريد قبولها. التجربة المحفوظة لا تختبر إدخالاً مترجماً أو عرضاً في متصفح. إنها تحدد ما تفعله الدالة الصغيرة عند تطبيق هذه القاعدة على سجلاتها الخمسة.

تفرز قيم TEXT وفق ترتيب المقارنة النصي، بينما تفرز القيم العددية معاً بحسب قيمتها. SQLite datatypes and sorting

يستطيع التطبيق أيضاً استخدام رقم لا يأتي من الاسم مطلقاً. قد يقدم المولد بياناً يضع معرف الصورة ورقم الإطار في حقلين منذ البداية. عندئذ يمكن للمستورد أن يراجع الحقل العددي وفق عقده ولا يستخرج الرقم من التسمية. يصلح مثال النص عندما تكون التسمية هي المصدر المتاح. وفي كلتا الحالتين، حافظ على وضوح مصدر رقم الفرز كي تستطيع معرفة لماذا تغيّر ترتيب عنصر عند تعديل اسمه أو تحديث سجله.

catalog_order.py

"""Store a catalog frame number separately from its original text label."""
import json
from pathlib import Path
import re
import sqlite3
import sys


def frame_index(text):
    if not isinstance(text, str) or re.fullmatch(r'[0-9]{1,6}', text) is None:
        raise ValueError('Expected 1–6 ASCII digits')
    return int(text)


def experiment(root):
    root = Path(root).resolve()
    root.mkdir()
    records = [('a', '10'), ('b', '2'), ('c', '11'), ('d', '02'), ('e', '2draft')]
    db = sqlite3.connect(root / 'catalog.sqlite3')
    try:
        db.execute('CREATE TABLE raw_frames (item TEXT PRIMARY KEY, label TEXT NOT NULL)')
        db.executemany('INSERT INTO raw_frames VALUES (?, ?)', records)
        text_order = db.execute('SELECT label FROM raw_frames ORDER BY label, item').fetchall()
        cast_order = db.execute('SELECT label, CAST(label AS INTEGER) FROM raw_frames ORDER BY 2, item').fetchall()
        db.execute('CREATE TABLE numbered_frames (item TEXT PRIMARY KEY, label TEXT NOT NULL, '
                   'frame_number INTEGER NOT NULL CHECK(frame_number BETWEEN 0 AND 999999)) STRICT')
        rejected = []
        for item, label in records:
            try:
                number = frame_index(label)
            except ValueError:
                rejected.append(label)
            else:
                db.execute('INSERT INTO numbered_frames VALUES (?, ?, ?)', (item, label, number))
        db.commit()
        numeric = db.execute('SELECT label, frame_number FROM numbered_frames ORDER BY frame_number, item').fetchall()
        assert text_order == [('02',), ('10',), ('11',), ('2',), ('2draft',)]
        assert ('2draft', 2) in cast_order
        assert numeric == [('2', 2), ('02', 2), ('10', 10), ('11', 11)]
        assert rejected == ['2draft']
        report = {'sqlite_version': sqlite3.sqlite_version, 'text_order': text_order,
                  'cast_order': cast_order, 'numeric_order': numeric, 'rejected': rejected}
        (root / 'ordered.json').write_text(json.dumps(report, indent=2), encoding='utf-8')
        return report
    finally:
        db.close()


if __name__ == '__main__':
    print(json.dumps(experiment(sys.argv[1]), indent=2))

نطاق التحقق المحلي: Four explicit assertions in an owned SQLite3.45.1 file. Rows (a,10),(b,2),(c,11),(d,02),(e,2draft). ORDER BY label,item gives 02,10,11,2,2draft. CAST assigns 2draft integer2 in query; it is not valid input. Python regex accepts 1–6 ASCII digits only, includes zero and leading zeros, no sign, whitespace or Unicode digits by policy. It preserves original labels. STRICT integer plus CHECK0..999999, SELECT ORDER BY frame_number,item gives (2,2),(02,2),(10,10),(11,11). b before d as tie by item, not insertion. 2draft rejected. Scope no production migration, performance/index plan, pagination test or source collision detection. STRICT does not prevent all coercions. Code does not normalize existing file in place.؛ البيئة: Python 3.12.3 Windows; SQLite 3.45.1

افصل الاسم المرئي عن ترتيب الصف

يكتب المسار المصحح ثلاثة أشياء في `numbered_frames`: المعرف `item` والتسمية `label` والعدد `frame_number`. تسمح هذه البنية لاستعلام العرض بإعادة الاسم الذي دخل من المصدر مع ترتيب عددي. يرى القارئ التسمية `02` كما هي، ويستطيع الاستعلام ترتيبها مع الصف الذي يحمل `2`. لا يحتاج التطبيق إلى نسخ الرقم إلى كل موضع يستخدم فيه الاسم أو إعادة تسمية ملف كي يتوافق عرضه مع الاستعلام.

يحسم الاستعلام `ORDER BY frame_number, item` تساوي الرقم بين الصفين. المعرف `b` يسبق `d` في هذه العينة، فتظهر `2` قبل `02` بعد أن أصبحت قيمة الفرز العددية لهما 2. لو كانت سياسة المشروع تريد تقديم التسمية ذات الأصفار، فحدد شرطاً مختلفاً لحسم التساوي. ويمكن أيضاً منع رقمين متساويين داخل تسلسل واحد إذا كان ذلك شرطاً. الشيفرة الحالية تجعل `item` مفتاحاً فريداً، ولا تضع قيد تفرّد على `frame_number`.

قد يملك مشروع واحد مشهدين يبدأ كل منهما من الإطار 1. في هذه الحالة يمكن أن يكون ترتيب جميع الإطارات برقمها وحده غير كافٍ لمعرفة أي مشهد يظهر أولاً. حدد مجموعة الفرز، مثل المشروع أو المشهد، قبل تحديد المفتاح الثانوي. قد يختار التطبيق عرض مشهد واحد باستعلام يحصر الصفوف، أو يرتب المشاهد أولاً ثم الإطارات. تجربة الكتالوج هنا لا تحتوي على مجموعات متعددة، لكنها توضح الفرق بين المعرف الثابت وقيمة قد تتكرر في أكثر من صف.

بعد تثبيت رقم الفرز، قد تحتاج إلى استخدام مفتاح مركب لتصفح معرض SQLite. مثال التصفح يعالج حفظ موضع الصفحة، بينما تعالج هذه التجربة معنى القيمة التي تُرتّب بها الصفوف. إذا كان لديك مستدعي يقرأ على دفعات، اجعله يستعمل نفس شروط الترتيب بين الطلبات. اختبار التصفح يجب أن يشمل حد الصفحة وقيماً متساوية. لا تستدل على سلامة التنقل من استعلام بسيط قرأ الجدول كله مرة واحدة.

استعمل قيود الجدول للتحقق من القيمة المخزنة

يعرّف المثال `frame_number` من النوع `INTEGER`، ويضع `NOT NULL` وفحصاً أن يقع الرقم بين 0 و999999. يضيف أيضاً `STRICT` في تعريف الجدول. يتوافق الحد مع أكبر عدد من ستة أرقام في عقد المستورد. القيد يحرس القيمة المخزنة، بينما تفحص Python النص الذي جاء منها الرقم. تساعد هذه الطبقتان على تحديد سبب الرفض. قد يخالف النص صيغة المستورد قبل أن تظهر قيمة عددية. وقد يحاول مستدع آخر كتابة قيمة تتجاوز المجال بعد أن جهزها بطريقة مختلفة.

تسمح SQLite بمحاولة تحويل بعض القيم إلى النوع المعلن حتى في جدول `STRICT` عندما يكون التحويل ممكناً دون فقد. لهذا لا تعتبر تعريف العمود وحده دليلاً على أن كل كتابة مرّت من التعبير المنتظم الموجود في Python. إذا كان شكل النص جزءاً من عقد مشروعك، اجعل مسارات الاستيراد تطبق ذلك العقد قبل الكتابة. تستطيع في مشروع قائم إضافة فحوص لمدخلات من كل مسار، بدلاً من افتراض أن اختيار نوع عمود يثبت كل قواعد المصدر.

يحفظ الكود الصفوف الصالحة داخل قاعدة محلية جديدة. تستخدم أوامر الإدخال معاملات لتمرير قيمها، ثم يجري الحفظ قبل قراءة الترتيب النهائي. لا يغير السكربت جدولاً موجوداً في تطبيق فعلي. لا يمكننا استنتاج كيف ستتأثر فهارس كتالوجك أو الاستعلامات التي تعتمد على العمود القديم من هذا الحجم الصغير. إذا كنت تفكر في تغيير بنية قائمة، قارن خطة الاستعلام في نسخة من قاعدة بياناتك بعد تثبيت ترتيب الصفوف ومعنى القيم.

إذا تغير عقد الرقم لاحقاً، راجع التعبير وقيد الجدول معاً. تمديد عدد المحارف دون تغيير الحد قد يجعل المستورد يقبل نصاً ثم يفشل إدخاله. تغيير الحد في الجدول فقط يترك المستورد يرفض بعض القيم التي أصبح الجدول قادراً على استقبالها. لا تحتاج إلى انتظار تشغيل مشروع كامل لتكشف هذا الفرق. استخدم قيماً عند الحد وحوله في اختبار مقترح، واحفظ نص القاعدة التي اختبرت حتى لا يخلط المراجع بين إصدارين منها.

أبق السجل المرفوض متاحاً للتحقيق

تضيف الشيفرة `2draft` إلى قائمة المرفوضات. لا تضيفه إلى الجدول العددي، ويبقى موجوداً في الجدول الخام الذي بنيناه للتجربة. في مشروع يستورد كتالوجاً من ملفات متعددة، يمكن أن يسجل تقرير الاستيراد المعرف والتسمية والسبب. يعطي ذلك صاحب البيانات موضعاً يراجعه. مثلاً قد يقرر أن يضع كلمة `draft` في حقل للحالة ويضيف رقماً صالحاً، أو أن يستبعد المسودة من التسلسل المنشور أصلاً.

قبل إصدار قاعدة جديدة للفرز، قد ترغب في تشغيل التحقق على نسخة من بيانات قديمة وإخراج قائمة لا تكتب أي تغيير. ستساعدك النتيجة على التمييز بين القيم غير المقروءة والتسميات التي تقبلها القاعدة ولكنها تعطي أرقاماً متساوية. التساوي ليس دائماً خطأ. إذا كان الكتالوج يسمح بنسخ أو بدائل للإطار نفسه، احتفظ بالعلاقة ومعرف كل أصل. وإذا كانت الأرقام مفاتيح عمل ينبغي ألا تتكرر، راجع الحالات قبل فرض التفرّد على قاعدة تحتوي بالفعل على تلك الصفوف.

يمكن أن يحتوي تقرير الرفض على العدد الإجمالي للصفوف المقروءة وعدد المقبول والمرفوض. لا تجعل العدد بديلاً عن المعرفات حين يحتاج المستخدم إلى تصحيح البيانات. وفي الاتجاه الآخر، لا تطبع أسماء خاصة أو مسارات كاملة في سجل لا يحتاجها. يكفي عادة أن تربط القرار بمعرف يستطيع مالك المشروع الرجوع إليه. هذا تصميم لتقرير يمكن اختباره في تطبيقك. الملف المحلي الذي حفظناه يسجل تسمية واحدة مرفوضة ضمن العينة ويترك للشفرة التي تستدعيه قرار عرضها.

اكتب التحقق بحيث يفرّق بين أسباب تغير القائمة

يتضمن السكربت أربعة فحوص صريحة. الأول يقارن الترتيب النصي كاملاً بالقائمة المتوقعة. والثاني يبحث عن حالة `2draft` مع العدد 2 في نتيجة التحويل. والثالث يقارن أزواج التسميات والأرقام الأربعة بعد الفرز العددي. والرابع يتأكد أن المرفوض هو `2draft`. وجود فحص كامل للنتيجة يختلف عن فحص الصف الأول فقط. إذا تغيّر موضع الصفوف التي تتساوى في العدد، يمكن للمقارنة الكاملة أن تكشف تغير الشرط الثانوي أيضاً.

إذا أردت إعادة التشغيل، استخدم مجلداً جديداً لتترك قاعدة التجربة الأولى ونتائجها كما هي. شُغل المثال في Python 3.12.3 على Windows مع SQLite 3.45.1 في 10 نوفمبر 2026. يحتفظ سجل المشروع بملف القاعدة ونتيجة الاستعلامات وبصمة الشيفرة. يمكن للقارئ الرجوع إلى الجدول الخام والجدول المصحح داخل الملف نفسه. لا يحتاج الاختبار إلى مزود صور أو حساب خارجي أو كتالوج إنتاج.

اكتب اختباراً إضافياً من نقطة دخول مشروعك إذا كنت ستستخدم الدالة في الاستيراد. اجعل المستدعي يقرأ سجلاً صالحاً وآخر يحتاج مراجعة ثم اعرض ما دخل الجدول وما بقي خارج الفرز العددي. قد تمر اختبارات الدالة كلها وتظل الواجهة تستخدم الاستعلام القديم، أو قد تتوقع الواجهة تسمية جديدة لم تعد تصل إليها. اختبار الطبقة التي ترى القائمة الفعلية هو المكان المناسب لربط الأعمدة الجديدة بما يراه المستخدم. هذه خطوة مقترحة بعد التجربة المحلية.

عند وصول بلاغ جديد بأن 10 قبل 2، احتفظ بنتيجة صغيرة قبل أن تعالجها. هل عمود العرض هو عمود الفرز أيضاً؟ هل يفسر التحويل قيمة لم يوافق المستورد عليها؟ وهل يوجد مفتاح ثانوي عند تساوي الأرقام؟ المقارنة بين الاستعلامات الثلاثة توضح أي سؤال تطرحه أولاً. بعد أن تتضح قاعدة المشروع، اختبرها على صفوف ذات معانٍ مختلفة بدلاً من تعديل اسم ملف واحد حتى يظهر مؤقتاً في مكانه.

خطط للانتقال على نسخة يمكن الرجوع إليها

إذا أضفت رقم الفرز إلى كتالوج يستخدمه الناس بالفعل، دوّن أولاً كيف يصل كل صف إلى ذلك الكتالوج. قد تأتي دفعة من ملف قديم وتأتي أخرى من محرر. حدد ما إذا كانت التسمية تمثل رقماً في كل مسار. ثم احسب رقم الفرز في نسخة اختبار واترك الحالات المرفوضة لتسوية واضحة. لا تستبدل العمود النصي في خطوة واحدة إذا كانت تقارير أو روابط أو ملفات خارجية تعتمد عليه. المثال ينشئ جدولين لهذا السبب التعليمي. لا يقدم وصفة ترحيل جاهزة لقاعدة لا يعرف بنيتها.

بعد ملء النسخة التجريبية، قارن عدداً محدوداً من الصفوف قبل التغيير وبعده. راجع الاسم المعروض والمعرف، ثم الرقم الجديد، ثم موضع العنصر في القائمة. تستطيع أيضاً اختبار استعلام يأتي من مسار لا يريد ترتيباً عددياً، مثل قائمة تعرض التسميات بحسب النص لسهولة العثور عليها. ليس مطلوباً أن يستعمل كل استعلام العمود الجديد. حدد أي وظيفة تعتمد على الرقم وأي وظيفة تحتفظ بسلوكها النصي، ثم اربط التوقع في كل وظيفة باستعلامها الفعلي.

قد يرغب محرر في تغيير التسمية بعد قبول الصف. إذا كان الرقم مشتقاً منها، قرر هل يجب تحديث الرقم في نفس عملية التعديل أم يبقى كما كان. عندما تكون التسمية مجرد عرض يمكن أن يتغير الاسم مع بقاء الرقم مستقلاً. أما إذا كان حقل النص هو المصدر الوحيد للرقم، فالقرار يجب أن يشمل إعادة التحقق قبل تغيير الترتيب. أضف في التطبيق اختباراً لتعديل اسم صالح ورفض تعديل غير صالح، مع التحقق مما رآه المستدعي في كل حالة. هذا العمل منفصل عن إنشاء السجلات الخمسة في المثال.

احتفظ في سجل المراجعة باسم الاستعلام الذي يعتمد العمود العددي وإصدار قاعدة البيانات التي شغّلته. إذا عاد اختلاف في ترتيب تسميتين تحملان الرقم نفسه، افحص المفتاح الثانوي قبل اتهام القارئ أو إعادة استيراد كل البيانات. وإذا ظهر صف غير مقبول ضمن القائمة، تتبع النقطة التي استخرجت رقمه والطريقة التي كتبت بها. هذه آثار تستطيع اختبارها بصورة مستقلة. وتظل قيمة التسمية الأصلية موجودة لكي تستطيع تفسير القرار أو مراجعته عندما يتغير مشروعك.

حدّد ما سيستعمله قارئ الكتالوج وما سيستعمله المصدّر

قد تحتاج واجهة العرض إلى إظهار تسمية مختصرة فقط، بينما يحتاج تقرير التصدير إلى المعرف والرقم معاً. إذا قرأ المصدّر القائمة المرتبة ثم كتب أسماء الملفات حسب مواضعها، احذر من افتراض أن الموضع يساوي رقم الإطار. في العينة يملك أول صفين الرقم 2، وليسا الإطارين 0 و1 لمجرد أنهما يبدآن النتيجة. يستطيع المصدّر أن يكتب الرقم الصريح وأن يحتفظ بمعرف الصف بجانبه حتى يعيد نظام آخر ربطه بمصدره. وإذا كان الملف يفرض رقماً فريداً لكل سطر، فهذه قاعدة إضافية تتطلب اختياراً عند التساوي.

فكّر أيضاً في ما إذا كانت القائمة التي تنشرها تعرض المسودات. وجود `2draft` في الجدول الخام يفيد التحقيق، لكنه لا يعني أن واجهة المشاهدة يجب أن تعرضه. تستطيع إدارة المشروع عرض السجل في قائمة للمراجعة بينما يقرأ المصدّر السجلات التي اجتازت الفحص فقط. إبقاء هذين المسارين ظاهرين في بنية التطبيق يسهل فهم سبب وجود ملف في تقرير الإدخال وغيابه من المخرجات. الشيفرة المحلية تعطيك مثالاً بسيطاً على الفرق، إذ تبقى التسمية في جدولها الأول ولا تظهر في استعلام الجدول الثاني.

إذا ظهرت القيم في مستند يعاد استيراده، اختر هل يكتب المستند رقم الفرز نفسه أم التسمية. كتابة رقم فقط قد تجعل `02` تتحول إلى `2` حين تُقرأ ثانية، مع بقاء القيمة العددية. كتابة التسمية فقط تعيد على المستورد مسؤولية تطبيق القاعدة قبل كل حفظ. يمكن للمشروع الذي يحتاج الاثنين أن يسجل حقلين ويعرّف متى يجوز تعديل كل منهما. عند قراءة مستند كهذا، تحقق من أن الرقم والتسمية يتفقان إذا كان أحدهما مشتقاً من الآخر. وإلا فقد يصبح لديك سجل يبدو صحيحاً من حيث النوع ويختلف عما أراد صاحبه.

يمكن للواجهة أن تتيح ترتيباً نصياً كخيار مستقل. مثلاً قد يريد شخص العثور على اسم يعرف بادئته، لا استعراض الإطارات حسب موضعها في التسلسل. سمّ الخيار بما يعبر عن هدفه واحتفظ بالنتيجة المتوقعة في اختبار مختلف. ليس خطأ أن يسبق `10` التسمية `2` في قائمة تعلن أنها ترتب النصوص. الخطأ هو أن تُعرض القائمة على أنها ترتيب رقمي من دون أن يعتمد الاستعلام قيمة رقمية. يتيح الفصل بين العمودين استخدام السلوكين دون إعادة تفسير البيانات كلما انتقل المستخدم بينهما.

اجعل التغيير قابلاً للمقارنة في سجل المراجعة

ابدأ من مجموعة صفوف تمثل عقودك الفعلية. مثال مفيد يضم قيمة ذات أصفار أولية، ومعرفين لهما الرقم نفسه، وقيمة تحتاج قراراً من محرر. اكتب قبل التشغيل ما تتوقع رؤيته في كل قائمة. بعد التشغيل قارن الصفوف بالمعرف لا بالتسمية وحدها، ثم تحقق من أن القيم المستبعدة لها سبب. بهذه الطريقة لا ينجح الاختبار إذا اختفى أحد الصفين المتساويين ولم يلاحظ أحد إلا أن الرقم 2 ما زال يظهر في النتيجة.

عند تغيير طريقة الاستيراد، قد تكشف المقارنة أن مستدعياً يزيل الفراغ قبل أن يصل النص إلى `frame_index`. هذا يختلف عن تعديل الدالة نفسها لتسمح بالفراغ. ضع موضع التنظيف في سجل القاعدة واختبر القيمة قبل وبعده إذا كان ذلك يؤثر على القبول. تستطيع مثلاً أن تعرض التسمية الأصلية كما وردت وتشتق رقمها من قيمة سبق توثيق تنظيفها. أما إذا كان الهدف اكتشاف الإدخالات غير المتسقة وطلب تصحيحها، فقد يكون رفض النص قبل التنظيف أنسب. تجربة اليوم تستعمل المدخلات المحددة فقط ولا تختبر أي تنظيف إضافي.

وأخيراً، اختبر حالة تغيير رقم موجود عندما يصبح في المشروع مسار تعديل. إذا استبدل المحرر رقم الإطار 2 برقم 12، توقع أن يتغير موضع الصف في قائمة الفرز بينما يبقى معرفه. وإذا غُيّر الاسم فقط ضمن عقد يفصله عن الرقم، توقع أن يبقى موضعه عند نفس المفتاح. إن دمج الحالتين في اختبار واحد يخفي السؤال الذي تريد الإجابة عنه. اجعل كل تعديل له أثر موضح في الاستعلام الذي يعرض القائمة وفي التقرير الذي يراجع أصل التسمية.

أُعد المقال بمساعدة أدوات ذكاء اصطناعي ومراجعة آلية. شُغّل المثال الأصلي محلياً. الصورة الرئيسية توضح موضوع المقال.

التعليقات

كن أول من يعلّق على هذا المقال.

أضف تعليقاً

بريدك لن يُنشر. الحقول المطلوبة معلَّمة بنجمة.