المراسلات الرسمية — نظام توليد الرسائل الرسمية بالذكاء الاصطناعي

نظام ويب محلي يصيغ الرسائل الرسمية العربية المطبوعة (على الورق المروّس) بالذكاء الاصطناعي، ويصدّرها بصيغتي Word (DOCX) و PDF، مع أرشيف كامل وترقيم مرجعي تلقائي.

النظام عام: يدعم أي منشأة أو شركة — أضف منشآتك بترويساتها الخاصة من صفحة «المنشآت».

التثبيت على Windows (الأسهل)

حمّل مثبّت Correspondence-Setup-x.y.z.exe من صفحة الإصدارات وشغّله — لا يحتاج صلاحيات مدير ولا تثبيت Python. بعد التثبيت افتح النظام من اختصار «المراسلات الرسمية» في قائمة ابدأ (إغلاق نافذته يوقف النظام).

بياناتك (القاعدة، الترويسات، المخرجات، الإعدادات) تُحفظ في %LOCALAPPDATA%\Correspondence وتبقى سليمة عند الترقية أو إزالة التطبيق. لتصدير PDF يلزم وجود Microsoft Word أو LibreOffice (بدونهما يصدر Word فقط).

التشغيل من المصدر

انقر نقرًا مزدوجًا على run.bat — سيقوم في المرة الأولى بإنشاء بيئة بايثون وتثبيت المتطلبات، ثم يفتح النظام في المتصفح على: http://127.0.0.1:8797

المتطلبات: Python 3.10+ (بأمر py)، و Microsoft Word أو LibreOffice لتصدير PDF (بدونهما يصدر Word فقط).

إعداد الذكاء الاصطناعي

من صفحة «الإعدادات» اختر المزود وأدخل مفتاحه — المدعوم: OpenAI، وAnthropic (Claude)، وOpenRouter، وGroq، وDeepSeek، وTogether AI، وOllama المحلي (خصوصية كاملة بلا مفتاح)، وأي مزود متوافق مع OpenAI API. فوق حقل المفتاح رابط مباشر لصفحة إنشاء المفاتيح لدى كل مزود.

بدلًا من الواجهة يمكن الإعداد من ملف .env: انسخ .env.example باسم .env وضع فيه المفتاح (مثل OPENAI_API_KEY=sk-... أو ANTHROPIC_API_KEY=...) — قيم .env لها الأولوية على المحفوظ في الواجهة، والملف مستثنى من git.

بدون مفتاح يمكن تجربة النظام بزر «توليد تجريبي».

خادم MCP لوكلاء الذكاء الاصطناعي

mcp_server.py يجعل توليد الرسائل وتنقيحها وتصديرها والبحث في الأرشيف أدواتٍ بيد أي عميل MCP، ويعمل مباشرة على قاعدة البيانات المحلية دون حاجة لتشغيل خادم الويب. مثال الإعداد في Claude Code:

claude mcp add correspondence -- python المسار\إلى\correspondence\mcp_server.py

وفي النسخة المثبَّتة استخدم %LOCALAPPDATA%\Programs\Correspondence\CorrespondenceMCP.exe مباشرة.

طريقة الاستخدام

1. رسالة جديدة: اختر المنشأة والجهة المستلمة ونوع الرسالة وحدّة الرسالة (ودّية / رسمية محايدة / حازمة / شديدة اللهجة)، واكتب مضمون الرسالة بلغتك العادية (الوقائع، المبالغ، التواريخ، المطلوب) — ثم «توليد».
2. التحرير: عدّل أي حقل أو فقرة، أضف جداول ونقاط، وشاهد المعاينة الحية فوق الترويسة.
3. التنقيح بالذكاء: اكتب توجيهًا مثل «اجعل النبرة أشد حزمًا» وسيعيد النظام الصياغة.
4. التصدير: زر «تصدير Word + PDF» ينشئ الملفين في data/output/ ويحمّلهما.
5. الأرشيف: كل الرسائل محفوظة مع البحث والتصفية.

مصمّم الترويسة

لا تملك ورقًا مروّسًا جاهزًا؟ من صفحة «المنشآت» زر «🎨 تصميم الترويسة» يولّد ترويسة احترافية من بيانات المنشأة: الاسم العربي والإنجليزي، العنوان، أرقام التواصل، البريد والموقع، مع شعار اختياري (يفضَّل PNG بخلفية شفافة).

• ثلاثة قوالب (كلاسيكي / شريط ملوّن / بسيط أنيق) مع اختيار اللون الأساسي ومعاينة حية.
• تُولَّد الصورة بدقة الطباعة الكاملة (2550×3300 بكسل ≈ 300DPI) وتُعتمد تلقائيًا ترويسةً للمنشأة.
• البيانات والقالب واللون تُحفظ مع المنشأة، فيمكن لاحقًا تعديل أي حقل وإعادة التوليد بنقرة.
• ولمن لديه ورق مروّس معتمد: زر «رفع ترويسة جاهزة» يبقى كما هو.

