عن المشروع

FED-SPA (Florida Establishment Directory — Spa & Parlor Assurance) هو دليل ثابت ذاتي الاستضافة لمؤسسات التدليك المرخصة في ولاية فلوريدا. بُني المشروع على ثلاثة قيود غير قابلة للتفاوض: لا خادم خلفي (ملفات ثابتة فقط، تُحدَّث مرة واحدة سنويًا)، لا اعتماديات خارجية (JavaScript/CSS خام، المكتبة القياسية للبايثون، التشفير الأصلي لـ Node، أُطر العمل الأصلية للمنصة فقط)، وإيقاع تحديث سنوي. تتكون مجموعة البيانات من مستويين. قائمة المرخصين هي سجل عام مُصدَر كملف JSON نصي، يمكن لأي شخص تدقيقه ونسخه (fork). أما مستوى قائمة المراقبة فيحتوي على المؤسسات التي لم يُعثر لها على تطابق ترخيص في بحث موثّق عبر بوابة إدارة الصحة في فلوريدا لضمان جودة الرعاية الطبية (MQA)؛ وهي مشفّرة عند التخزين باستخدام PBKDF2-SHA256 وAES-256-GCM، ولا تُفك تشفيرها إلا داخل التطبيق بعد أن يُدخل المشترك رمزًا مشتركًا. يحمل كل إدخال في قائمة المراقبة مصطلحات البحث الدقيقة والتاريخ في حقل status_note، مما يوضح أن "عدم العثور على ترخيص" هو حافز لطرح الأسئلة، وليس حكمًا. يتم توزيع مصدر حقيقة واحد (data/public/licensed.json بالإضافة إلى الغلاف المشفر) عبر سكربت توليد إلى ست واجهات منصات: تطبيق ويب تقدمي (PWA) قابل للتثبيت ويعمل دون اتصال، وإضافة كروم MV3 مع شارة نطاق ونافذة منبثقة سريعة، وتطبيق أندرويد مع روابط عميقة وودجت على الشاشة الرئيسية، وتطبيق مصاحب لأندرويد أوتو مع تقليل متعمد للبيانات، وتطبيق ساعة ذكية، وتطبيق iOS SwiftUI بدون أي اعتماديات SPM. قائمة المرخصين متاحة أيضًا بصيغة CSV. التحديث السنوي هو سير عمل بأمر واحد مع تحقق بشري في كل خطوة: إعادة التحقق من كل سجل مقابل بوابة MQA، وتحرير ملف JSON المصدر، والتحقق من صحة البيانات وفق المخطط (schema)، وإعادة تشفير قائمة المراقبة، وإعادة تشغيل سكربت التوزيع، ووضع علامة على الإصدار. كان الإصدار 2026.2 أول مسح كامل للمقاطعات على طول ممر US-1/Federal Hwy من فورت بيرس إلى هومستيد عبر 5 مقاطعات و112 بلدية، حيث نما عدد قائمة المرخصين من سجل واحد إلى 47 سجلًا، وامتلأت قائمة المراقبة بأول 44 إدخالًا. يحمل كل سجل ثلاثة حقول صادقة: verified_by (رابط البوابة)، وlast_checked (تاريخ التحقق)، وdata_as_of (تاريخ الإصدار). لا يدخل أي سجل إلى قائمة المرخصين دون أن تطّلع عينا المشرف على البوابة في ذلك اليوم. التصحيحات مرحب بها عبر قالب مشكلة (issue) مخصص. يؤكد المشروع على صفر خوادم، صفر متتبعات، وصفر كود من جهات خارجية. لا يتم إرسال رمز المشترك إلى أي مكان أبدًا — فهو موجود فقط في جلسة متصفح المستخدم، أو التخزين المحلي الاختياري، أو سلسلة مفاتيح الجهاز. مواصفات الغلاف المشفر عامة ومجمدة. المشروع مستقل وغير تابع لولاية فلوريدا أو أي وكالة، ويشدد ملف README مرارًا على أن البيانات لقطة وليست بثًا مباشرًا، وأنه يجب على المستخدمين دائمًا إعادة التحقق عبر بوابة MQA قبل اتخاذ أي قرار.