Browse Source

feat(hadis): add contributor role ordering, per-volume contributor scope, and update bulk import guide

master
Mohsen Taba 2 weeks ago
parent
commit
dfc9c2856f
  1. 45
      apps/hadis/management/commands/export_hadis_sqlite.py
  2. 42
      apps/hadis/migrations/0076_bookcontributorrole_order_bookeditioncontributor_volumes.py
  3. 9
      apps/hadis/models/reference.py
  4. 7
      apps/hadis/serializers/hadis.py
  5. 12
      apps/hadis/serializers/reference_v2.py
  6. 42
      apps/hadis/serializers/serializers_admin.py
  7. 4
      apps/hadis/views_admin.py
  8. 430
      docs/BULK_IMPORT_JSON_GUIDE.md

45
apps/hadis/management/commands/export_hadis_sqlite.py

@ -145,7 +145,17 @@ class Command(BaseCommand):
title TEXT,
slug TEXT UNIQUE,
source_type TEXT,
sect_type TEXT
sect_type TEXT,
is_topic INTEGER DEFAULT 0
);
CREATE TABLE IF NOT EXISTS hadith_categories (
hadis_id INTEGER,
category_id INTEGER,
category_slug TEXT,
PRIMARY KEY (hadis_id, category_id),
FOREIGN KEY (hadis_id) REFERENCES hadiths (id),
FOREIGN KEY (category_id) REFERENCES categories (id)
);
CREATE TABLE IF NOT EXISTS category_interpretations (
@ -209,6 +219,9 @@ class Command(BaseCommand):
CREATE INDEX IF NOT EXISTS idx_hadith_cat ON hadiths(category_id);
CREATE INDEX IF NOT EXISTS idx_hadith_slug ON hadiths(slug);
CREATE INDEX IF NOT EXISTS idx_corr_hadis ON hadith_corrections(hadis_id);
CREATE INDEX IF NOT EXISTS idx_hcat_cat_id ON hadith_categories(category_id);
CREATE INDEX IF NOT EXISTS idx_hcat_cat_slug ON hadith_categories(category_slug);
CREATE INDEX IF NOT EXISTS idx_hcat_hadis_id ON hadith_categories(hadis_id);
""")
def _is_empty_localized_data(self, val):
@ -245,11 +258,12 @@ class Command(BaseCommand):
c.slug,
getattr(c, 'source_type', None),
getattr(c, 'sect_type', None),
1 if getattr(c, 'is_topic', False) else 0,
)
for c in cats
]
cursor.executemany(
"INSERT INTO categories (id, title, slug, source_type, sect_type) VALUES (?, ?, ?, ?, ?)",
"INSERT INTO categories (id, title, slug, source_type, sect_type, is_topic) VALUES (?, ?, ?, ?, ?, ?)",
rows
)
return len(rows)
@ -387,6 +401,7 @@ class Command(BaseCommand):
.filter(status=True)
.select_related('category', 'hadis_status')
.prefetch_related(
'categories',
'tags',
'references__book_reference__author',
'references__images',
@ -403,6 +418,7 @@ class Command(BaseCommand):
hadis_rows = []
correction_rows = []
hadith_category_rows = []
for h in hadiths:
# 1. Status Block
@ -492,6 +508,24 @@ class Command(BaseCommand):
json.dumps(explanations_data, ensure_ascii=False),
))
# 5.5 Multi-category M2M relations (plus primary category)
seen_cat_ids = set()
if h.category_id:
seen_cat_ids.add(h.category_id)
hadith_category_rows.append((
h.id,
h.category_id,
h.category.slug if h.category else None,
))
for cat in h.categories.all():
if cat.id not in seen_cat_ids:
seen_cat_ids.add(cat.id)
hadith_category_rows.append((
h.id,
cat.id,
cat.slug,
))
# 6. Corrections
for corr in h.hadiscorrection_set.all():
corr_imgs = []
@ -529,6 +563,13 @@ class Command(BaseCommand):
hadis_rows
)
cursor.executemany(
"""INSERT OR IGNORE INTO hadith_categories (
hadis_id, category_id, category_slug
) VALUES (?, ?, ?)""",
hadith_category_rows
)
cursor.executemany(
"""INSERT INTO hadith_corrections (
id, hadis_id, title, slug, narrator, description, translation,

42
apps/hadis/migrations/0076_bookcontributorrole_order_bookeditioncontributor_volumes.py

@ -0,0 +1,42 @@
from django.db import migrations, models
def seed_contributor_role_orders(apps, schema_editor):
BookContributorRole = apps.get_model('hadis', 'BookContributorRole')
for role in BookContributorRole.objects.filter(order=0):
role.order = role.id
role.save(update_fields=['order'])
class Migration(migrations.Migration):
dependencies = [
('hadis', '0075_bookedition_language'),
]
operations = [
migrations.AddField(
model_name='bookcontributorrole',
name='order',
field=models.PositiveIntegerField(default=0, verbose_name='order'),
),
migrations.AlterModelOptions(
name='bookcontributorrole',
options={
'ordering': ('order', 'id'),
'verbose_name': 'Book Contributor Role',
'verbose_name_plural': 'Book Contributor Roles',
},
),
migrations.AddField(
model_name='bookeditioncontributor',
name='volumes',
field=models.ManyToManyField(
blank=True,
related_name='contributors',
to='hadis.bookvolume',
verbose_name='Specific Volumes',
),
),
migrations.RunPython(seed_contributor_role_orders, migrations.RunPython.noop),
]

9
apps/hadis/models/reference.py

@ -1015,11 +1015,12 @@ class BookContributorRole(LowercaseSlugMixin, models.Model):
title = models.JSONField(default=list, verbose_name=_('Title'))
slug = models.SlugField(max_length=255, verbose_name=_('slug'), blank=True, null=True, allow_unicode=True)
order = models.PositiveIntegerField(default=0, verbose_name=_('order'))
created_at = models.DateTimeField(auto_now_add=True, verbose_name=_('created at'))
updated_at = models.DateTimeField(auto_now=True, verbose_name=_('updated at'))
class Meta:
ordering = ('id',)
ordering = ('order', 'id')
verbose_name = _('Book Contributor Role')
verbose_name_plural = _('Book Contributor Roles')
@ -1065,6 +1066,12 @@ class BookEditionContributor(LowercaseSlugMixin, models.Model):
related_name='edition_contributor_profiles',
verbose_name=_('Author')
)
volumes = models.ManyToManyField(
'BookVolume',
blank=True,
related_name='contributors',
verbose_name=_('Specific Volumes')
)
name = models.JSONField(default=list, blank=True, verbose_name=_('Name'))
slug = models.SlugField(max_length=255, verbose_name=_('slug'), null=True, blank=True, allow_unicode=True)

7
apps/hadis/serializers/hadis.py

@ -2043,7 +2043,7 @@ def get_cached_edition_metadata():
).prefetch_related(
Prefetch('researchers', queryset=BookResearcher.objects.select_related('author')),
Prefetch('editors', queryset=BookEditor.objects.select_related('author')),
Prefetch('contributors', queryset=BookEditionContributor.objects.select_related('author', 'role')),
Prefetch('contributors', queryset=BookEditionContributor.objects.select_related('author', 'role').prefetch_related('volumes')),
)
)
by_id = {}
@ -2222,8 +2222,13 @@ def _build_edition_info_dict(obj, edition, request):
"author": author_data,
}
if role_data is not None:
role_data["order"] = getattr(role_obj, "order", 0)
ret["role_id"] = role_obj.id
ret["role"] = role_data
if hasattr(c, "volumes"):
vols = list(c.volumes.all())
ret["volume_ids"] = [v.id for v in vols]
ret["volumes"] = [{"id": v.id, "title": v.title} for v in vols]
return ret
raw_researchers = edition._cached_researchers if hasattr(edition, '_cached_researchers') else (edition.researchers.all() if hasattr(edition, "researchers") else [])

