توثيق عام

ما يثبته Bz Info كنظام.

قراءة تحريرية للمعمارية: frontend متعدد اللغات، backend NestJS، chat realtime، analytics first-party، admin وجودة.

مصداقية عبر المنتج

الموقع نفسه دليل: محتوى محلي، API، admin، realtime، SEO وتوثيق متماسك.

احترام الزائر

التفاعلات مفيدة ومحدودة وprivacy-first، بدون تتبع عدواني.

قابلية الصيانة

المحتوى، المسارات، المكونات والعقود مفصولة لتتطور بوضوح.

خريطة القراءة

تتبع الأقسام المسار الحقيقي من النظام العام إلى التشغيل.

Frontend

الصفحات تنسق فقط؛ النصوص والمسارات والmetadata مركزية.

Backend

Contact، availability، chat، chatbot، leads، notifications، audit logs وanalytics.

Admin

طلبات، leads، محادثات، availability، monitoring، logs وإحصاءات نافعة.

الجودة

Typecheck، lint، build، اختبارات module، smoke flows وتوثيق.

التوثيق المفيد يربط الموقع، API، admin، الجودة والقرارات.

يربط التوثيق بين ما يقوله الموقع العام، ما تضمنه API، ما تشغله admin workflows، وما تجعل تقارير الجودة قابلاً للقرار.

Public site

رسائل، صفحات SEO ودليل مرئي.

API contracts

Routes، forms، validation وأخطاء متوقعة.

Admin workflows

قراءة تشغيلية للطلبات والمحتوى.

Quality reports

Build، typecheck، URL audit وإشارات مبكرة.

Decisions

أولويات المنتج، المخاطر والاستعداد للإنتاج.

Frontend

Next.js، محتوى typed وSEO متعدد اللغات

الصفحات تنسق فقط؛ النصوص والمسارات والmetadata مركزية.

مسارات fr/en/ar/es/de/nl بتطابق منطقي ثابت.

RTL عربي على مستوى document.

Metadata وcanonical وhreflang وOpen Graph لكل صفحة.

Backend

API NestJS للتحويل والتشغيل

Contact، availability، chat، chatbot، leads، notifications، audit logs وanalytics.

DTOs محققة وSwagger.

Socket.IO للزوار وadmin.

لا أسرار IA في frontend.

Admin

Back-office للمراقبة

طلبات، leads، محادثات، availability، monitoring، logs وإحصاءات نافعة.

مصادقة admin خاصة.

محادثات support realtime.

Analytics للقرار لا للاستعراض.

الجودة

تحقق عملي

Typecheck، lint، build، اختبارات module، smoke flows وتوثيق.

Scripts حقيقية.

الحفاظ على عقود API.

فصل التوثيق الداخلي عن العام.

معمارية حية

التوثيق العام يظهر الصرامة دون كشف أسرار.

لتدقيق أو مهمة backend أو منصة كاملة، شارك السياق عبر صفحة التواصل.

ناقش نظاماً عرض المشاريع