خدمة OCR وتحويل الصوت إلى نصOCR and speech-to-text service
خدمة داخلية واحدة بست وظائف (تفريغ صوت، OCR وتحليل مستندات، استخراج الإشعارات، RAG، تحليل الأحكام، تنقيح البيانات الشخصية) (الوثيقة المعمارية). تبدأ في المرحلة 2 بالتفريغ بعد الجلسة والتنقيح وهيكلة مسودة التقرير (التقييم الهندسي).
بطاقة الميزة
| البند | القيمة |
|---|---|
| 1. اسم الميزة | خدمة OCR وتحويل الصوت إلى نص — OCR and speech-to-text service |
| 2. المعرّف (Feature ID) | B32 |
| 3. مصدر المتطلب | تقييم القرارات الهندسية: الخدمة في المرحلة 2 (Whisper، التنقيح، هيكلة التقرير)، الوثيقة المعمارية: الخدمة عديمة الحالة |
| 4. تصنيف المحتوى | متطلب وارد في الملفات خدمة FastAPI داخلية عديمة الحالة تبدأ بالتفريغ والتنقيح وهيكلة التقرير. اقتراح هندسي الواجهات. |
| الوحدة | الذكاء الاصطناعي |
| الأدوار المعنية | محامٍ، سكرتارية |
| درجة الخطورة | متوسطة |
| حالة الاعتماد | معتمد في الوثائق |
| المنصات المرتبطة | استضافة نماذج الذكاء داخل المملكة |
5الهدف التجاري والمشكلة التي تعالجها
المحامي بعد الجلسة يتكلم أسهل مما يكتب B10 تقارير الجلسات ومخرجاتها، والمستندات الممسوحة تحتاج نصًا للبحث B13 المستندات والإصدارات والأرشفة والأصول الورقية.
6المجال القانوني المرتبط للمطوّر غير المتخصص
التسجيلات والمستندات بيانات شخصية: المعالجة داخل المملكة حماية البيانات الشخصية والذكاء الاصطناعي.
7المستخدمون والأدوار والصلاحيات
لا واجهة مباشرة؛ تستدعيها الميزات من الخادم.
8شروط البدء والاعتماديات
خادم GPU داخل المملكة، نماذج محلية.
9السيناريو الأساسي خطوة بخطوة
- Frappe يرفع الملف للخدمة برمز خدمة.
- الخدمة تعالج ولا تحفظ شيئًا (عديمة الحالة).
- تعيد النص أو البنية؛ Frappe يحفظ.
10السيناريوهات البديلة والاستثناءات
صوت طويل: تقسيم ومعالجة في طابور long. الخدمة متوقفة: إعادة محاولة وإبقاء المستند بلا نص مع شارة.
11المدخلات والحقول
لا حقول إدخال خاصة بهذه الميزة؛ تستخدم حقول الكيانات المشار إليها في نموذج البيانات.
12المخرجات والإشعارات والسجلات والتقارير
نص مستخرج، مسودة تقرير منظمة، خريطة تنقيح.
13قواعد العمل بصيغة قابلة للتحويل إلى كود
RULE B32.1 service is internal only; not internet-exposed
RULE B32.2 stateless: no persistence of client data in service
RULE B32.3 PII redaction before any LLM step; restore after
RULE B32.4 model files local; no runtime download14حالات السجل وانتقالاتها وشروطها
لا ينطبق على هذه الميزة.
15نموذج البيانات والعلاقات والقيود والفهارس
لا تخزين في الخدمة.
16DocTypes المطلوبة في Frappe
لا ينطبق على هذه الميزة.
17الشاشات والعناصر والأزرار ورسائل الخطأ
لا ينطبق على هذه الميزة.
18خدمات Backend ومسؤولية كل خدمة
| الواجهة الداخلية | الوظيفة |
|---|---|
/v1/transcribe | صوت ← نص |
/v1/ocr | صورة/PDF ← نص |
/v1/redact | نص ← نص منقح + خريطة |
/v1/structure/hearing-report | نص ← حقول التقرير |
/v1/notices/extract | إشعار ← حقول B28 قارئ الإشعارات الحكومية |
19واجهات API الداخلية
لا توجد واجهة API خاصة بهذه الميزة.
20الأحداث والمهام الخلفية والجدولة وإعادة المحاولة
طابور long للتفريغ وOCR (الوثيقة المعمارية).
21التكاملات المرتبطة بالميزة وحدودها
استضافة نماذج الذكاء داخل المملكة.
22الأمن والخصوصية والتدقيق والاحتفاظ والحذف
TLS بين Frappe والخدمة (دليل المطور ص16). رمز خدمة في الخزنة.
23حالات الاختبار
| المعرّف | النوع | السيناريو | النتيجة المتوقعة |
|---|---|---|---|
B32-T01 | طبيعي | ملاحظة صوتية عربية اصطناعية | نص قابل للتعديل. |
B32-T02 | أمني | فحص الخدمة بعد الطلب | لا ملفات محفوظة. |
B32-T03 | أمني | الوصول للخدمة من الإنترنت | مرفوض. |
24معايير القبول
- عديمة الحالة وداخلية.
25تعريف الاكتمال (Definition of Done)
- كل قواعد العمل في هذه الصفحة منفذة في الخادم (Controller أو Service)، لا في الواجهة وحدها.
- حالات الاختبار المذكورة هنا مكتوبة اختباراتٍ آلية في إطار اختبار Frappe، وتنجح مع كل دفعة كود.
- اختبارات الصلاحيات تثبت أن مستخدمًا خارج فريق الملف لا يرى السجل في القائمة ولا برابطه المباشر ولا في البحث العام ولا في العدّادات.
- الحقول المخصصة والأدوار ومسارات الاعتماد مُصدَّرة في Fixtures التطبيق، وتظهر بعد تثبيت نظيف على موقع فارغ دون إعداد يدوي.
- لا تعديل في ملفات Frappe أو ERPNext.
- كل قيمة قانونية (مدة، نسبة، مبلغ، قائمة) محفوظة في إعداد قابل للتعديل، وموسومة بحالة اعتمادها.
- نصوص الواجهة ورسائل الخطأ بالعربية، وتخبر المستخدم بما يفعله.
- معايير القبول في هذه الصفحة مُتحقق منها ومسجلة في مصفوفة التتبع.
26القرارات المفتوحة والمخاطر والاعتمادات المطلوبة
نماذج التفريغ وOCR العربية المختارة تُقيَّم على عينات المكتب غير مثبت.