@masterteam/system-settings 0.0.11 → 0.0.13

package/README.md

@@ -3,6 +3,62 @@
 `mt-system-settings` loads and updates the host's system settings through the
 configured `apiBasePath` (default: `settings`).
 
+The retired generic `SMTP` setting is intentionally not rendered or updated.
+Outgoing notification email is managed through the Email Delivery routes below.
+
+## Email Delivery Control Panel
+
+`EMAIL_DELIVERY_ROUTES` provides the descriptor-driven Email Delivery page. It
+uses the backend HTTP contract directly; the production feature has no mock
+adapter or fixture fallback:
+
+```typescript
+{
+  path: 'email-delivery',
+  loadChildren: () =>
+    import('@masterteam/system-settings').then(
+      (module) => module.EMAIL_DELIVERY_ROUTES,
+    ),
+}
+```
+
+The default paths are relative to the host application's API base so the host
+authentication interceptor can attach the correct application origin:
+
+```typescript
+import { provideEmailDelivery } from "@masterteam/system-settings";
+
+provideEmailDelivery({
+  apiBasePath: "control-panel/email-delivery",
+  notificationApiBasePath: "Notifications",
+  permissionKeys: ["CONTROL_PANEL"],
+});
+```
+
+Those are the defaults, so `provideEmailDelivery` is only needed when a host
+must override a base path or its permission assertion. In Pplus they resolve to
+`/api/control-panel/email-delivery` and `/api/Notifications` after the Admin
+application API base is prepended.
+
+The page uses one `CONTROL_PANEL` access rule, one route with `Connections` and
+`Activity` tabs, and a collapsed Advanced Support section. Provider fields and
+actions come from `GET /api/control-panel/email-delivery/providers`; the error
+presentation uses `GET /api/control-panel/email-delivery/error-catalog`; secret
+values, external secret values, authorization URLs, and evidence exports are
+never retained in browser storage.
+
+Implementation and source-contract paths are indexed in
+[`../../../.github/instructions/email-delivery/Email-Delivery-Frontend-Implementation-Guide.md`](../../../.github/instructions/email-delivery/Email-Delivery-Frontend-Implementation-Guide.md).
+
+## General Settings Layout
+
+The responsive general-settings grid contains three cards:
+
+- **Date, Time & Weekend** for date/time formats and weekend days. The stored
+  timezone region is preserved but is not editable from this card.
+- **Currency** for the default currency and display format.
+- **Explore Experience** for the default Explore view.
+
 ## Host Cache Contract
 
 After a successful `getsystemsettings` response, and again after a successful

package/assets/i18n/ar.json