الترقيم التسلسلي المزدوج

• ترقيم عام: مرجع تلقائي بصيغة السنة-التسلسل (مثل 26-117) لكل منشأة وسنة، قابل للتعديل اليدوي من المحرر.
• ترقيم خاص بكل جهة: يحتفظ النظام أيضًا بتسلسل رسائل كل منشأة إلى كل جهة مستلمة على حدة، ويظهر في المحرر («الرسالة رقم N إلى هذه الجهة»).

الإشارة إلى مراسلات سابقة

عند إنشاء رسالة جديدة، افتح قسم «الإشارة إلى مراسلات سابقة» واختر:

• رسائل صادرة من أرشيف النظام، أو
• كتبًا واردة سجّلتها في صفحة «الوارد» (مرجعهم، تاريخهم، موضوعهم، وملخصها)

فيفتتح الذكاء الاصطناعي الرسالة بصيغة الإشارة الرسمية الصحيحة («بالإشارة إلى كتابنا رقم (…) وتاريخ …» أو «بالإشارة إلى كتابكم رقم (…)»)، ويلتزم بوقائع الرسائل المُشار إليها حرفيًا دون اختلاق. تظهر الإشارات كشارات في محرر الرسالة، ويمكن فتح الرسالة الصادرة المُشار إليها بنقرة.

القوالب الشخصية

من محرر أي رسالة، زر «💠 حفظ كقالب» يحفظها كقالب يُعاد استخدامه. في صفحة «رسالة جديدة» تظهر قوالبك المحفوظة — «إنشاء رسالة» ينشئ مسودة فورية من القالب بمرجع وتاريخ جديدين (دون استهلاك ذكاء اصطناعي)، تعدّلها ثم تصدّرها. مناسب للرسائل الروتينية المتكررة.

سلسلة المراسلات

عند فتح رسالة مرتبطة بمراسلات أخرى (عبر الإشارات)، يعرض المحرر قسم «🧵 سلسلة المراسلات»: خيط زمني يجمع كل الصادر والوارد المرتبط بالقضية نفسها — حتى عبر أكثر من درجة (الرسالة الأصلية ← الرد ← التذكير…)، مع فتح أي رسالة صادرة بنقرة.

سجل الوارد

صفحة «الوارد» لتسجيل الكتب الواردة إليكم من الجهات — تُستخدم للإشارة إليها في ردودك، وتبني مع الأرشيف الصادر ملف مراسلات متكامل لكل قضية.

الجهات المستلمة

صفحة «الجهات المستلمة» هي دفتر عناوين: أي جهة جديدة تكتبها عند التوليد تُحفظ تلقائيًا، ويمكنك ضبط لقب المخاطبة لكل جهة (الأخوة / الأستاذ القدير / معالي…) وصيغة الاحترام، فيستخدمها الذكاء الاصطناعي في سطر المستلم تلقائيًا.

إدارة المنشآت

صفحة «المنشآت»: أضف أي منشأة (الاسم، الموقّع، التحية والخاتمة الافتراضية) وارفع ترويستها كصورة صفحة كاملة (PNG/JPG) — تُطبع خلف نص الرسالة في Word وPDF تمامًا كالورق المروّس. حذف منشأة لها رسائل يعطّلها فقط حفاظًا على الأرشيف، ويمكن إعادة تفعيلها.

البنية التقنية

المكوّن	التقنية
الخادم	FastAPI (بايثون) على منفذ 8797 محليًا
قاعدة البيانات	SQLite في data/correspondence.db
الصياغة	عدة مزودات: OpenAI وAnthropic وOpenRouter وGroq وDeepSeek وTogether وOllama ومخصص
توليد Word	python-docx — صفحة Letter، خط DIN Next LT Arabic، RTL كامل
توليد PDF	Microsoft Word (COM) أو LibreOffice احتياطيًا
الواجهة	HTML/JS/CSS عربية RTL بدون اعتماديات
التاريخ الهجري	hijridate (أم القرى)

ملفات المشروع الرئيسية في app/، والفحص التشغيلي في scripts/smoke_test.py:

.venv\Scripts\python.exe scripts\smoke_test.py

خصوصية البيانات

كل شيء محلي على جهازك (قاعدة البيانات، الترويسات، الملفات المصدَّرة). الاستثناء الوحيد: نص الرسالة يُرسل إلى مزود الذكاء الاصطناعي المُعدّ عند التوليد أو التنقيح — ومع مزود Ollama المحلي لا تغادر بياناتك الجهاز إطلاقًا.

بياناتك الخاصة كلها خارج المستودع: مجلد data/ (القاعدة والمخرجات والإعدادات)، والترويسات المرفوعة، وملف .env — جميعها في .gitignore، والبيانات الظاهرة في الكود والأمثلة وهمية بالكامل.

الرخصة

مفتوح المصدر برخصة MIT — المساهمات مرحّب بها.