تخطي إلى المحتوى الرئيسي

البنية المعمارية

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

نظرة عامة على المنظومة​

يتألف ChurchApps من نحو 20 مستودعاً مستقلاً (وليس مستودعاً أحادياً). تتواصل تطبيقات العميل مع مجموعة صغيرة من واجهات API الخلفية عبر HTTPS وWebSocket، وتتشارك الشيفرة البرمجية عبر حزم npm المنشورة ضمن النطاق @churchapps.

┌────────────────────────────────┐            ┌──────────────────────────────────────────────┐
│ Clients │ │ Api — core modular monolith (AWS Lambda) │
│ │ │ │
│ B1Admin staff dashboard │ HTTPS │ membership attendance content │
│ B1App member portal + │ ─────────▶ │ giving messaging doing │
│ church websites │ │ │
│ B1Checkin check-in kiosk │ ◀───WS───▶ │ one MySQL database per module (6 total) │
│ │ └──────────────────────────────────────────────┘
│ FreePlay TV content player │ ┌──────────────────────────────────────────────┐
└───────────────┬────────────────┘ │ LessonsApi — Lessons.church backend │
│ └──────────────────────────────────────────────┘
│ shared code via npm (@churchapps/*)
▼
helpers (cross-app interfaces) · apphelper (React components) · apihelper (Express/server utilities)

هناك قاعدتان بنيويتان تشكّلان كل ما يُوثَّق في هذا القسم:

  1. الوحدات معزولة. تمتلك كل وحدة من وحدات Api قاعدة بياناتها وجداولها، ولا تصل الوحدات الأخرى والتطبيقات إلى بياناتها إلا من خلال نقاط نهاية REST الخاصة بها. انظر بنية الوحدة.
  2. الشيفرة المشتركة تُنشر كحزم npm. لا تستورد التطبيقات شيفرة مصدرية بعضها من بعض، وأي شيفرة يُعاد استخدامها تعبر حدود المستودعات عبر @churchapps/helpers أو @churchapps/apphelper أو @churchapps/apihelper. انظر المكتبات المشتركة.

خرائط الأنظمة​

الصفحةما تغطيهالنطاق
الإشعارات والتذكيراتكيف يُبلغ النظام الشخصَ بأي شيء: بوابتا الإرسال، وسلسلة تصعيد القنوات، ومحرك التذكيراتApi (messaging)، B1Admin، B1App
البنية الفوريةإطار تسليم WebSocket الذي تقوم عليه الدردشة والحضور والتسليم داخل التطبيقApi (messaging)، جميع تطبيقات الويب
إشعارات الويب (Web Push)قناة الإشعارات الفورية في المتصفح: مفاتيح VAPID، وتخزين الاشتراكات، والتسليمApi (messaging)، جميع تطبيقات الويب
التبرعاتمزودو الدفع والبوابات، وتدفقات التبرع، والصناديق والدفعات، وwebhooks البواباتApi (giving)، apphelper، B1App، B1Admin
تسجيلات الفعالياتنموذج التجارة الخاص بالتسجيل: أنواع المشاركين، والاختيارات، ورموز الخصم، والمدفوعات عبر بوابة التبرعات، وقائمة الانتظارApi (content + giving)، B1App، B1Admin
تسجيل الحضورتسجيل الحضور عبر الكشك والخدمة الذاتية، ونموذج بيانات الحضور، وتوجيه الغرف، وطبقة حماية الأطفال، وطباعة الملصقاتB1Checkin، B1App، B1Admin، Api (attendance + membership)
منشئ المواقعشجرة الصفحات والأقسام والعناصر، وعقد أنواع العناصر ومعالجاتها، والمدونة، والصفحات المقيّدة بالوصول، وتحسين محركات البحث، وتوليد الذكاء الاصطناعيApi (content)، AskApi، helpers/apphelper، B1Admin، B1App
توجيه المواقع وتعدد المواقعكيفية ربط الطلب بكنيسة وموقع محدد، ونموذج البيانات متعدد المواقع بالمعرّف siteId، وطبقة الحافة Caddy للنطاقات المخصصةB1App، Api (membership + content)، B1Admin
التكاملاتسطح التوسعة: OAuth، ومفاتيح API، وwebhooks، ومزودو المحتوى، وMCPApi، المكتبات المشتركة، تطبيقات خارجية
سجل التدقيق والدفعات القابلة للتراجعتدقيق مفعّل افتراضياً لكل عملية تعديل عند نقطة التحكم في المتحكِّمات، وطبقة الدفعات التي تجعل الاستيراد والإجراءات الجماعية قابلة للتراجعApi (جميع الوحدات)، B1Admin، B1Transfer
MinistryStuffخدمة التخزين المدفوعة وأرصدة الرسائل النصية: هوية JWT المشتركة، وS2S بمفتاح الخدمة، ونقاط الربط لمزودي الرسائل النصية والتخزين، وفوترة StripeMinistryStuffApi، MinistryStuffWeb، Api (content + messaging)، حزم texting/apihelper، B1Admin
التخزين بمزودك الخاص (BYOS)تربط الكنائس Google Drive أو Dropbox أو OneDrive أو حاوية S3 متوافقة للرفع يتجاوز حد 100 ميغابايت المجاني: ربط OAuth، وأشكال الرفع لكل مزود، وإعادة التوجيه العامة للتنزيلApi (content + membership)، حزم helpers/apphelper، B1Admin، B1App
محتوى المجتمع (Content Commons)طبقة الأصول والتقديمات المشتركة التي تقوم عليها المحتويات التي ينشئها المستخدمون عبر المنتجات، وقائمة المراجعة الموحدة الخاصة بالموظفين فقط في إدارة الخادم بتطبيق B1AdminApi (وحدة commons)، B1Admin، WorshipCommons، Lessons.church، FreeShow
نصيحة

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

المقترحات​

تصف هذه المستندات أعمالاً مقترحة للمراجعة، وليست سلوكاً متاحاً في المنتج.

المقترحما يغطيه
Twilio BYOKحساب ومفاتيح ورقم خدمة ورقم هاتف مملوكة للكنيسة؛ ونطاق التكامل، والموافقة، والتسليم، والتقديرات، وفحوص الإطلاق
مسودة تأهيل كنائس Twilioإعدادات نموذج التسجيل المقترحة في B1، وأمثلة حملات خاصة بالكنائس، وقوائم التحقق للموافقة والتشغيل