@@ -1,13 +1,13 @@
 {
   "system-settings": {
-    "general-configuration-title": "الإعدادات العامة",
-    "general-configuration-description": "سلوك عام للتطبيق يطبق على جميع المستخدمين.",
+    "general-configuration-title": "تجربة الاستكشاف",
+    "general-configuration-description": "اختر طريقة العرض التي يراها المستخدمون أولاً عند فتح صفحة الاستكشاف.",
     "explore-default-view": "طريقة العرض الافتراضية للاستكشاف",
     "explore-default-view-hint": "طريقة العرض التي تفتح بها صفحة الاستكشاف. يمكن للمستخدمين التبديل بينها في أي وقت.",
     "explore-default-view-cards": "البطاقات",
     "explore-default-view-timeline": "الخط الزمني",
     "page-title": "إعدادات النظام",
-    "page-subtitle": "إدارة العطلات, عطلات نهاية الأسبوع, المنطقة الزمنية, العملة, وSMTP من شاشة واحدة.",
+    "page-subtitle": "إدارة العطلات وعطلات نهاية الأسبوع والمنطقة الزمنية والعملة وسياسة الجدول الزمني من شاشة واحدة.",
     "save": "حفظ",
     "save-tooltip": "حفظ التغييرات   ",
     "cancel": "إلغاء",
@@ -25,10 +25,8 @@
     "holiday-range-error": "يجب أن يكون تاريخ الانتهاء في أو بعد تاريخ تاريخ البدء.",
     "no-holidays-title": "لم تتم إضافة أي عطلات بعد.",
     "no-holidays-description": "أضف صفًا للعطلات لتحديد فترات العطلات على مستوى المنتج.",
-    "timezone-title": "المنطقة الزمنية.",
-    "timezone-description": "اضبط المنطقة الزمنية وتنسيقات التاريخ والوقت الافتراضية.",
-    "timezone": "المنطقة الزمنية.",
-    "timezone-placeholder": "حدد المنطقة الزمنية.",
+    "date-time-weekend-title": "التاريخ والوقت وعطلة نهاية الأسبوع",
+    "date-time-weekend-description": "اضبط تنسيقات التاريخ والوقت الافتراضية واختر الأيام التي تُعامل كعطلة نهاية الأسبوع.",
     "date-format": "تنسيق التاريخ.",
     "date-format-placeholder": "حدد تنسيق التاريخ.",
     "time-format": "تنسيق الوقت.",
@@ -46,8 +44,6 @@
     "currency-placeholder": "حدد العملة.",
     "currency-format": "تنسيق العملة.",
     "currency-format-placeholder": "حدد تنسيق العملة",
-    "weekend-title": "عطلة نهاية الأسبوع",
-    "weekend-description": "اختر أيام الأسبوع التي تُعامل كأيام عطلة نهاية الأسبوع.",
     "weekend-days": "أيام عطلة نهاية الأسبوع",
     "weekend-placeholder": "حدد أيام عطلة نهاية الأسبوع",
     "monday": "الاثنين",
@@ -57,18 +53,6 @@
     "friday": "الجمعة",
     "saturday": "السبت",
     "sunday": "الأحد",
-    "smtp-title": "SMTP",
-    "smtp-description": "قم بتهيئة خادم SMTP المستخدم للبريد الإلكتروني الصادر.",
-    "smtp-mail": "البريد",
-    "smtp-mail-placeholder": "أدخل بريد المرسل الإلكتروني",
-    "smtp-name": "اسم العرض",
-    "smtp-name-placeholder": "أدخل اسم العرض",
-    "smtp-host": "المضيف",
-    "smtp-host-placeholder": "أدخل مضيف SMTP",
-    "smtp-port": "المنفذ",
-    "smtp-port-placeholder": "أدخل منفذ SMTP",
-    "smtp-password": "كلمة المرور",
-    "smtp-password-placeholder": "أدخل كلمة مرور SMTP",
     "saved-successfully": "تم حفظ الإعدادات بنجاح.",
     "no-changes-message": "لا توجد تغييرات لحفظها.",
     "timesheet-policy-title": "سياسة الجداول الزمنية",
@@ -130,5 +114,255 @@
     "working-days-placeholder": "حدد أيام العمل",
     "global-holidays": "تواريخ العطلات",
     "global-holidays-placeholder": "تواريخ بصيغة YYYY-MM-DD مفصولة بفواصل"
+  },
+  "email-delivery": {
+    "title": "تسليم البريد الإلكتروني",
+    "description": "قم بإعداد الاتصال المستخدم لإرسال بريد الإشعارات وراجع نشاط التسليم الأخير.",
+    "tabs": { "connections": "الاتصالات", "activity": "النشاط" },
+    "ready": "جاهز",
+    "needs-setup": "يحتاج إلى إعداد",
+    "unavailable": "غير متاح",
+    "loading": "جارٍ التحميل...",
+    "access-denied-title": "غير مصرح",
+    "access-denied-description": "يلزم إذن لوحة التحكم لإدارة تسليم البريد.",
+    "connections-title": "الاتصالات",
+    "connections-description": "إعداد اتصال مزود البريد المستخدم لإشعارات النظام والتحقق منه.",
+    "create-connection": "إضافة اتصال",
+    "connection-details": "تفاصيل الاتصال",
+    "connection-not-found": "الاتصال غير موجود",
+    "no-providers-title": "لا توجد مزودات متاحة",
+    "no-providers-description": "اطلب من المسؤول تفعيل مزود بريد معتمد.",
+    "no-connections-title": "لا توجد اتصالات بريد",
+    "no-connections-description": "أضف اتصال مزود معتمد لبدء الإعداد.",
+    "details": "التفاصيل",
+    "view-details": "عرض التفاصيل",
+    "edit": "تعديل",
+    "validate": "تحقق",
+    "authorize": "تفويض",
+    "test-send": "إرسال اختبار",
+    "bind": "استخدام للإشعارات",
+    "unbind": "إيقاف الاستخدام",
+    "use-for-notifications": "استخدام للإشعارات",
+    "stop-using": "إيقاف الاستخدام",
+    "delete": "حذف",
+    "revoke": "إلغاء التفويض",
+    "save": "حفظ",
+    "cancel": "إلغاء",
+    "close": "إغلاق",
+    "configured": "مُعدّ",
+    "not-configured": "غير مُعدّ",
+    "safe-settings": "الإعدادات الآمنة",
+    "connection-overview": "نظرة عامة على الاتصال",
+    "provider-settings": "إعدادات المزود",
+    "credential-status": "حالة بيانات الاعتماد",
+    "last-rotated": "آخر تدوير",
+    "no-credentials": "لا يحتوي هذا الاتصال على بيانات اعتماد محفوظة.",
+    "used-for-notifications": "مستخدم للإشعارات",
+    "yes": "نعم",
+    "no": "لا",
+    "authorization-state": "حالة التفويض",
+    "provider-warnings": "إرشادات المزود",
+    "connection": {
+      "name": "الاسم",
+      "provider": "المزود",
+      "authentication-mode": "طريقة تسجيل الدخول",
+      "sender": "المرسل",
+      "sender-address": "بريد المرسل",
+      "sender-display-name": "اسم المرسل",
+      "state": "الحالة",
+      "bindings": "يُستخدم لـ",
+      "last-validation": "آخر تحقق"
+    },
+    "editor": {
+      "create-title": "إضافة اتصال بريد",
+      "edit-title": "تعديل اتصال البريد",
+      "description": "اختر مزوداً متاحاً وأكمل الإعدادات التي يعلنها فقط.",
+      "basics": "الاتصال",
+      "configuration": "إعدادات المزود",
+      "credentials": "بيانات الاعتماد",
+      "select-provider-mode": "اختر المزود وطريقة الدخول لعرض الإعدادات.",
+      "update-invalidates-proof": "حفظ التغييرات يلغي إثبات التحقق والاختبار السابق. أعد التحقق والاختبار."
+    },
+    "credential": {
+      "operation": "إجراء التحديث",
+      "keep": "الاحتفاظ بالقيمة الحالية",
+      "replace": "استبدال القيمة",
+      "clear": "مسح القيمة",
+      "storage-choice": "تخزين بيانات الاعتماد",
+      "protected-value": "قيمة محمية",
+      "protected-value-hint": "تُرسل مرة واحدة وتُحمى قبل التخزين ولا يمكن عرضها لاحقاً.",
+      "external-reference": "مرجع سر خارجي",
+      "external-reference-hint": "يحفظ DevOps القيمة، بينما يحفظ Pplus اسم مرجع EmailSecrets فقط."
+    },
+    "validation": {
+      "host": "أدخل اسم مضيف DNS معتمداً، وليس localhost أو عنوان IP.",
+      "https-url": "أدخل رابط HTTPS معتمداً دون بيانات دخول أو أجزاء إضافية."
+    },
+    "test": {
+      "title": "إرسال اختبار مضبوط",
+      "real-email-warning-title": "سيؤدي هذا إلى إرسال بريد فعلي.",
+      "real-email-warning": "تحقق من المستلمين والمحتوى قبل الإرسال.",
+      "recipients": "المستلمون",
+      "recipients-placeholder": "name@example.com",
+      "recipients-hint": "أدخل من 1 إلى 100 عنوان مختلف.",
+      "recipients-invalid": "أدخل من 1 إلى 100 عنوان بريد صحيح ومختلف.",
+      "subject": "الموضوع",
+      "body": "المحتوى",
+      "html": "إرسال بصيغة HTML",
+      "send": "إرسال الاختبار",
+      "retrieve": "استرجاع النتيجة",
+      "timeout-title": "لم تصل نتيجة الإرسال.",
+      "timeout-description": "استرجع النتيجة المحفوظة بنفس معرف الطلب. لن يتم إرسال بريد آخر."
+    },
+    "accepted-unconfirmed": "قبله المزود — لم يتم تأكيد التسليم النهائي لصندوق البريد.",
+    "accepted-copy": "قبله المزود — لم يتم تأكيد التسليم النهائي لصندوق البريد.",
+    "outcome-unknown-warning": "نتيجة المزود غير معروفة. لا تعد الإرسال حتى يحقق المشغل.",
+    "outcome-unknown-copy": "نتيجة المزود غير معروفة. لا تعد الإرسال حتى يحقق المشغل.",
+    "activity-title": "محاولات التسليم الأخيرة",
+    "activity-description": "يظهر قبول المزود منفصلاً عن التسليم النهائي لصندوق البريد.",
+    "all-statuses": "كل الحالات",
+    "apply-filter": "تطبيق المرشح",
+    "attempt-details": "تفاصيل المحاولة",
+    "delivery-summary": "ملخص التسليم",
+    "technical-identifiers": "المعرّفات التقنية",
+    "no-attempts-title": "لا توجد محاولات تسليم",
+    "no-attempts-description": "ستظهر هنا محاولات الإشعارات والاختبارات الحديثة.",
+    "load-more": "تحميل المزيد",
+    "recipient-fingerprint": "بصمة المستلم",
+    "provider-request-id": "معرف طلب المزود",
+    "correlation-id": "معرف الارتباط",
+    "attempt": {
+      "id": "معرف المحاولة",
+      "status": "الحالة",
+      "status-filter": "تصفية حسب الحالة",
+      "provider": "المزود",
+      "created": "الوقت",
+      "count": "المحاولات",
+      "outcome": "نتيجة المزود"
+    },
+    "replay-attempt": "إعادة تشغيل المحاولة",
+    "replay-warning": "تُجدول الإعادة عملية مزود جديدة. تأكد من أن الإعادة آمنة.",
+    "replay-exceptional-warning": "قد يكون البريد الأصلي قد قُبل بالفعل. قد تؤدي الإعادة إلى تكراره وتتطلب موافقة استثنائية صريحة.",
+    "operator-reason": "سبب المشغل",
+    "operator-reason-hint": "مطلوب لسجل التدقيق؛ بحد أقصى 500 حرف.",
+    "exceptional-override": "أوافق على إعادة استثنائية",
+    "exceptional-override-hint": "استخدمه فقط بعد التحقيق في احتمال قبول الرسالة الأصلية.",
+    "confirm-action": "تأكيد",
+    "advanced-support": "الدعم المتقدم",
+    "advanced-support-description": "أدوات الاسترداد والأدلة للمشغلين المدربين.",
+    "quarantine-title": "عزل الإنهاء",
+    "quarantine-description": "نتائج تحتاج إلى استرداد أو إقرار من المشغل.",
+    "no-quarantine-title": "لا توجد نتائج معزولة",
+    "no-quarantine-description": "لا توجد عناصر للمراجعة.",
+    "recovery-classification": "تصنيف الاسترداد",
+    "code": "الرمز",
+    "issue": "المشكلة",
+    "detected": "وقت الاكتشاف",
+    "actions": "الإجراءات",
+    "retry": "إعادة المحاولة",
+    "acknowledge": "إقرار",
+    "retry-quarantine": "إعادة محاولة النتيجة المعزولة",
+    "acknowledge-quarantine": "الإقرار بالنتيجة المعزولة",
+    "quarantine-retry-warning": "أعد الإنهاء باستخدام نتيجة المزود المحفوظة.",
+    "quarantine-acknowledge-warning": "يُنهي الإقرار النتيجة المجهولة المرتبطة.",
+    "host-evidence-title": "أدلة المضيف",
+    "host-evidence-description": "أدلة يتيمة أو متعارضة أو غير محلولة. لا تتم معاينة ملفات التصدير أو حفظها.",
+    "no-evidence-title": "لا توجد أدلة مضيف",
+    "no-evidence-description": "لا توجد حالات أدلة غير محلولة.",
+    "evidence-kind": "نوع الدليل",
+    "evidence-occurrence-id": "معرف حالة الدليل",
+    "resolution-state": "حالة الحل",
+    "ownership-state": "حالة الملكية",
+    "export": "تصدير",
+    "repair": "إصلاح",
+    "repair-evidence": "إصلاح الدليل",
+    "acknowledge-evidence": "الإقرار بالدليل",
+    "evidence-repair-warning": "يستخدم الإصلاح أحدث رمز قرار وقد يحدث المحاولة المرتبطة.",
+    "evidence-acknowledge-warning": "يسجل الإقرار مراجعة الحالة دون إصلاح.",
+    "rebuild-evidence-index": "إعادة بناء فهرس الأدلة",
+    "rebuild-evidence-warning": "إعادة بناء فهرس الأدلة بميزانية فحص 200؟",
+    "scan-budget-exhausted": "اكتملت ميزانية الفحص. أعد البناء أو حمّل النتائج.",
+    "confirm": {
+      "unbind": "سيوقف هذا بريد الإشعارات لهذا الغرض.",
+      "delete": "حذف الاتصال غير المرتبط وبيانات اعتماده وتفويضه؟",
+      "revoke": "إلغاء التفويض المحفوظ؟ سيلزم تفويض واختبار جديدان."
+    },
+    "unknown-code": "حدث خطأ في تسليم البريد.",
+    "connection-created": "تم إنشاء الاتصال.",
+    "connection-updated": "تم تحديث الاتصال.",
+    "connection-deleted": "تم حذف الاتصال.",
+    "connection-bound": "يُستخدم هذا الاتصال الآن للإشعارات.",
+    "connection-unbound": "تم إيقاف بريد الإشعارات.",
+    "authorization-revoked": "تم إلغاء التفويض.",
+    "attempt-replay-scheduled": "تمت جدولة الإعادة.",
+    "quarantine-retry-submitted": "تم إرسال إعادة محاولة العزل.",
+    "quarantine-acknowledged": "تم الإقرار بعنصر العزل.",
+    "evidence-repaired": "تم إصلاح الدليل.",
+    "evidence-acknowledged": "تم الإقرار بالدليل.",
+    "evidence-index-rebuilt": "تمت إعادة بناء فهرس الأدلة.",
+    "status": {
+      "connection": {
+        "draft": "مسودة",
+        "pending-authorization": "في انتظار التفويض",
+        "pending-validation": "في انتظار التحقق",
+        "ready": "جاهز",
+        "reauthorization-required": "يلزم إعادة التفويض",
+        "conditional-access-required": "يلزم الوصول المشروط",
+        "disabled": "معطل",
+        "invalid": "غير صالح"
+      },
+      "attempt": {
+        "reserved": "محجوز",
+        "provider-invocation-started": "جارٍ الإرسال",
+        "provider-not-accepted": "لم يقبل المزود",
+        "reconciling": "جارٍ المطابقة",
+        "pending": "قيد الانتظار",
+        "blocked": "محظور",
+        "retry-scheduled": "تمت جدولة إعادة المحاولة",
+        "accepted": "قبله المزود",
+        "outcome-unknown": "النتيجة غير معروفة",
+        "failed-permanent": "فشل نهائي",
+        "dead-lettered": "يحتاج مراجعة المشغل"
+      },
+      "support": {
+        "active": "نشط",
+        "repair-pending": "الإصلاح قيد الانتظار",
+        "repaired": "تم الإصلاح",
+        "acknowledgement-pending": "الإقرار قيد الانتظار",
+        "conflict": "تعارض",
+        "owned": "مملوك",
+        "missing": "مفقود",
+        "identity-incomplete": "الهوية غير مكتملة",
+        "retryable-after-upgrade": "إعادة المحاولة بعد الترقية",
+        "repair-required": "يلزم الإصلاح",
+        "acknowledge-only": "إقرار فقط",
+        "configured": "مُعدّ",
+        "not-configured": "غير مُعدّ",
+        "acknowledged": "تم الإقرار"
+      }
+    },
+    "error-actions": {
+      "refresh": "حدّث أحدث حالة",
+      "request_permission": "اطلب الصلاحية المطلوبة",
+      "authorize": "فوّض الاتصال",
+      "retry_later": "حاول مرة أخرى لاحقاً",
+      "poll_status": "تحقق من الحالة المحفوظة",
+      "review_evidence": "راجع أدلة الاسترداد",
+      "inspect_notification": "راجع إعدادات الإشعارات",
+      "contact_administrator": "تواصل مع مسؤول النظام",
+      "correct_input": "صحح المعلومات المدخلة",
+      "correct_configuration": "صحح إعداد الاتصال",
+      "contact_support": "تواصل مع الدعم"
+    },
+    "codes": {
+      "email.ready": "تسليم البريد جاهز.",
+      "email.not_ready": "أكمل إعداد الاتصال والتحقق والاختبار.",
+      "email.management_disabled": "إدارة تسليم البريد غير متاحة.",
+      "email.validation_succeeded": "نجح التحقق من الاتصال.",
+      "email.authorization_completed": "اكتمل تفويض صندوق البريد.",
+      "email.delivery_result_quarantined": "تحتاج نتيجة التسليم إلى مراجعة.",
+      "email.secret_unavailable": "بيانات الاعتماد غير متاحة.",
+      "email.concurrency_conflict": "تم تغيير العنصر. حدّث وحاول مرة أخرى."
+    }
   }
 }