12
apps/hadis/serializers/reference_v2.py

@ -24,7 +24,7 @@ class BookContributorRoleV2Serializer(serializers.ModelSerializer):
class Meta:
model = BookContributorRole
fields = ['id', 'title', 'slug']
fields = ['id', 'title', 'slug', 'order']
class BookEditionContributorV2Serializer(serializers.ModelSerializer):
@ -34,10 +34,12 @@ class BookEditionContributorV2Serializer(serializers.ModelSerializer):
author = BookAuthorV2Serializer(read_only=True)
author_id = serializers.SerializerMethodField()
slug = serializers.SerializerMethodField()
volume_ids = serializers.SerializerMethodField()
volumes = serializers.SerializerMethodField()
class Meta:
model = BookEditionContributor
fields = ['id', 'name', 'slug', 'role', 'role_id', 'author', 'author_id']
fields = ['id', 'name', 'slug', 'role', 'role_id', 'author', 'author_id', 'volume_ids', 'volumes']
def get_role_id(self, obj):
return obj.role_id
@ -50,6 +52,12 @@ class BookEditionContributorV2Serializer(serializers.ModelSerializer):
return obj.author.slug
return obj.slug
def get_volume_ids(self, obj):
return [v.id for v in obj.volumes.all()]
def get_volumes(self, obj):
return [{'id': v.id, 'title': v.title} for v in obj.volumes.all()]
class BookResearcherV2Serializer(serializers.ModelSerializer):
name = LocalizedField()

42
apps/hadis/serializers/serializers_admin.py

@ -8268,10 +8268,11 @@ class AdminBookVolumeSerializer(serializers.ModelSerializer):
class AdminBookContributorRoleSerializer(serializers.ModelSerializer):
title = serializers.JSONField(default=list)
slug = serializers.SlugField(max_length=255, required=False, allow_null=True, allow_blank=True, allow_unicode=True)
order = serializers.IntegerField(required=False, default=0)
class Meta:
model = BookContributorRole
fields = ["id", "title", "slug", "created_at", "updated_at"]
fields = ["id", "title", "slug", "order", "created_at", "updated_at"]
class AdminBookEditionContributorSerializer(serializers.ModelSerializer):
@ -8279,10 +8280,16 @@ class AdminBookEditionContributorSerializer(serializers.ModelSerializer):
name = serializers.JSONField(required=False, default=list)
role_detail = AdminBookContributorRoleSerializer(source="role", read_only=True)
author_detail = serializers.SerializerMethodField()
volumes = serializers.PrimaryKeyRelatedField(
queryset=BookVolume.objects.all(),
many=True,
required=False,
)
volumes_detail = serializers.SerializerMethodField()
class Meta:
model = BookEditionContributor
fields = ["id", "role", "role_detail", "author", "author_detail", "name", "slug"]
fields = ["id", "role", "role_detail", "author", "author_detail", "volumes", "volumes_detail", "name", "slug"]
def get_author_detail(self, obj):
if obj.author_id and obj.author:
@ -8293,6 +8300,15 @@ class AdminBookEditionContributorSerializer(serializers.ModelSerializer):
}
return None
def get_volumes_detail(self, obj):
return [
{
"id": v.id,
"title": v.title,
}
for v in obj.volumes.all()
]
class AdminBookResearcherSerializer(serializers.ModelSerializer):
@ -8628,13 +8644,27 @@ class AdminBookEditionSerializer(serializers.ModelSerializer):
if not author_obj and not raw_name:
continue
BookEditionContributor.objects.create(
contrib_obj = BookEditionContributor.objects.create(
book_edition=edition,
role=role_obj,
author=author_obj,
name=raw_name,
slug=raw_slug,
)
raw_vols = c_item.get("volumes") if "volumes" in c_item else c_item.get("volume_ids")
if isinstance(raw_vols, list):
resolved_vols = []
for v_item in raw_vols:
if isinstance(v_item, BookVolume):
resolved_vols.append(v_item.id)
elif v_item not in (None, "", "none", "null"):
try:
resolved_vols.append(int(v_item))
except (ValueError, TypeError):
pass
if resolved_vols:
valid_vols = list(BookVolume.objects.filter(id__in=resolved_vols))
contrib_obj.volumes.set(valid_vols)
if role_obj and role_obj.id == 1 and author_obj:
researcher_authors.append(author_obj)
elif role_obj and role_obj.id == 5 and author_obj:
@ -8707,6 +8737,12 @@ class AdminBookEditionSerializer(serializers.ModelSerializer):
edition.books.add(edition.book_reference)
linked_ids = list(edition.books.values_list("id", flat=True))
if edition.book_reference_id and edition.book_reference_id not in linked_ids:
linked_ids.append(edition.book_reference_id)
if linked_ids:
BookReference.objects.filter(id__in=linked_ids, has_editions=False).update(has_editions=True)
self._invalidate_edition_cache()
return edition

4
apps/hadis/views_admin.py

@ -2843,7 +2843,7 @@ class AdminBookEditionViewSet(ModelViewSet):
"publisher_item__country",
"city_of_publication_city__country",
"country_of_publication_country",
).prefetch_related("books", "volumes", "researchers", "editors", "contributors__role", "contributors__author")
).prefetch_related("books", "volumes", "researchers", "editors", "contributors__role", "contributors__author", "contributors__volumes")
book_reference_id = self.request.query_params.get("book_reference_id")
@ -2910,7 +2910,7 @@ class DovodiBookContributorRoleViewSet(ModelViewSet):
queryset = queryset.filter(
Q(title__icontains=search_query) | Q(slug__icontains=search_query)
)
return queryset.order_by("id")
return queryset.order_by("order", "id")
def perform_create(self, serializer):
super().perform_create(serializer)

430
docs/BULK_IMPORT_JSON_GUIDE.md

