You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 

556 lines
32 KiB

# backend/apps/hadis/management/commands/seed_reliabilities_and_rutbas.py
import os
import sys
import django
from django.core.management.base import BaseCommand
from django.db import transaction
# Setup django if executed directly
if __name__ == "__main__":
sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "../../../..")))
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "config.settings.base")
django.setup()
from apps.hadis.models import TransmitterReliability, BookAuthorRutba
# ==============================================================================
# CANONICAL TRANSMITTER RELIABILITIES (وضعیت راویان)
# ==============================================================================
RELIABILITY_DEFINITIONS = [
{
"key": "very_reliable",
"match_slugs": ["very-reliable", "супернадежный"],
"default_slug": "very-reliable",
"color": "green",
"title": [
{"language_code": "ar", "title": "ثقة ثقة (ثبت)", "text": "ثقة ثقة (ثبت)"},
{"language_code": "ru", "title": "Очень надежный (Суперисточник)", "text": "Очень надежный (Суперисточник)"},
{"language_code": "en", "title": "Very Reliable (Highest Trust)", "text": "Very Reliable (Highest Trust)"},
{"language_code": "fa", "title": "بسیار قابل اعتماد (ثقه ثقه)", "text": "بسیار قابل اعتماد (ثقه ثقه)"},
],
"description": [
{
"language_code": "ar",
"title": "راوٍ في أعلى درجات التوثيق والعدالة والضبط",
"text": "راوٍ في أعلى درجات التوثيق والعدالة والضبط، متقن لحفظه وروايته، تُقبل رواياته وتعتبر من أصح الأسانيد وتُقدم عند التعارض.",
},
{
"language_code": "ru",
"title": "Передатчик наивысшей степени надежности и точности",
"text": "Передатчик наивысшей степени надежности, точности и справедливости. Его предания считаются достоверными и служат веским доводом в шариатских вопросах.",
},
{
"language_code": "en",
"title": "A narrator of the highest degree of trustworthiness",
"text": "A narrator of the highest degree of trustworthiness, precision, and moral integrity. His narrations are considered authentic and serve as core foundational proof.",
},
],
},
{
"key": "reliable",
"match_slugs": ["reliable", "надежный"],
"default_slug": "reliable",
"color": "blue",
"title": [
{"language_code": "ar", "title": "ثقة", "text": "ثقة"},
{"language_code": "ru", "title": "Надежный (Сика)", "text": "Надежный (Сика)"},
{"language_code": "en", "title": "Reliable (Thiqah)", "text": "Reliable (Thiqah)"},
{"language_code": "fa", "title": "قابل اعتماد (ثقه)", "text": "قابل اعتماد (ثقه)"},
],
"description": [
{
"language_code": "ar",
"title": "راوٍ عدل ضابط متفق على أمانته",
"text": "راوٍ عدل ضابط متفق على أمانته وصدقه، تقبل أخباره ويُحتج بحديثه في الأحکام الشرعية والأصول.",
},
{
"language_code": "ru",
"title": "Достоверный и добросовестный передатчик",
"text": "Достоверный, справедливый и добросовестный передатчик с проверенной точностью передачи. Его хадисы принимаются как авторитетный довод.",
},
{
"language_code": "en",
"title": "A trustworthy and upright narrator",
"text": "A trustworthy and upright narrator whose accuracy is established. His narrations are accepted and cited as authoritative proof.",
},
],
},
{
"key": "acceptable",
"match_slugs": ["acceptable", "правдивый"],
"default_slug": "acceptable",
"color": "yellow",
"title": [
{"language_code": "ar", "title": "صدوق (حسن الحديث)", "text": "صدوق (حسن الحديث)"},
{"language_code": "ru", "title": "Приемлемый (Правдивый / Садук)", "text": "Приемлемый (Правдивый / Садук)"},
{"language_code": "en", "title": "Acceptable (Truthful / Hasan)", "text": "Acceptable (Truthful / Hasan)"},
{"language_code": "fa", "title": "قابل قبول (صدوق / حسن)", "text": "قابل قبول (صدوق / حسن)"},
],
"description": [
{
"language_code": "ar",
"title": "راوٍ صادق في نفسه لم يبلغ تمام الضبط",
"text": "راوٍ صادق في نفسه لم يبلغ تمام الضبط، حديثه في مرتبة الحسن ويصلح للاحتجاج به أو المتابعة والاعتبار.",
},
{
"language_code": "ru",
"title": "Правдивый передатчик с хорошей репутацией",
"text": "Правдивый передатчик, чья точность передачи немного уступает высшей степени. Его хадисы считаются хорошими (хасан) и принимаются во внимание.",
},
{
"language_code": "en",
"title": "A truthful narrator of good standing",
"text": "A truthful narrator whose precision is moderately lower than the highest standard. His hadiths are considered good (hasan) and accepted.",
},
],
},
{
"key": "weak",
"match_slugs": ["weak", "слабый"],
"default_slug": "weak",
"color": "orange",
"title": [
{"language_code": "ar", "title": "ضعيف", "text": "ضعيف"},
{"language_code": "ru", "title": "Слабый (Даиф)", "text": "Слабый (Даиф)"},
{"language_code": "en", "title": "Weak (Da'if)", "text": "Weak (Da'if)"},
{"language_code": "fa", "title": "ضعیف", "text": "ضعیف"},
],
"description": [
{
"language_code": "ar",
"title": "راوٍ خف ضبطه أو كثرت أخطاؤه",
"text": "راوٍ خف ضبطه أو كثرت أوهامه وأخطاؤه، فلا يُحتج بما ينفرد به، لكن يُستأنس بحديثه في الشواهد والمتابعات إذا لم يكن شديد الضعف.",
},
{
"language_code": "ru",
"title": "Передатчик со слабой памятью или частыми ошибками",
"text": "Передатчик со слабой памятью или частыми ошибками; его предания не служат самостоятельным доказательством, но могут учитываться как свидетельство.",
},
{
"language_code": "en",
"title": "A narrator with memory shortcomings",
"text": "A narrator with shortcomings in memory or precision; his solitary narrations cannot serve as independent proof but may serve as corroboration.",
},
],
},
{
"key": "very_weak",
"match_slugs": ["very-weak", "очень-слабый"],
"default_slug": "very-weak",
"color": "red",
"title": [
{"language_code": "ar", "title": "متروك (شديد الضعف)", "text": "متروك (شديد الضعف)"},
{"language_code": "ru", "title": "Очень слабый (Матрук / Неприемлемый)", "text": "Очень слабый (Матрук / Неприемлемый)"},
{"language_code": "en", "title": "Very Weak (Discarded / Fabricator)", "text": "Very Weak (Discarded / Fabricator)"},
{"language_code": "fa", "title": "بسیار ضعیف (متروک)", "text": "بسیار ضعیف (متروک)"},
],
"description": [
{
"language_code": "ar",
"title": "راوٍ متروك الحديث ساقط الرواية",
"text": "راوٍ اتُّهم بالكذب أو ظهرت منه الغفلة الفاحشة ورواية المنكرات، متروك الحديث ساقط الرواية لا يُعتد بما يرويه ولا يُعتبر بحديثه.",
},
{
"language_code": "ru",
"title": "Отвергаемый передатчик",
"text": "Отвергаемый передатчик, уличенный во лжи, крайней халатности или передаче вымышленных сообщений; его предания полностью отвергаются.",
},
{
"language_code": "en",
"title": "A rejected narrator",
"text": "A rejected narrator suspected of fabrication, gross negligence, or narrating anomalies; his reports are discarded and cannot be used as proof.",
},
],
},
{
"key": "unknown",
"match_slugs": ["unknown"],
"default_slug": "unknown",
"color": "gray",
"title": [
{"language_code": "ar", "title": "مجهول الحال", "text": "مجهول الحال"},
{"language_code": "ru", "title": "Неизвестный (Маджхуль)", "text": "Неизвестный (Маджхуль)"},
{"language_code": "en", "title": "Unknown (Majhul)", "text": "Unknown (Majhul)"},
{"language_code": "fa", "title": "نامشخص (مجهول)", "text": "نامشخص (مجهول)"},
],
"description": [
{
"language_code": "ar",
"title": "راوٍ لم يُعرف حاله وتوثيقه",
"text": "راوٍ لم يُعرف حاله وتوثيقه عند علماء الرجال، أو لم يروِ عنه إلا راوٍ واحد ولم يوثقه معتبر، يتوقف في حديثه حتى يتبين أمره.",
},
{
"language_code": "ru",
"title": "Неизвестный передатчик",
"text": "Неизвестный передатчик, сведения о надежности которого отсутствуют в книгах по риджалю; принятие его преданий откладывается до выяснения.",
},
{
"language_code": "en",
"title": "An obscure undocumented narrator",
"text": "An obscure narrator whose identity or credibility is not documented by biographical scholars; judgment on his narrations is withheld.",
},
],
},
{
"key": "companion",
"match_slugs": ["сподвижник", "companion", "sahabi"],
"default_slug": "companion",
"color": "purple",
"title": [
{"language_code": "ar", "title": "صحابي", "text": "صحابي"},
{"language_code": "ru", "title": "Сподвижник (Сахаби)", "text": "Сподвижник (Сахаби)"},
{"language_code": "en", "title": "Companion (Sahabi)", "text": "Companion (Sahabi)"},
{"language_code": "fa", "title": "صحابی", "text": "صحابی"},
],
"description": [
{
"language_code": "ar",
"title": "صحابي جليل عاصر النبي (ص) أو المعصوم (ع)",
"text": "صحابي جليل عاصر النبي (ص) أو المعصوم (ع)، وتخضع الرواية المنقولة عنه لدراسة اتصال السند والقرائن التاريخية.",
},
{
"language_code": "ru",
"title": "Признанный сподвижник",
"text": "Признанный сподвижник, современник Пророка (с) или Непорочного (а); предания от него исследуются на предмет непрерывности иснада.",
},
{
"language_code": "en",
"title": "A recognized companion",
"text": "A recognized companion who lived during the era of the Prophet (pbuh) or Infallible (as), studied in the context of chain continuity.",
},
],
},
]
# ==============================================================================
# CANONICAL BOOK AUTHOR RUTBAS (رتبه‌های نویسندگان / مؤلفین)
# ==============================================================================
RUTBA_DEFINITIONS = [
{
"slug": "allamah",
"color": "green",
"title": [
{"language_code": "ar", "title": "علامة ومحقق كبير", "text": "علامة ومحقق كبير"},
{"language_code": "ru", "title": "Выдающийся ученый (Аллама)", "text": "Выдающийся ученый (Аллама)"},
{"language_code": "en", "title": "Grand Scholar / Eminent Authority (Allamah)", "text": "Grand Scholar / Eminent Authority (Allamah)"},
{"language_code": "fa", "title": "علامه و محقق برجسته", "text": "علامه و محقق برجسته"},
],
"description": [
{
"language_code": "ar",
"title": "عالم جليل ومحدث ثبت من كبار أعلام الفقه والحديث والتفسير",
"text": "عالم جليل ومحدث ثبت من كبار أعلام الفقه والحديث والتفسير، مصنفاته تعتبر مراجع أصلية وأعمدة في المكتبة الإسلامية.",
},
{
"language_code": "ru",
"title": "Выдающийся авторитетный богослов и исследователь высшего ранга",
"text": "Выдающийся авторитетный богослов и исследователь высшего ранга, чьи труды служат фундаментальными первоисточниками.",
},
{
"language_code": "en",
"title": "A distinguished scholar of the highest standing",
"text": "A distinguished and authoritative scholar of highest standing in Islamic jurisprudence, hadith and commentary, whose works are foundational references.",
},
],
},
{
"slug": "reliable-author",
"color": "blue",
"title": [
{"language_code": "ar", "title": "مؤلف ثقة معتمد", "text": "مؤلف ثقة معتمد"},
{"language_code": "ru", "title": "Надежный признанный автор (Сика)", "text": "Надежный признанный автор (Сика)"},
{"language_code": "en", "title": "Reliable & Authoritative Author", "text": "Reliable & Authoritative Author"},
{"language_code": "fa", "title": "نویسنده معتمد و ثقه", "text": "نویسنده معتمد و ثقه"},
],
"description": [
{
"language_code": "ar",
"title": "مؤلف متقن وأمين في نقله وتصنيفه",
"text": "مؤلف متقن وأمين في نقله وتصنيفه، حظيت كتبه بالقبول والاعتماد لدى أهل التحقيق ويُعتمد على ما دونه في مصنفاته.",
},
{
"language_code": "ru",
"title": "Добросовестный и точный в цитировании автор",
"text": "Добросовестный и точный в цитировании автор, чьи книги получили широкое признание и считаются авторитетными среди ученых.",
},
{
"language_code": "en",
"title": "A trustworthy author of scientific integrity",
"text": "A trustworthy, precise author known for scientific integrity, widely accepted and relied upon by classical and modern researchers.",
},
],
},
{
"slug": "acceptable-author",
"color": "yellow",
"title": [
{"language_code": "ar", "title": "مؤلف صدوق (حسن النقل)", "text": "مؤلف صدوق (حسن النقل)"},
{"language_code": "ru", "title": "Правдивый автор (Садук / Приемлемый)", "text": "Правдивый автор (Садук / Приемлемый)"},
{"language_code": "en", "title": "Truthful / Acceptable Author", "text": "Truthful / Acceptable Author"},
{"language_code": "fa", "title": "نویسنده صدوق و مورد قبول", "text": "نویسنده صدوق و مورد قبول"},
],
"description": [
{
"language_code": "ar",
"title": "مؤلف صادق وأمين في نقله وأخباره",
"text": "مؤلف صادق وأمين في نقله وأخباره، كُتبه نافعة وتُستفاد في الشواهد والفوائد العلمية.",
},
{
"language_code": "ru",
"title": "Правдивый автор с хорошей репутацией",
"text": "Правдивый и искренний автор, чьи труды полезны и служат ценным дополнительным источником в научных исследованиях.",
},
{
"language_code": "en",
"title": "A truthful author of good repute",
"text": "A truthful author of good repute whose writings are valuable, providing useful context and supporting historical evidence.",
},
],
},
{
"slug": "historian",
"color": "purple",
"title": [
{"language_code": "ar", "title": "مؤرخ وأخباري", "text": "مؤرخ وأخباري"},
{"language_code": "ru", "title": "Историк и летописец (Ахбари)", "text": "Историк и летописец (Ахбари)"},
{"language_code": "en", "title": "Historian & Chronicler", "text": "Historian & Chronicler"},
{"language_code": "fa", "title": "مورخ و اخباری", "text": "مورخ و اخباری"},
],
"description": [
{
"language_code": "ar",
"title": "مؤلف متخصص في تدوين الأخبار والوقائع التاريخية",
"text": "مؤلف متخصص في تدوين الأخبار والوقائع التاريخية والسير والتراجم، تُعتمد كتبه في معرفة الأحداث والتواريخ مع التحقيق والنقد.",
},
{
"language_code": "ru",
"title": "Ученый-историк и хроникер",
"text": "Ученый, специализирующийся на летописях, исторических хрониках и биографиях; его труды ценны для понимания исторического контекста.",
},
{
"language_code": "en",
"title": "A scholar specialized in historical chronicles",
"text": "A scholar specialized in compiling historical chronicles, biographies, and events, essential for historical documentation.",
},
],
},
{
"slug": "linguist",
"color": "orange",
"title": [
{"language_code": "ar", "title": "أديب ولغوي", "text": "أديب ولغوي"},
{"language_code": "ru", "title": "Филолог и литератор (Адиб)", "text": "Филолог и литератор (Адиб)"},
{"language_code": "en", "title": "Philologist & Linguist", "text": "Philologist & Linguist"},
{"language_code": "fa", "title": "ادیب و لغت‌شناس", "text": "ادیب و لغت‌شناس"},
],
"description": [
{
"language_code": "ar",
"title": "متخصص في علوم اللغة العربية والمعاجم والشعر",
"text": "متخصص في علوم اللغة العربية والمعاجم والشعر وغريب الألفاظ، مؤلفاته مرجعية في تحقيق المعاني والدلالات اللغوية.",
},
{
"language_code": "ru",
"title": "Специалист по арабскому языку и филологии",
"text": "Специалист по арабскому языку, литературе, грамматике и лексикографии; его работы служат стандартом языкового анализа.",
},
{
"language_code": "en",
"title": "A specialist in Arabic linguistics and philology",
"text": "Specialized in Arabic language, lexicography, poetry, and grammar, whose books are references for linguistic and semantic analysis.",
},
],
},
{
"slug": "unreliable-author",
"color": "red",
"title": [
{"language_code": "ar", "title": "مؤلف ضعيف (غير معتمد)", "text": "مؤلف ضعيف (غير معتمد)"},
{"language_code": "ru", "title": "Ненадежный автор (Даиф)", "text": "Ненадежный автор (Даиф)"},
{"language_code": "en", "title": "Weak / Unreliable Author", "text": "Weak / Unreliable Author"},
{"language_code": "fa", "title": "نویسنده ضعیف (غیرمعتمد)", "text": "نویسنده ضعیف (غیرمعتمد)"},
],
"description": [
{
"language_code": "ar",
"title": "مؤلف كثرت في مصنفاته الأوهام والنقول الضعيفة",
"text": "مؤلف كثرت في مصنفاته الأوهام والنقول الضعيفة أو غير المحررة، فلا يُعتمد على ما ينفرد بنقله دون شواهد معتبرة.",
},
{
"language_code": "ru",
"title": "Автор со слабыми и неподтвержденными сведениями",
"text": "Автор, в чьих работах встречается множество неточностей и слабых сообщений; его единоличные утверждения требуют проверки.",
},
{
"language_code": "en",
"title": "An unverified and inaccurate author",
"text": "An author whose compilations contain significant inaccuracies or unverified reports; single-sourced reports from him are not standalone evidence.",
},
],
},
{
"slug": "unknown-author",
"color": "gray",
"title": [
{"language_code": "ar", "title": "مؤلف غير مبين الرتبة", "text": "مؤلف غير مبين الرتبة"},
{"language_code": "ru", "title": "Неопределенный ранг / Неизвестный автор", "text": "Неопределенный ранг / Неизвестный автор"},
{"language_code": "en", "title": "Unknown / Unclassified Author", "text": "Unknown / Unclassified Author"},
{"language_code": "fa", "title": "نویسنده نامشخص (غیرمبین)", "text": "نویسنده نامشخص (غیرمبین)"},
],
"description": [
{
"language_code": "ar",
"title": "مؤلف لم تتوفر عنه ترجمة كافية",
"text": "مؤلف لم تتوفر عنه ترجمة كافية في مصادر التراجم لبيان رتبته العلمية ومدى ضبطه وأمانته في النقل بدقة.",
},
{
"language_code": "ru",
"title": "Автор с недостаточными биографическими данными",
"text": "Автор, о биографии и научной надежности которого сохранилось недостаточно сведений для точной классификации.",
},
{
"language_code": "en",
"title": "Author with insufficient biographical data",
"text": "An author for whom insufficient biographical information exists in classical sources to determine a precise scholarly rating.",
},
],
},
]
def match_definition(record_slug: str):
slug_lower = (record_slug or "").lower()
for definition in RELIABILITY_DEFINITIONS:
for pattern in definition["match_slugs"]:
if pattern in slug_lower:
return definition
return None
def match_rutba_definition(record_slug: str):
slug_lower = (record_slug or "").lower()
if any(k in slug_lower for k in ["allamah", "allameh"]):
return RUTBA_DEFINITIONS[0]
if any(k in slug_lower for k in ["reliable", "thiqah", "accepted", "ثقه", "ثقة"]):
return RUTBA_DEFINITIONS[1]
if any(k in slug_lower for k in ["acceptable", "hasan", "حسن"]):
return RUTBA_DEFINITIONS[2]
if any(k in slug_lower for k in ["historian", "tarikh", "تاريخ", "مورخ"]):
return RUTBA_DEFINITIONS[3]
if any(k in slug_lower for k in ["linguist", "lugha", "adab", "لغوي"]):
return RUTBA_DEFINITIONS[4]
if any(k in slug_lower for k in ["unreliable", "daif", "weak", "ضعيف"]):
return RUTBA_DEFINITIONS[5]
if any(k in slug_lower for k in ["unknown", "majhul", "مجهول"]):
return RUTBA_DEFINITIONS[6]
return None
class Command(BaseCommand):
help = "Seeds and enriches TransmitterReliability descriptions and BookAuthorRutba ranks with AR, RU, and EN metadata."
def handle(self, *args, **options):
try:
if hasattr(sys.stdout, "reconfigure"):
sys.stdout.reconfigure(encoding="utf-8", errors="replace")
except Exception:
pass
self.stdout.write(self.style.WARNING("Starting to seed Transmitter Reliabilities and Author Rutbas..."))
def safe_str(val):
return str(val).encode("ascii", errors="replace").decode("ascii")
updated_rel_count = 0
created_rel_count = 0
with transaction.atomic():
# 1. Update existing TransmitterReliability records with full descriptions
existing_reliabilities = list(TransmitterReliability.objects.all())
handled_keys = set()
for rel in existing_reliabilities:
def_match = match_definition(rel.slug)
if def_match:
rel.description = def_match["description"]
rel.color = def_match["color"]
# Merge / supplement titles so AR, RU, EN are guaranteed
title_map = {t.get("language_code"): t for t in (rel.title or []) if isinstance(t, dict)}
for canonical_t in def_match["title"]:
code = canonical_t["language_code"]
if code not in title_map or not title_map[code].get("text"):
title_map[code] = canonical_t
rel.title = list(title_map.values())
rel.save()
handled_keys.add(def_match["key"])
updated_rel_count += 1
self.stdout.write(f" [+] Updated reliability ID {rel.id} ({safe_str(rel.slug)})")
# Create any canonical reliabilities that did not exist
for defn in RELIABILITY_DEFINITIONS:
if defn["key"] not in handled_keys:
obj, created = TransmitterReliability.objects.get_or_create(
slug=defn["default_slug"],
defaults={
"title": defn["title"],
"description": defn["description"],
"color": defn["color"],
},
)
if created:
created_rel_count += 1
self.stdout.write(f" [+] Created canonical reliability: {safe_str(defn['default_slug'])}")
# 2. Seed and update BookAuthorRutba objects
created_rutba_count = 0
updated_rutba_count = 0
handled_rutba_keys = set()
# First update any existing rutbas
for rutba in BookAuthorRutba.objects.all():
match = match_rutba_definition(rutba.slug)
if match:
rutba.description = match["description"]
rutba.color = match["color"]
title_map = {t.get("language_code"): t for t in (rutba.title or []) if isinstance(t, dict)}
for canonical_t in match["title"]:
code = canonical_t["language_code"]
if code not in title_map or not title_map[code].get("text"):
title_map[code] = canonical_t
rutba.title = list(title_map.values())
rutba.save()
handled_rutba_keys.add(match["slug"])
updated_rutba_count += 1
self.stdout.write(f" [+] Updated existing author rutba: {safe_str(rutba.slug)}")
# Create any canonical rutbas that don't exist yet
for defn in RUTBA_DEFINITIONS:
slug = defn["slug"]
existing = BookAuthorRutba.objects.filter(slug=slug).first()
if not existing:
BookAuthorRutba.objects.create(
slug=slug,
title=defn["title"],
description=defn["description"],
color=defn["color"],
)
created_rutba_count += 1
self.stdout.write(f" [+] Created canonical author rutba: {safe_str(slug)}")
self.stdout.write(self.style.SUCCESS(
f"\nDone!"
f"\n Transmitter Reliabilities: {updated_rel_count} updated, {created_rel_count} created."
f"\n Book Author Rutbas: {created_rutba_count} created, {updated_rutba_count} updated."
))
if __name__ == "__main__":
cmd = Command()
cmd.handle()