تعريف المدخلات
اسم واضح ووحدة وفترة وتحقق من النطاق، مع بيان مصدر القيم الافتراضية إن وجدت.
الشفافية قبل النتيجة
منهجية Smart Fin Reports
كيف تتحول المشكلة إلى مدخلات ومعادلات وتفسير وتقرير، وما الذي نختبره فعلًا قبل أن نصف أداة بأنها جاهزة.
إصدار المنهجية: 5.4.9.22 — 24 يوليو 202601
نبدأ من سؤال القرار، لا من عدد الحقول
الأداة الجيدة تعرف ما الذي تساعد المستخدم على فهمه، وما الذي لا تستطيع حسمه.
قبل إضافة أي معادلة نسأل: ما المشكلة الفعلية؟ من المستخدم؟ ما البيانات المتاحة عادة؟ وما القرار الذي سيأتي بعد النتيجة؟ هذا يمنع تحويل الأداة إلى نموذج طويل يجمع بيانات لا تغير التحليل.
يُكتب لكل أداة نطاق واضح وافتراضات ومدخلات أساسية ومخرجات وحدود. عندما تختلف الأنظمة أو الضرائب أو الممارسات بين الدول، يجب اختيار البلد أو إدخال شروط الجهة الفعلية، ولا نقدم قاعدة محلية كأنها صالحة عالميًا.
02
نفصل محرك الحساب عن الواجهة والمحتوى
تحسين الخط أو الشرح لا يبرر تغيير معادلة معتمدة بصمت.
حساب قابل للتتبع
تُجمع المعادلات في منطق يمكن اختباره، وتظهر الافتراضات والتقريب ومصدر كل نتيجة جوهرية.
إصدار وحماية رجعية
أي تعديل حساس يحمل رقم إصدار، ويُختبر ضد حالات سابقة حتى لا تصلح ميزة وتكسر أخرى.
مبدأ ثابت
الحساب لا يصبح صحيحًا لأن الواجهة جميلة، والواجهة لا تصبح مفيدة لأن المعادلة صحيحة. نراجع الاثنين بصورة مستقلة ثم نختبر التجربة كاملة.
03
المحتوى جزء من المنتج وليس حشوًا حول الحاسبة
كل صفحة أداة يجب أن تساعد المستخدم حتى قبل إدخال أول رقم.
شرح متخصص
نوضح المشكلة، وتجهيز البيانات، وطريقة قراءة الإشارات، وحالة عملية، وأخطاء شائعة، وأسئلة قبل القرار. ترتيب هذه الأجزاء يختلف حسب طبيعة الأداة.
صوت طبيعي ومسؤول
نتجنب القوالب المتكررة واللغة التسويقية العامة. لا نخترع كاتبًا أو مراجعًا أو تجربة غير موجودة، ولا ننسب مراجعة مهنية لشخص لم يجرها.
فصل التفسير عن الحكم
الإشارة الرقمية تقود إلى سؤال وخطوة مراجعة، لا إلى اتهام أو قرار آلي. ويظل القرار النهائي مسؤولية المستخدم والجهة المختصة.
روابط ذات سبب
نربط الأداة بأداة أخرى عندما تكمل القرار: الربح بالسيولة، المبيعات بالمخزون، أو التوظيف بالرواتب؛ لا لمجرد زيادة الروابط.
04
نميز بين ثلاثة مستويات من الاختبار
نجاح فحص الكود لا يعني أن الصفحة تعمل على الاستضافة، وظهور الصفحة لا يعني أن الطباعة صحيحة.
فحص ثابت
صياغة PHP وJavaScript وJSON، وجود الملفات، فريدة المعرفات والمسارات، وعدم وجود مراجع مفقودة.
اختبار محلي
تشغيل الوحدة في بيئة اختبار، تجربة الحالات الحسابية، الاستيراد والتصدير، والتحقق من الاستجابة والأخطاء.
قبول حي
تثبيت WordPress الفعلي، الكاش والتصغير، الهاتف والوضع الداكن والطباعة وحفظ PDF. لا نصف الإصدار بأنه معتمد حيًا قبل هذه الخطوة.
05
هرم المصادر والمراجعة الدورية
المصدر الرسمي أقوى من المقالة، لكنه لا يلغي الحاجة إلى فهم نطاقه وتاريخ سريانه.
نبدأ بالنصوص والمعايير والجهات الرسمية عند شرح قاعدة أو متطلب، ثم نستخدم الأدلة المهنية أو المواد التعليمية للتوضيح. لا ننقل نصوصًا طويلة، بل نلخص الفكرة ونضع رابط المرجع عند الحاجة.
لا يتغير تاريخ المراجعة تلقائيًا لمجرد فتح الصفحة. يُحدّث عندما تُراجع المادة فعلًا، ويُسجل التغيير الجوهري في ملف الإصدار والاستمرارية. أما القوانين والضرائب والأنظمة المحلية فتحتاج تحققًا حديثًا قبل النشر.
06
حدود الأدوات جزء من الدقة
ذكر ما لا تغطيه الأداة يحمي المستخدم أكثر من إضافة توصية واثقة بلا أساس.
تعتمد النتائج على جودة المدخلات والتعريفات والفترة والافتراضات. قد تكون هناك عقود أو ضرائب أو سياسات أو أحداث لا تظهر في النموذج. لذلك تعرض الأداة تنبيهًا مهنيًا وتحث على الرجوع إلى السجلات الأصلية والمختص عند القرار الجوهري.
نستخدم التخزين المحلي في الأدوات الحالية حيثما هو موضح. هذا لا يغني عن حماية الجهاز والنسخ الاحتياطي وعدم إدخال بيانات شديدة الحساسية على جهاز مشترك.