@ -1,28 +1,53 @@
# راهنمای جامع و طرح اولیه ایمپورت دسته‌جمعی داده‌ها (Bulk Import JSON Specification)
# راهنمای جامع و طرح استاندارد ایمپورت دسته‌جمعی داده‌ها (فرمت JSON)
این سند به عنوان **«طرح اولیه» (Initial Blueprint)** برای انتقال و ایمپورت دسته‌جمعی داده‌ها به بخش **Arguments (حدیث، قرآن، تاریخ، فتوا، نقل‌قول، راویان و منابع)** طراحی شده است.
با سلام و احترام؛
این سند به عنوان **راهنمای کامل و طرح استاندارد (Blueprint)** برای آماده‌سازی و ایمپورت دسته‌جمعی داده‌های شما به بخش‌های مختلف سامانه (شامل **آرگومنت‌ها، احادیث، آیات قرآن، تاریخ، فتاوا، نقل‌قول‌ها، راویان، علما و منابع**) بر اساس آخرین تغییرات و قابلیت‌های جدید سامانه تدوین شده است.
هدف این ساختار این است که شما بتوانید داده‌های دیتابیس فعلی خود را با **کمترین پیچیدگی** خروجی بگیرید و سیستم ایمپورت بک‌اند به صورت خودکار کارهای فنی (ساخت اسلاگ‌ها، درختواره، نرمال‌سازی متن برای جستجو، فرمت‌بندی تاریخ‌ها و ساخت دیتابیس آفلاین موبایل) را انجام دهد.
هدف ما از طراحی این ساختار این است که شما بتوانید اطلاعات دیتابیس فعلی خود را با **ساده‌ترین و منعطف‌ترین فرمت ممکن** خروجی بگیرید و سامانه به صورت خودکار تمام پردازش‌های فنی و ارتباطات پیچیده را انجام دهد.
---
## ۱. قوانین طلایی و عمومی (که کار شما را راحت می‌کند)
## ۱. قابلیت‌های هوشمند سامانه (برای کاهش کار دستی شما)
### الف) شناسه یکتا (`id` / `legacy_id`) برای اتصال بخش‌ها به هم
برای اینکه بتوانیم بخش‌ها را یکی‌یکی ایمپورت کنیم و به هم وصل نماییم، هر رکورد اصلی (راوی، کتاب، دسته‌بندی، حدیث و...) یک فیلد `"id"` (یا `"legacy_id"`) دارد که همان **کد یکتای دیتابیس خودتان** است (مثلاً `"nar_105"`, `"book_12"`, `"hadith_501"` یا عدد `105`).
- مزیت: اگر یک فایل را دو بار ایمپورت کنیم، رکورد تکراری ساخته نمی‌شود بلکه رکورد قبلی **به‌روزرسانی (Update)** می‌شود.
در نسخه جدید، چندین قابلیت خودکار به سامانه اضافه شده است تا در صورت خالی بودن برخی فیلدها، سیستم خودش آن‌ها را تکمیل کند:
### ب) فرمت فیلدهای چندزبانه (پشتیبانی از ۳ حالت ساده)
در دیتابیس ما، عناوین و ترجمه‌ها چندزبانه (`ru`, `ar`, `en`, `fa`, `ur`) هستند. برای راحتی شما در ساخت JSON، سیستم ایمپورت ما هر ۳ حالت زیر را قبول می‌کند:
1. **حالت پیشنهادی (آبجکت کلید-مقدار ساده):**
1. **تکمیل خودکار عنوان آرگومنت/حدیث (`title`):**
اگر برای یک حدیث، فتوا، نقل‌قول یا مطلب تاریخی، فیلد `title` را خالی بگذارید، سامانه به صورت خودکار **عنوان اولین کتاب منبع (Source)** متصل به آن را به عنوان تیتر قرار می‌دهد.
2. **تکمیل خودکار نام راوی یا گوینده در تیتر (`title_narrator`):**
اگر این فیلد را خالی بگذارید:
- در صورتی که مطلب دارای **سلسله روات** باشد، سامانه به صورت خودکار نام مشهور (`known_as` یا نام کامل) **اولین راویِ زنجیره سند** را در آن قرار می‌دهد.
- در صورتی که سلسله روات نداشته باشد (مثل فتاوا، تاریخ یا نقل‌قول)، سامانه نام مشهور **مولفِ کتاب منبع** را در آن قرار می‌دهد.
3. **تکمیل خودکار عنوان در «تصحیحات»، «تفاسیر» و «متون رجالی راویان»:**
در هر سه بخشِ تصحیحات حدیث (`corrections`)، تفاسیر تاپیک‌ها (`interpretations`) و متون اصلی راویان (`original_texts`)، ارسال فیلد `title` **اختیاری** است. در صورت خالی بودن، عنوانِ کتاب مرجع متصل به آن‌ها به صورت خودکار جایگزین می‌شود.
4. **منطق هوشمند نمایش نسخه‌های چاپی کتاب‌ها (`editions.language`):**
در داده‌های مربوط به هر نسخه چاپی (`Edition`)، فیلد کد زبان چاپ (`language`) وجود دارد:
- اگر کد زبان نسخه **`"ar"` (عربی)** باشد، آن نسخه به صورت **عمومی (Global)** در تمامی زبان‌های سایت و اپلیکیشن نمایش داده می‌شود.
- اگر کد زبان نسخه **غیر عربی** (مثلاً `"ru"`، `"fa"`، `"en"` و...) باشد، آن نسخه فقط و فقط زمانی به کاربر نمایش داده می‌شود که کاربر دقیقاً همان زبان را برای رابط کاربری سایت/اپلیکیشن انتخاب کرده باشد.
5. **بانک مرکزی قرآن کریم (۱۱۴ سوره و ۶۲۳۶ آیه):**
بانک کامل متن عربی آیات و ترجمه‌های معتبر در سامانه مستقر شده است؛ بنابراین برای تاپیک‌های قرآنی کافی است شماره سوره (`surah_number`)، بازه آیات (`ayah_from` تا `ayah_to`) و کلید مترجمان منتخب (`selected_translator_keys`) را مشخص کنید (البته ارسال مستقیم متن و ترجمه سفارشی نیز همچنان پشتیبانی می‌شود).
6. **عدم نیاز به ارسال لینک‌های اشتراک‌گذاری (`share_link`) و اسلاگ (`slug`):**
سامانه به صورت پویا و خودکار برای تمامی بخش‌ها اسلاگ و لینک اشتراک‌گذاری تولید می‌کند.
---
## ۲. قوانین عمومی در آماده‌سازی فایل‌های JSON
### الف) شناسه یکتا (`id`) برای اتصال بخش‌ها به یکدیگر
هر رکورد (راوی، مولف، کتاب، شهر، دسته‌بندی، حدیث و...) دارای یک فیلد `"id"` است که همان **کد یکتای دیتابیس خودتان** است (می‌تواند عدد مثل `105` یا متن مثل `"nar_105"` باشد).
- با استفاده از این کد، بخش‌های مختلف به هم متصل می‌شوند.
- اگر فایلی را مجدداً ارسال و ایمپورت کنید، رکورد تکراری ساخته نمی‌شود بلکه رکورد قبلی بر اساس همین کد **به‌روزرسانی (Update)** می‌گردد.
### ب) فرمت فیلدهای چندزبانه (پشتیبانی از ۳ حالت به انتخاب شما)
تمامی فیلدهای متنی چندزبانه (از جمله `ru`, `ar`, `en`, `fa`, `ur`, `tr`, `az`, `uz`, `tg`, `ky`, `id`, `bn`, `de`, `es`, `fr`, `ha`, `sw`, `zh`) را می‌توانید به هر یک از ۳ روش زیر ارسال کنید:
1. **روش اول (پیشنهادی - آبجکت ساده بر اساس کد زبان):**
```json
"title": { "ru": "Книга веры", "ar": "كتاب الإيمان", "en": "Book of Faith" }
```
2. **حالت تک‌زبانه (رشته متنی ساده - اگر فقط یک زبان مثل روسی یا عربی دارید):**
2. **روش دوم (متن ساده - در صورتی که فقط یک زبان دارید):**
```json
"title": "Книга веры"
```
3. **حالت آرایه استاندارد دیتابیس:**
3. **روش سوم (آرایه استاندارد):**
```json
"title": [
{ "language_code": "ru", "text": "Книга веры" },
@ -31,29 +56,152 @@
```
### ج) فرمت استاندارد سال تولد، وفات و سن (`birth_year_hijri`, `death_year_hijri`, `age_at_death`)
موتور تاریخ سیستم به صورت خودکار فرمت‌های زیر را به ۳ زبان ترجمه و فرمت‌بندی می‌کند:
- عدد دقیق هجری: `"148"` (برای قبل از هجرت منفی بگذارید: `"-15"`)
- بازه زمانی: `"140..150"`
- تقریبی (حدودِ): `"~150"`
- بعد از سال / بیش از: `">150"`
- قبل از سال / کمتر از: `"<150"`
- دو احتمال (یا): `"148;149"` یا `"140..145;148..150"`
- تگ‌های مفهومی خاص: `"#early_islam"`, `"#hijra_habasha"`, `"#umayyad_era"`
موتور هوشمند تاریخ در سامانه، فرمت‌های زیر را به صورت خودکار به زبان‌های مختلف ترجمه و استانداردسازی می‌کند:
- **سال دقیق هجری:** `"148"` (برای سال‌های قبل از هجرت از علامت منفی استفاده کنید: `"-15"`)
- **بازه زمانی (بین دو سال):** `"140..150"`
- **تقریبی (حدودِ):** `"~150"`
- **بعد از سال / بیش از:** `">150"`
- **قبل از سال / کمتر از:** `"<150"`
- **چند احتمال (یا):** `"148;149"` یا `"140..145;148..150"`
- **تگ‌های مفهومی دوره تاریخی:** `"#early_islam"` (صدر اسلام)، `"#hijra_habasha"` (هجرت به حبشه)، `"#umayyad_era"` (دوران اموی) و یا هر تگ دلخواه جدید با علامت `#`.
### د) فرمت لینک‌های خارجی (`links`)
در تمامی بخش‌هایی که فیلد `links` دارند (احادیث، تصحیحات و تفاسیر)، می‌توانید به هر دو شکل زیر لینک‌ها را قرار دهید:
- **حالت اول (آبجکت کلید-مقدار ساده):**
```json
"links": {
"Sunnah.com": "https://sunnah.com/muslim:2424",
"Dorar": "https://dorar.net/hadith/123"
}
```
- **حالت دوم (لیست آبجکت‌ها):**
```json
"links": [
{ "title": "Sunnah.com", "url": "https://sunnah.com/muslim:2424" },
{ "title": "Dorar", "url": "https://dorar.net/hadith/123" }
]
```
---
## ۲. ترتیب و ساختار فایل‌های JSON (۵ فاز)
## ۳. ترتیب و ساختار ۵ مرحله‌ای ایمپورت داده‌ها
برای اینکه ارتباط بین بخش‌ها (مثل اتصال حدیث به راوی، کتاب و دسته‌بندی) کاملاً دقیق برقرار شود، داده‌ها در ۵ فایل (یا ۵ گام) به ترتیب زیر سازماندهی می‌شوند:
### گام اول: اطلاعات پایه، جغرافیا، تگ‌ها، نقش‌ها و وضعیت‌ها (`01_lookups.json`)
در ساختار جدید، اطلاعاتی مثل **کشورها، شهرها، ناشران، کنیه‌ها، مشاغل، ویژگی‌های راویان، مذاهب، وضعیت صحابی بودن، وضعیت ولاء (`mawla_statuses`)، خاستگاه‌ها و نسبت‌ها (`transmitter_origins`)، اماکن تاریخی سکونت/وفات (`transmitter_locations`)، نقش‌های مشارکت‌کنندگان نسخه چاپی (`contributor_roles`) و انواع نسبت‌های خویشاوندی** به صورت جداول مستقل درآمدند تا در فیلترها و جستجوها یکپارچه باشند.
### فاز اول: اطلاعات پایه، تگ‌ها و وضعیت‌ها (`01_lookups.json`)
این فایل شامل تعاریف پایه است که در سایر بخش‌ها به آن‌ها ارجاع داده می‌شود. *(نکته: اگر تگ یا وضعیتی را مستقیم داخل فایل احادیث یا راویان هم بنویسید، سیستم خودش آن را می‌سازد، اما داشتن این فایل برای تنظیم رنگ‌ها و توضیحات عالی است).*
**نکته برای راحتی شما:** اگر این موارد را به صورت فهرست جداگانه دارید، در این فایل قرار دهید. همچنین اگر در فایل راویان یا کتاب‌ها مستقیماً نام شهر، کنیه، شغل، ولاء یا تگ را بنویسید، سیستم ایمپورت به صورت خودکار آن را در این جداول ثبت و متصل خواهد کرد.
```json
{
"countries": [
{ "id": "country_iraq", "title": { "ru": "Ирак", "ar": "العراق", "en": "Iraq" } },
{ "id": "country_iran", "title": { "ru": "Иран", "ar": "إيران", "en": "Iran" } },
{ "id": "country_lebanon", "title": { "ru": "Ливан", "ar": "لبنان", "en": "Lebanon" } }
],
"cities": [
{ "id": "city_kufa", "country_id": "country_iraq", "title": { "ru": "Куфа", "ar": "الكوفة", "en": "Kufa" } },
{ "id": "city_baghdad", "country_id": "country_iraq", "title": { "ru": "Багдад", "ar": "بغداد", "en": "Baghdad" } },
{ "id": "city_tehran", "country_id": "country_iran", "title": { "ru": "Тегеран", "ar": "طهران", "en": "Tehran" } },
{ "id": "city_beirut", "country_id": "country_lebanon", "title": { "ru": "Бейрут", "ar": "بيروت", "en": "Beirut" } }
],
"transmitter_origins": [
{
"id": "orig_kufi",
"city_id": "city_kufa",
"title": { "ru": "Куфиец (аль-Куфи)", "ar": "الكوفي", "en": "Al-Kufi" }
},
{
"id": "orig_baghdadi",
"city_id": "city_baghdad",
"title": { "ru": "Багдадец (аль-Багдади)", "ar": "البغدادي", "en": "Al-Baghdadi" }
}
],
"transmitter_locations": [
{
"id": "loc_kufa",
"city_id": "city_kufa",
"title": { "ru": "Куфа", "ar": "الكوفة", "en": "Kufa" }
},
{
"id": "loc_baghdad",
"city_id": "city_baghdad",
"title": { "ru": "Багдад", "ar": "بغداد", "en": "Baghdad" }
}
],
"publishers": [
{
"id": "pub_dar_islamiya",
"country_id": "country_iran",
"city_id": "city_tehran",
"title": { "ru": "Дар аль-Кутуб аль-Исламия", "ar": "دار الكتب الإسلامية", "en": "Dar al-Kutub al-Islamiyya" }
}
],
"contributor_roles": [
{ "id": 1, "title": { "ru": "Исследователь (Мухаккик)", "ar": "تحقيق", "en": "Researcher" }, "order": 1 },
{ "id": 2, "title": { "ru": "Переводчик", "ar": "ترجمة", "en": "Translator" }, "order": 2 },
{ "id": 3, "title": { "ru": "Комментатор (Шарих)", "ar": "شرح", "en": "Commentator" }, "order": 3 },
{ "id": 4, "title": { "ru": "Примечания и глоссы (Та'лик)", "ar": "تعليق وحواشي", "en": "Footnotes & Glosses" }, "order": 4 },
{ "id": 5, "title": { "ru": "Редактор (Мусаххих)", "ar": "تصحيح وضبط", "en": "Editor" }, "order": 5 },
{ "id": 6, "title": { "ru": "Составитель (Джами')", "ar": "جمع وترتيب", "en": "Compiler" }, "order": 6 },
{ "id": 7, "title": { "ru": "Сократитель (Мухтасир)", "ar": "اختصار وتهذيب", "en": "Abridger" }, "order": 7 },
{ "id": 8, "title": { "ru": "Составитель указателей", "ar": "فهرسة", "en": "Index Compiler" }, "order": 8 },
{ "id": 9, "title": { "ru": "Автор предисловия", "ar": "تقديم", "en": "Introducer" }, "order": 9 }
],
"madhhabs": [
{
"id": "madhhab_imami",
"title": { "ru": "Шииты-имамиты", "ar": "الشيعة الإمامية", "en": "Twelver Shia" },
"description": { "ru": "Последователи двенадцати Имамов" }
},
{
"id": "madhhab_shafii",
"title": { "ru": "Шафииты", "ar": "الشافعية", "en": "Shafi'i" }
}
],
"sahabi_statuses": [
{
"id": "sahabi_prophet",
"title": { "ru": "Сподвижник Пророка (с)", "ar": "صحابي", "en": "Companion of the Prophet" },
"description": { "ru": "Встречал Пророка (с) и уверовал в него" }
},
{
"id": "sahabi_sadiq",
"title": { "ru": "Сподвижник Имама Садика (а)", "ar": "من أصحاب الإمام الصادق", "en": "Companion of Imam al-Sadiq" }
}
],
"mawla_statuses": [
{
"id": "mawla_banu_shayban",
"title": { "ru": "Вольноотпущенник Бану Шайбан", "ar": "مولى بني شيبان", "en": "Mawla of Banu Shayban" },
"description": { "ru": "Клиент или вольноотпущенник племени Бану Шайбан" }
}
],
"kunyas": [
{ "id": "kunya_abul_hasan", "title": { "ru": "Абу аль-Хасан", "ar": "أبو الحسن", "en": "Abu al-Hasan" } },
{ "id": "kunya_abu_abdillah", "title": { "ru": "Абу Абдуллах", "ar": "أبو عبد الله", "en": "Abu Abdillah" } }
],
"professions": [
{ "id": "prof_faqih", "title": { "ru": "Факих (Правовед)", "ar": "فقيه", "en": "Jurist (Faqih)" } },
{ "id": "prof_muhaddith", "title": { "ru": "Мухаддис", "ar": "محدث", "en": "Hadith Scholar" } }
],
"features": [
{ "id": "feat_hafiz", "title": { "ru": "Обладатель сильной памяти", "ar": "كثير الحفظ", "en": "Strong Memory" } },
{ "id": "feat_kufan_leader", "title": { "ru": "Глава куфийцев", "ar": "وجه الكوفيين", "en": "Leader in Kufa" } }
],
"relation_types": [
{ "code": "parents", "title": { "ru": "Родители", "ar": "الوالدان", "en": "Parents" } },
{ "code": "children", "title": { "ru": "Дети", "ar": "الأولاد", "en": "Children" } },
{ "code": "siblings", "title": { "ru": "Братья и сестры", "ar": "الإخوة", "en": "Siblings" } },
{ "code": "students", "title": { "ru": "Ученики", "ar": "التلاميذ", "en": "Students" } }
],
"hadith_statuses": [
{
"id": "status_sahih",
"title": { "ru": "Достоверный (Сахих)", "ar": "صحيح", "en": "Authentic (Sahih)" },
"description": { "ru": "Описание достоверного хадиса...", "ar": "..." },
"description": { "ru": "Описание достоверного хадиса..." },
"color": "green",
"order": 1
}
@ -77,6 +225,7 @@
{
"id": "rutba_hafiz",
"title": { "ru": "Хафиз", "ar": "حافظ", "en": "Hafiz" },
"description": { "ru": "Высокий уровень в хадисоведении" },
"color": "blue"
}
],
@ -84,11 +233,14 @@
{ "id": "tag_imamat", "title": { "ru": "Имамат", "ar": "الإمامة", "en": "Imamate" } },
{ "id": "tag_fiqh", "title": { "ru": "Фикх", "ar": "الفقه", "en": "Fiqh" } }
],
"book_tags": [
{ "id": "btag_primary", "title": { "ru": "Основной источник", "ar": "مصدر رئيسي" } }
],
"book_subject_areas": [
{ "id": "subj_hadith", "title": { "ru": "Книги хадисов", "ar": "كتب الحديث" } }
],
"book_types": [
{ "id": "type_shia_primary", "sect": "shia", "title": { "ru": "Первоисточник (Шииты)", "ar": "مصدر أصلي" } },
{ "id": "type_shia_primary", "sect": "shia", "title": { "ru": "Первоисточник (Шииты)", "ar": "مصدر شيعي" } },
{ "id": "type_sunni_primary", "sect": "sunni", "title": { "ru": "Первоисточник (Сунниты)", "ar": "مصدر سني" } }
]
}
@ -97,19 +249,49 @@
---
### فاز دوم: راویان، علما و اقوال رجالی (`02_narrators_and_scholars.json`)
در این فایل، لیست تمام راویان (`transmitters`) و مولفان/علمای رجال (`scholars_and_authors`) قرار می‌گیرد.
### گام دوم: راویان، علما، خویشاوندان و اقوال رجالی (`02_narrators_and_scholars.json`)
در این فایل، فهرست مولفان/علما (`scholars_and_authors`) و راویان (`transmitters`) قرار می‌گیرد.
#### نکات مهم این بخش در ساختار جدید:
1. **ارتباط مولف با راوی (`related_narrator_id`):** اگر یک مولف کتاب، خودش در لیست راویان هم حضور دارد، می‌توانید کد راوی او را در `related_narrator_id` قرار دهید تا پروفایل آن‌ها به هم لینک شود.
2. **پشتیبانی از چند خاستگاه و چند مکان سکونت/وفات (برای راویان و علما):**
علاوه بر فیلدهای تکیِ قبلی (`origin_city_id`, `lived_in_city_id`, `died_in_city_id`)، اکنون می‌توانید برای هر راوی یا عالم **لیستی از چند خاستگاه (`origin_ids`)، چند شهر محل سکونت (`lived_in_location_ids`) و چند مکان وفات (`died_in_location_ids`)** ارسال کنید.
3. **مذهب راوی (`madhhab_id`) و وضعیت ولاء چندگانه (`mawla_status_ids`):**
- برای مذهب راوی می‌توانید علاوه بر مقدار کلی `"shia"` / `"sunni"`، شناسه مذهب دقیق را در `madhhab_id` قرار دهید.
- برای وضعیت ولاء («مولى / آزادشده توسط») می‌توانید یک یا چند شناسه از جدول `mawla_statuses` را در `mawla_status_ids` قرار دهید (همچنین فیلد متنی `freed_slave_of` نیز همچنان پشتیبانی می‌شود).
4. **خویشاوندان و ارتباطات راوی (`relatives`):** هر راوی می‌تواند لیستی از خویشاوندان، شاگردان یا قبیله خود را با کد نسبت (`relation_type`)، نام (`name`) و کد راوی متناظر (`narrator_id` در صورتی که آن شخص خودش در دیتابیس پروفایل راوی دارد) داشته باشد.
- **کدهای آماده `relation_type`:** `"parents"`, `"children"`, `"siblings"`, `"spouses"`, `"stepfather"`, `"stepmother"`, `"stepchildren"`, `"uncles_and_aunts"`, `"nephews_and_nieces"`, `"cousins"`, `"grandparents"`, `"grandchildren_and_great_grandchildren"`, `"granduncles_and_grandaunts"`, `"grandnephews_and_grandnieces"`, `"foster_mother"`, `"foster_children"`, `"in_laws"`, `"students"`, `"owners_and_masters"`, `"tribe"`, `"friends_and_companions"`, `"allies"`, `"neighbors"`, `"wards_and_proteges"`, `"other_relatives"`, `"cousins_of_parents"`, `"cousins_of_grandparents"`, `"cousins_children"`, `"cousins_grandchildren_and_great_grandchildren"`.
5. **اقوال رجالی استاندارد (`scholarly_opinions`):** اگر عبارات رجالی ثابتی دارید که برای چندین راوی تکرار می‌شوند (مثلاً عبارت «ثقة» یا «کان ضعیفاً»)، می‌توانید آن‌ها را در `scholarly_opinions` تعریف کنید و در بخش `opinions` راوی فقط `opinion_id` بدهید، و یا مستقیماً متن قول (`opinion_text`) را زیر همان راوی بنویسید.
```json
{
"scholarly_opinions": [
{
"id": "sop_thiqa_eye",
"status_id": "op_confirmed",
"opinion_text": {
"ar": "ثقة عين",
"ru": "Надёжный, выдающийся (Сика Айн)"
}
}
],
"scholars_and_authors": [
{
"id": "author_najashi",
"related_narrator_id": null,
"name": { "ru": "Ан-Наджаши", "ar": "النجاشي", "en": "Al-Najashi" },
"known_as": { "ru": "Абу аль-Аббас", "ar": "أبو العباس" },
"known_as": { "ru": "Абу аль-Аббас ан-Наджаши", "ar": "أبو العباس النجاشي" },
"scholarity": { "ru": "Ученый в области риджал", "ar": "عالم بالرجال" },
"tabaqa": { "ru": "5-й век хиджры", "ar": "القرن الخامس" },
"rutba_id": "rutba_hafiz",
"feature_ids": ["feat_hafiz"],
"origin_ids": ["orig_baghdadi"],
"lived_in_location_ids": ["loc_baghdad", "loc_kufa"],
"died_in_location_ids": ["loc_baghdad"],
"origin_city_id": "city_baghdad",
"lived_in_city_id": "city_baghdad",
"died_in_city_id": "city_baghdad",
"birth_year_hijri": "372",
"death_year_hijri": "450",
"age_at_death": "78",
@ -124,37 +306,51 @@
"narrator_number": 101,
"gender": "male",
"madhhab": "shia",
"madhhab_id": "madhhab_imami",
"madhhab_ids": ["madhhab_imami"],
"reliability_id": "rel_thiqa",
"sahabi_status_id": "sahabi_sadiq",
"mawla_status_ids": ["mawla_banu_shayban"],
"generation": 5,
"full_name": { "ru": "Зурара ибн Айян", "ar": "زرارة بن أعين الشيباني", "en": "Zurara ibn A'yan" },
"known_as": { "ru": "Зурара", "ar": "زرارة" },
"kunya": { "ru": "Абу аль-Хасан", "ar": "أبو الحسن" },
"kunya_ids": ["kunya_abul_hasan"],
"nickname": { "ru": "Аш-Шайбани", "ar": "الشيباني" },
"origin": { "ru": "Куфа", "ar": "الكوفة" },
"lived_in": { "ru": "Куфа", "ar": "الكوفة" },
"died_in": { "ru": "Куфа", "ar": "الكوفة" },
"origin_ids": ["orig_kufi"],
"lived_in_location_ids": ["loc_kufa"],
"died_in_location_ids": ["loc_kufa"],
"origin_city_id": "city_kufa",
"lived_in_city_id": "city_kufa",
"died_in_city_id": "city_kufa",
"birth_year_hijri": "~80",
"death_year_hijri": "150",
"age_at_death": "~70",
"freed_slave_of": { "ru": "Бану Шайбан", "ar": "بني شيبان" },
"occupation": { "ru": "Факих, мухаддис", "ar": "فقيه ومحدث" },
"features": { "ru": "Сподвижник Имама Бакира и Имама Садика", "ar": "من أصحاب الباقر والصادق" },
"companion_type": { "ru": "Сподвижник Имама Садика (а)", "ar": "أصحاب الإمام الصادق" },
"profession_ids": ["prof_faqih", "prof_muhaddith"],
"feature_ids": ["feat_hafiz", "feat_kufan_leader"],
"tadlis": false,
"ikhtilat": false,
"in_sahih_bukhari": false,
"in_sahih_muslim": false,
"tags": ["Куфа", "Сподвижники"],
"description": { "ru": "Подробная биография передатчика...", "ar": "..." },
"relatives": {
"father_id": null,
"mother_id": null,
"sibling_ids": ["nar_102"]
},
"thumbnail_path": null,
"relatives": [
{
"relation_type": "siblings",
"name": "Хумран ибн Айян",
"narrator_id": "nar_102"
},
{
"relation_type": "parents",
"name": "Айян ибн Сансан",
"narrator_id": null
}
],
"opinions": [
{
"scholar_id": "author_najashi",
"scholar_name": { "ru": "Ан-Наджаши", "ar": "النجاشي" },
"opinion_id": "sop_thiqa_eye",
"status_id": "op_confirmed",
"opinion_text": {
"ar": "شيخ أصحابنا في زمانه ومتقدمهم، وكان قارئاً فقيهاً متكلماً",
@ -165,7 +361,7 @@
],
"original_texts": [
{
"title": { "ru": "Риджал ан-Наджаши о Зураре", "ar": "ترجمة زرارة في رجال النجاشي" },
"title": null,
"text": "زرارة بن أعين بن سنسن مولى بني شيبان...",
"translation": { "ru": "Зурара ибн Айян ибн Сансан, вольноотпущенник Бану Шайбан..." },
"order": 1,
@ -173,6 +369,7 @@
{
"book_id": "book_rijal_najashi",
"edition_id": "ed_najashi_1",
"volume_id": null,
"volume": "1",
"pages": "175",
"hadith_number": "463",
@ -190,22 +387,39 @@
---
### فاز سوم: منابع، کتاب‌ها، چاپ‌ها و جلدها (`03_sources.json`)
در ساختار جدید، هر کتاب (`BookReference`) می‌تواند چندین چاپ (`editions`) و چندین جلد (`volumes`) به همراه فایل PDF و تصاویر جلد داشته باشد.
### گام سوم: منابع، کتاب‌ها، چاپ‌ها، عوامل چاپ و جلدها (`03_sources.json`)
در ساختار جدید منابع:
1. **اولویت نمایش کتاب (`priority`):** هر کتاب (`books`) دارای فیلد `priority` است (عدد کمتر = اولویت بالاتر در لیست منابع).
2. **اتصال نسخه چاپی به کتاب‌ها (`editions.connected_book_ids`):**
رابطه بین نسخه چاپی (`Edition`) و کتاب‌ها (`BookReference`) صرفاً به صورت **چندبه‌چند (`books` / `connected_book_ids`)** است و نیازی به تفکیک «کتاب اصلی» و «کتاب فرعی» وجود ندارد. هر نسخه چاپی می‌تواند به یک یا چند اثر/کتاب مرتبط در `connected_book_ids` متصل شود (در صورتی که `editions` را در زیرمجموعه یک کتاب قرار دهید، شناسه آن کتاب نیز به صورت خودکار به لیست کتاب‌های مرتبط اضافه می‌شود).
3. **کد زبان چاپ نسخه (`editions.language`):**
هر نسخه چاپی (`Edition`) دارای فیلد `"language"` (کد دوحرفی زبان چاپ از بین ۱۸ زبان سامانه: `"ar"`, `"ru"`, `"en"`, `"fa"`, `"ur"`, `"tr"`, `"az"`, `"uz"`, `"tg"`, `"ky"`, `"id"`, `"bn"`, `"de"`, `"es"`, `"fr"`, `"ha"`, `"sw"`, `"zh"`؛ پیش‌فرض `"ar"`) است:
- اگر `"language": "ar"` باشد: این نسخه چاپی به صورت **عمومی (Global)** در تمام زبان‌های سایت و اپلیکیشن نمایش داده می‌شود.
- اگر `"language"` غیر عربی باشد (مثلاً `"ru"`): این نسخه فقط زمانی به کاربر نمایش داده می‌شود که زبان انتخاب‌شده توسط کاربر در سایت/اپلیکیشن دقیقاً `"ru"` باشد.
4. **عوامل و مشارکت‌کنندگان نسخه چاپی و ارتباط با جلدهای خاص (`editions.contributors`):**
هر نسخه چاپی می‌تواند لیستی از مشارکت‌کنندگان (`contributors`) داشته باشد که در آن هر فرد از لیست علما/مولفان (`author_id`) با یک نقش مشخص (`role_id` از جدول `contributor_roles` مثل محقق، مترجم، شارح، مصحح و...) به آن چاپ متصل می‌شود:
- **فیلد `volume_ids` (اختصاص مشارکت‌کننده به جلدهای مشخص):** برای هر مشارکت‌کننده می‌توانید آرایه `volume_ids` (شامل شناسه‌های جلدهای همان نسخه از بخش `volumes`) را ارسال کنید:
- اگر `volume_ids` خالی (`[]`) یا `null` باشد (یا ارسال نشود): به این معناست که آن شخص در **کل نسخه چاپی (تمامی جلدها)** مشارکت داشته است.
- اگر در `volume_ids` شناسه جلدهای خاصی (مثلاً `["vol_kafi_1", "vol_kafi_2"]`) درج شود: مشارکت آن شخص با آن نقش، **صرفاً مربوط به همان جلدهای مشخص‌شده** خواهد بود.
- *(فیلدهای قدیمی `researcher_ids` و `editor_ids` نیز همچنان برای سازگاری با داده‌های قبلی پشتیبانی می‌شوند).*
```json
{
"books": [
{
"id": "book_kafi",
"priority": 1,
"order": 1,
"title": { "ru": "Аль-Кафи", "ar": "الكافي", "en": "Al-Kafi" },
"description": { "ru": "Важнейший сборник шиитских хадисов...", "ar": "..." },
"language": { "ru": "Арабский", "ar": "العربية", "en": "Arabic" },
"author_id": "author_kulayni",
"type_id": "type_shia_primary",
"tag_id": "btag_primary",
"subject_area_ids": ["subj_hadith"],
"number_page": 4500,
"rate": 5.0,
"order": 1,
"has_editions": true,
"attributes": [
{
@ -216,14 +430,30 @@
"editions": [
{
"id": "ed_kafi_dar_islamiya",
"language": "ar",
"title": { "ru": "Издание Дар аль-Кутуб (Тегеран)", "ar": "طبعة دار الكتب الإسلامية" },
"connected_book_ids": ["book_kafi"],
"edition_number": "4",
"year_of_publication": "1407 هـ / 1986 م",
"number_of_volumes": 8,
"publisher": { "ru": "Дар аль-Кутуб аль-Исламия", "ar": "دار الكتب الإسلامية" },
"city_of_publication": { "ru": "Тегеран", "ar": "طهران" },
"country_of_publication": { "ru": "Иран", "ar": "إيران" },
"publisher_id": "pub_dar_islamiya",
"country_id": "country_iran",
"city_id": "city_tehran",
"tag_id": "btag_primary",
"isbn": "978-964-440-001-1",
"source_url": "https://lib.eshia.ir/11005",
"contributors": [
{
"role_id": 1,
"author_id": "author_ghaffari",
"volume_ids": null
},
{
"role_id": 4,
"author_id": "author_naeini",
"volume_ids": ["vol_kafi_1", "vol_kafi_2"]
}
],
"researcher_ids": ["author_ghaffari"],
"editor_ids": [],
"notes": { "ru": "С исследованием Али Акбара Гаффари" },
@ -250,13 +480,20 @@
---
### فاز چهارم: دسته‌بندی‌ها، تاپیک‌ها و آیات قرآن (`04_categories_and_quran.json`)
### گام چهارم: دسته‌بندی‌ها، تاپیک‌ها و آیات قرآن (`04_categories_and_quran.json`)
**قانون ساختاری دسته‌بندی‌ها و تاپیک‌ها:**
در سامانه، درخت دسته‌بندی به دو سطح تقسیم می‌شود:
1. **شاخه/پوشه ساختاری (`"is_topic": false`):** فقط نقش پوشه مادر را دارد و زیرمجموعه می‌گیرد (مستقیماً حدیثی داخل آن قرار نمی‌گیرد و `"source_type": null` است).
2. **تاپیک نهایی (`"is_topic": true`):** آخرین برگ درخت است که احادیث، آرگومنت‌ها، آیات قرآن و تفاسیر به آن متصل می‌شوند. برای هر تاپیک حتماً باید `"source_type"` از بین یکی از ۵ مورد زیر مشخص شود:
- `"quran"` (قرآن)
- `"hadith"` (حدیث)
- `"history"` (تاریخ)
- `"fatwa"` (فتوا)
- `"quote"` (نقل‌قول)
**نکته بسیار مهم درباره دسته‌بندی‌ها در سیستم:**
دسته‌بندی‌ها در سیستم ما به دو نوع تقسیم می‌شوند:
1. **پوشه/شاخه ساختاری (`"is_topic": false`):** فقط زیرمجموعه دارد و مستقیماً حدیثی داخل آن قرار نمی‌گیرد (`source_type` ندارد).
2. **تاپیک نهایی (`"is_topic": true`):** آخرین برگ درخت است که احادیث، تفاسیر یا آیات داخل آن قرار می‌گیرند. برای تاپیک حتماً باید `"source_type"` مشخص شود:
- مقادیر مجاز `source_type`: `"quran"` (قرآن)، `"hadith"` (حدیث)، `"history"` (تاریخ)، `"fatwa"` (فتوا)، `"quote"` (نقل‌قول).
**نحوه تعریف آیه در تاپیک‌های قرآنی (`quran_verse`):**
با توجه به اضافه شدن **بانک مرکزی قرآن کریم** (شامل ۱۱۴ سوره، ۶۲۳۶ آیه و ترجمه‌های چندزبانه)، در بخش `quran_verse` می‌توانید به سادگی شماره سوره (`surah_number` از ۱ تا ۱۱۴)، شماره آیه شروع (`ayah_from`)، شماره آیه پایان (`ayah_to`) و کلید مترجمان منتخب (`selected_translator_keys`) را مشخص کنید تا متن عربی و ترجمه‌ها به صورت خودکار از بانک مرکزی قرآن خوانده شوند. همچنین در صورت تمایل می‌توانید متن و ترجمه اختصاصی را نیز مستقیماً ارسال نمایید:
```json
{
@ -283,6 +520,15 @@
"description": { "ru": "Кто входит в Ахль аль-Бейт согласно суннитским источникам" },
"xmind_file_path": "xmind/tathir.xmind",
"quran_verse": {
"surah_number": 33,
"ayah_from": 33,
"ayah_to": 33,
"selected_translator_keys": [
"ru.kuliev",
"ru.krachkovsky",
"ru.osmanov",
"en.sahih"
],
"surah_name": { "ru": "Аль-Ахзаб (Союзники)", "ar": "الأحزاب", "en": "Al-Ahzab" },
"ayah_number": "33",
"arabic_text": "إِنَّمَا يُرِيدُ اللَّهُ لِيُذْهِبَ عَنكُمُ الرِّجْسَ أَهْلَ الْبَيْتِ وَيُطَهِّرَكُمْ تَطْهِيرًا",
@ -324,18 +570,17 @@
---
### فاز پنجم: احادیث (آرگومنت‌ها)، سلسله روات، تصحیحات و تفاسیر (`05_arguments_hadiths.json`)
این فایل قلب اصلی محتواست و شامل ۳ بخش است:
1. **`hadiths` (یا آرگومنت‌ها):** شامل متن اصلی، ترجمه، منابع، و **سلسله روات (`chains`)**.
2. **`corrections` (تصحیحات و بررسی اسناد حدیث):** زیرمجموعه‌های تحلیلی/تصحیحی که به یک حدیث خاص وصل می‌شوند.
3. **`interpretations` (تفاسیر و شروح):** متون تفسیری که به یک تاپیک (`topic_id`) وصل می‌شوند.
### گام پنجم: آرگومنت‌ها (احادیث، تاریخ، فتوا، نقل‌قول)، سلسله روات، تصحیحات، تفاسیر و کالکشن‌ها (`05_arguments_hadiths.json`)
#### چطور سلسله روات (`chains`) را در JSON بنویسیم؟
ما دو روش در اختیار شما گذاشته‌ایم:
- **روش ساده (فقط لیست کد یا شماره راویان):** اگر سلسله سند ساده است، فقط آرایه‌ای از کد راویان بدهید:
`"chains": [ ["nar_101", "nar_102", "nar_105"] ]`
- **روش پیشرفته (پشتیبانی از انقطاع در سند `is_gap`، راوی مردد `is_uncertain` و لایه/طبقه):** اگر در گره‌ای از سند تردید بین دو راوی وجود دارد یا افتادگی سند هست، به جای کد ساده، یک آبجکت بگذارید (در نمونه زیر هر دو حالت نشان داده شده است).
این فایل شامل محتوای اصلی است:
1. **`hadiths` (تمامی آرگومنت‌ها اعم از حدیث، تاریخ، فتوا، نقل‌قول):**
- هر آیتم می‌تواند به یک تاپیک اصلی (`primary_topic_id`) و در صورت نیاز به چند تاپیک دیگر (`additional_topic_ids`) متصل شود.
- همان‌طور که در بخش ۱ توضیح داده شد، اگر `title` یا `title_narrator` را خالی (`null`) بگذارید، سامانه آن‌ها را به صورت هوشمند از روی اولین منبع و اولین راوی/مولف پر می‌کند.
2. **`chains` (سلسله روات):**
- **حالت ساده:** اگر زنجیره سند بدون ابهام است، می‌توانید فقط آرایه‌ای از کد (یا شماره) راویان بفرستید: `"chains": [ ["nar_101", "nar_102", "nar_105"] ]`
- **حالت پیشرفته:** اگر یک حدیث چند طریق/شاخه دارد یا در نقطه‌ای از سند افتادگی (`is_gap: true`) یا تردید بین چند راوی (`is_uncertain: true` به همراه `uncertain_transmitter_ids`) وجود دارد، مطابق نمونه زیر به صورت آبجکت ارسال کنید.
3. **`corrections` (تصحیحات و بررسی‌های سندی هر حدیث)** و **`interpretations` (تفاسیر و شروح هر تاپیک)**.
4. **`collections` (مجموعه‌های منتخب صفحه اصلی - در صورت نیاز).**
```json
{
@ -348,14 +593,8 @@
"status_id": "status_sahih",
"hadis_status_text": { "ru": "Достоверный по условиям Муслима", "ar": "صحيح على شرط مسلم" },
"visibility": true,
"title": {
"ru": "Хадис аль-Киса (Хадис о плаще) от Умм Саламы",
"ar": "حديث الكساء عن أم سلمة"
},
"title_narrator": {
"ru": "Умм Салама",
"ar": "أم سلمة"
},
"title": null,
"title_narrator": null,
"text": "عَنْ أُمِّ سَلَمَةَ قَالَتْ: فِي بَيْتِي نَزَلَتْ: {إِنَّمَا يُرِيدُ اللَّهُ لِيُذْهِبَ عَنكُمُ الرِّجْسَ أَهْلَ الْبَيْتِ}...",
"translation": {
"ru": "Передается от Умм Саламы, что она сказала: «В моем доме был ниспослан аят: Поистине, Аллах желает избавить вас от скверны, о Ахль аль-Бейт...»",
@ -383,8 +622,8 @@
"ru": ["Сахих Муслим", "Книга достоинств сподвижников", "Глава о достоинствах Ахль аль-Бейт"]
},
"links": [
{ "title": "Sunnah.com", "link": "https://sunnah.com/muslim:2424" },
{ "title": "Dorar.net", "link": "https://dorar.net/hadith/123" }
{ "title": "Sunnah.com", "url": "https://sunnah.com/muslim:2424" },
{ "title": "Dorar.net", "url": "https://dorar.net/hadith/123" }
],
"tag_ids": ["tag_imamat"],
"chains": [
@ -425,16 +664,18 @@
{
"id": "corr_501",
"priority": 1,
"title": { "ru": "Оценка аль-Альбани", "ar": "تحقيق الألباني" },
"title": null,
"narrator": "Мухаммад Насируддин аль-Альбани",
"text": "قال الألباني في صحيح سنن الترمذي: صحيح",
"translation": { "ru": "Аль-Альбани сказал в «Сахих Сунан ат-Тирмизи»: Достоверно (Сахих)." },
"links": [
{ "title": "Источник", "link": "https://example.com/albani" }
{ "title": "Источник", "url": "https://example.com/albani" }
],
"references": [
{
"book_id": "book_sahih_tirmidhi",
"edition_id": null,
"volume_id": null,
"volume": "3",
"pages": "90",
"hadith_number": "3205",
@ -453,15 +694,19 @@
"topic_id": "topic_ayah_tathir",
"priority": 1,
"narrator": "Ибн Касир",
"title": { "ru": "Тафсир Ибн Касира к аяту 33 суры Аль-Ахзаб", "ar": "تفسير ابن كثير لآية التطهير" },
"title": null,
"text": "<p dir=\"rtl\">وهذا نص في دخول أزواج النبي صلى الله عليه وسلم في أهل البيت ههنا...</p>",
"translation": {
"ru": "<p>Толкование Ибн Касира и приведение хадисов о плаще...</p>"
},
"links": [],
"links": [
{ "title": "Тафсир онлайн", "url": "https://example.com/tafsir" }
],
"references": [
{
"book_id": "book_tafsir_ibn_kathir",
"edition_id": null,
"volume_id": null,
"volume": "6",
"pages": "410",
"hadith_number": null,
@ -471,15 +716,27 @@
}
]
}
],
"collections": [
{
"id": "col_featured_imamat",
"display_position": "pinned",
"order": 1,
"status": true,
"title": { "ru": "Важнейшие хадисы об Имамате", "ar": "أهم أحاديث الإمامة" },
"summary": { "ru": "Подборка ключевых аргументов из достоверных источников" },
"thumbnail_path": "collections/imamat.jpg",
"hadith_ids": ["hadith_1001"]
}
]
}
```
---
## ۳. ساختار پیشنهادی پوشه ارسالی (Media + JSON)
## ۴. ساختار پوشه ارسالی (فایل‌های JSON به همراه تصاویر و مستندات)
اگر همراه با داده‌ها، **تصاویر اسکرین‌شات منابع، عکس جلد کتاب‌ها، فایل‌های PDF یا فایل‌های XMind** دارید، کافی است کل پکیج را در یک فایل فشرده (`ZIP`) با ساختار پوشه‌بندی زیر قرار دهید و مسیر نسبی آن‌ها را در فیلدهای مربوطه بنویسید:
در صورتی که همراه با داده‌ها، فایل‌های پیوست (اسکرین‌شات منابع، تصاویر جلد کتاب‌ها، فایل‌های PDF یا فایل‌های XMind) دارید، کافی است کل پکیج را در قالب یک فایل فشرده (`ZIP`) مطابق پوشه‌بندی زیر قرار دهید و مسیر نسبی فایل‌ها را در JSON درج نمایید:
```text
import_package/
@ -489,9 +746,14 @@ import_package/
├── 04_categories_and_quran.json
├── 05_arguments_hadiths.json
└── media/
├── authors/ # تصاویر مولفین و علما
├── books/ # عکس جلدها و فایل‌های PDF هر کتاب/چاپ/جلد
├── xmind/ # فایل‌های XMind دسته‌بندی‌ها
├── authors/ # تصاویر مولفان و علما
├── books/ # تصاویر جلدها و فایل‌های PDF هر کتاب/چاپ/جلد
├── collections/ # تصاویر کاور مجموعه‌ها (Collections)
├── screens/ # اسکرین‌شات‌های منابع احادیث، تصحیحات و تفاسیر
└── screens_trx/ # اسکرین‌شات‌های منابع متون رجالی راویان (Original Texts)
```
---
### جمع‌بندی و گام بعدی همکاری
ما می‌توانیم این فرآیند را **مرحله‌به‌مرحله** پیش ببریم؛ یعنی ابتدا از گام ۱ و ۲ (اطلاعات پایه، راویان و علما) یا هر بخشی که در دیتابیس شما آماده‌تر است یک نمونه خروجی ارسال فرمایید تا تست و بررسی کنیم و در صورت نیاز به هرگونه تطبیق با ساختار دیتابیس شما، اسکریپت ایمپورت را دقیقاً مطابق خروجی شما تنظیم نماییم.
Loading…
Cancel
Save