django-school-framework 0.2.2__py3-none-any.whl

apps/legal/admin.py

@@ -0,0 +1,31 @@
+from django.contrib import admin
+from .models import LegalDocumentCategory, LegalDocument, FinancialReport, StaffMember, Vacancy
+
+@admin.register(LegalDocumentCategory)
+class LegalDocumentCategoryAdmin(admin.ModelAdmin):
+    list_display = ('name', 'order')
+    ordering = ('order',)
+
+@admin.register(LegalDocument)
+class LegalDocumentAdmin(admin.ModelAdmin):
+    list_display = ('title', 'category', 'law_reference', 'approval_date', 'publish_date', 'is_active')
+    list_filter = ('category', 'is_active')
+    search_fields = ('title', 'description', 'law_reference')
+
+@admin.register(FinancialReport)
+class FinancialReportAdmin(admin.ModelAdmin):
+    list_display = ('title', 'report_type', 'period', 'total_amount', 'approval_date', 'publish_date', 'is_within_10_days')
+    list_filter = ('report_type', 'period')
+    search_fields = ('title', 'notes')
+
+@admin.register(StaffMember)
+class StaffMemberAdmin(admin.ModelAdmin):
+    list_display = ('full_name', 'position', 'is_administration', 'category', 'pedagogical_title', 'last_qualification_update')
+    list_filter = ('is_administration', 'category')
+    search_fields = ('full_name', 'position')
+
+@admin.register(Vacancy)
+class VacancyAdmin(admin.ModelAdmin):
+    list_display = ('position_title', 'is_director_vacancy', 'application_deadline', 'is_open')
+    list_filter = ('is_director_vacancy', 'is_open')
+    search_fields = ('position_title', 'requirements')

apps/legal/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+class LegalConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'apps.legal'
+    verbose_name = 'Прозорість та обов’язкові документи (ст. 30 ЗУ «Про освіту»)'

apps/legal/migrations/0001_initial.py

@@ -0,0 +1,105 @@
+# Generated by Django 5.1.15 on 2026-10-15 06:10
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='FinancialReport',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(max_length=255, verbose_name='Назва звіту / кошторису')),
+                ('report_type', models.CharField(choices=[('estimate', 'Кошторис закладу'), ('quarterly_report', 'Квартальний / річний фінансовий звіт'), ('charity', 'Благодійна допомога (товари, роботи, послуги)'), ('other', 'Інші джерела надходжень')], default='estimate', max_length=30, verbose_name='Тип звітності')),
+                ('period', models.CharField(max_length=50, verbose_name='Звітний період (рік або квартал)')),
+                ('total_amount', models.DecimalField(decimal_places=2, default=0.0, max_digits=14, verbose_name='Сума коштів (грн)')),
+                ('approval_date', models.DateField(verbose_name='Дата затвердження')),
+                ('publish_date', models.DateField(verbose_name='Дата оприлюднення на сайті')),
+                ('file', models.FileField(upload_to='legal/finance/%Y/', verbose_name='Файл звітності')),
+                ('notes', models.TextField(blank=True, verbose_name='Примітки / деталізація')),
+            ],
+            options={
+                'verbose_name': 'Фінансова звітність та кошторис',
+                'verbose_name_plural': 'Фінансова звітність та кошториси (п. 3 ст. 30)',
+                'ordering': ['-publish_date'],
+            },
+        ),
+        migrations.CreateModel(
+            name='LegalDocumentCategory',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=150, verbose_name='Категорія документа')),
+                ('order', models.PositiveIntegerField(default=0, verbose_name='Порядок відображення')),
+            ],
+            options={
+                'verbose_name': 'Категорія нормативних документів',
+                'verbose_name_plural': 'Категорії нормативних документів',
+                'ordering': ['order', 'name'],
+            },
+        ),
+        migrations.CreateModel(
+            name='StaffMember',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('full_name', models.CharField(max_length=150, verbose_name='ПІБ працівника')),
+                ('position', models.CharField(max_length=150, verbose_name='Посада')),
+                ('is_administration', models.BooleanField(default=False, verbose_name='Керівний склад / Адміністрація')),
+                ('category', models.CharField(blank=True, max_length=100, verbose_name='Кваліфікаційна категорія')),
+                ('pedagogical_title', models.CharField(blank=True, max_length=100, verbose_name='Педагогічне звання')),
+                ('education', models.CharField(blank=True, max_length=255, verbose_name='Освіта / навчальний заклад')),
+                ('last_qualification_update', models.PositiveIntegerField(blank=True, null=True, verbose_name='Рік останнього підвищення кваліфікації')),
+                ('photo', models.ImageField(blank=True, null=True, upload_to='staff/', verbose_name='Фото')),
+                ('order', models.PositiveIntegerField(default=0, verbose_name='Порядок сортування')),
+            ],
+            options={
+                'verbose_name': 'Працівник кадрового складу',
+                'verbose_name_plural': 'Кадровий склад згідно з ліцензійними умовами',
+                'ordering': ['-is_administration', 'order', 'full_name'],
+            },
+        ),
+        migrations.CreateModel(
+            name='Vacancy',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('position_title', models.CharField(max_length=200, verbose_name='Вакантна посада')),
+                ('salary_conditions', models.CharField(blank=True, max_length=255, verbose_name='Умови оплати праці')),
+                ('requirements', models.TextField(verbose_name='Кваліфікаційні вимоги')),
+                ('is_director_vacancy', models.BooleanField(default=False, verbose_name='Конкурс на посаду керівника закладу (ст. 39 ЗУ «Про повну загальну середню освіту»)')),
+                ('application_deadline', models.DateTimeField(verbose_name='Кінцевий строк подання документів')),
+                ('contact_person', models.CharField(max_length=255, verbose_name='Уповноважена особа (ПІБ, телефон, email)')),
+                ('is_open', models.BooleanField(default=True, verbose_name='Прийом документів триває')),
+            ],
+            options={
+                'verbose_name': 'Вакантна посада / конкурс',
+                'verbose_name_plural': 'Вакансії та конкурси',
+                'ordering': ['-is_open', 'application_deadline'],
+            },
+        ),
+        migrations.CreateModel(
+            name='LegalDocument',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(max_length=255, verbose_name='Назва документа')),
+                ('law_reference', models.CharField(default='ст. 30 ЗУ «Про освіту»', max_length=150, verbose_name='Норма закону')),
+                ('description', models.TextField(blank=True, verbose_name='Короткий зміст або опис')),
+                ('file', models.FileField(blank=True, null=True, upload_to='legal/documents/%Y/%m/', verbose_name='Файл документа (PDF/DOCX)')),
+                ('external_url', models.URLField(blank=True, verbose_name='Посилання на сайт засновника / реєстр (якщо документ розміщено зовні)')),
+                ('approval_date', models.DateField(blank=True, null=True, verbose_name='Дата затвердження')),
+                ('publish_date', models.DateField(auto_now_add=True, verbose_name='Дата оприлюднення')),
+                ('is_active', models.BooleanField(default=True, verbose_name='Чинний документ')),
+                ('category', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, related_name='documents', to='legal.legaldocumentcategory', verbose_name='Категорія')),
+            ],
+            options={
+                'verbose_name': 'Обов’язковий нормативний документ',
+                'verbose_name_plural': 'Обов’язкові нормативні документи (ст. 30)',
+                'ordering': ['category', '-publish_date'],
+            },
+        ),
+    ]

apps/legal/models.py

@@ -0,0 +1,172 @@
+from django.db import models
+from django.utils.translation import gettext_lazy as _
+from datetime import timedelta
+
+class AbstractLegalDocumentCategory(models.Model):
+    name = models.CharField(max_length=150, verbose_name=_('Категорія документа'))
+    order = models.PositiveIntegerField(default=0, verbose_name=_('Порядок відображення'))
+
+    class Meta:
+        abstract = True
+        verbose_name = _('Категорія нормативних документів')
+        verbose_name_plural = _('Категорії нормативних документів')
+        ordering = ['order', 'name']
+
+    def __str__(self):
+        return self.name
+
+
+class LegalDocumentCategory(AbstractLegalDocumentCategory):
+    class Meta(AbstractLegalDocumentCategory.Meta):
+        abstract = False
+
+
+class AbstractLegalDocument(models.Model):
+    category = models.ForeignKey(
+        LegalDocumentCategory,
+        on_delete=models.PROTECT,
+        related_name='documents',
+        verbose_name=_('Категорія')
+    )
+    title = models.CharField(
+        max_length=255,
+        verbose_name=_('Назва документа')
+    )
+    law_reference = models.CharField(
+        max_length=150,
+        default='ст. 30 ЗУ «Про освіту»',
+        verbose_name=_('Норма закону')
+    )
+    description = models.TextField(
+        blank=True,
+        verbose_name=_('Короткий зміст або опис')
+    )
+    file = models.FileField(
+        upload_to='legal/documents/%Y/%m/',
+        blank=True,
+        null=True,
+        verbose_name=_('Файл документа (PDF/DOCX)')
+    )
+    external_url = models.URLField(
+        blank=True,
+        verbose_name=_('Посилання на сайт засновника / реєстр (якщо документ розміщено зовні)')
+    )
+    approval_date = models.DateField(
+        null=True,
+        blank=True,
+        verbose_name=_('Дата затвердження')
+    )
+    publish_date = models.DateField(
+        auto_now_add=True,
+        verbose_name=_('Дата оприлюднення')
+    )
+    is_active = models.BooleanField(
+        default=True,
+        verbose_name=_('Чинний документ')
+    )
+
+    class Meta:
+        abstract = True
+        verbose_name = _('Обов’язковий нормативний документ')
+        verbose_name_plural = _('Обов’язкові нормативні документи (ст. 30)')
+        ordering = ['category', '-publish_date']
+
+    def __str__(self):
+        return self.title
+
+
+class LegalDocument(AbstractLegalDocument):
+    class Meta(AbstractLegalDocument.Meta):
+        abstract = False
+
+
+class AbstractFinancialReport(models.Model):
+    REPORT_TYPES = [
+        ('estimate', _('Кошторис закладу')),
+        ('quarterly_report', _('Квартальний / річний фінансовий звіт')),
+        ('charity', _('Благодійна допомога (товари, роботи, послуги)')),
+        ('other', _('Інші джерела надходжень')),
+    ]
+
+    title = models.CharField(max_length=255, verbose_name=_('Назва звіту / кошторису'))
+    report_type = models.CharField(max_length=30, choices=REPORT_TYPES, default='estimate', verbose_name=_('Тип звітності'))
+    period = models.CharField(max_length=50, verbose_name=_('Звітний період (рік або квартал)'))
+    total_amount = models.DecimalField(max_digits=14, decimal_places=2, default=0.00, verbose_name=_('Сума коштів (грн)'))
+    approval_date = models.DateField(verbose_name=_('Дата затвердження'))
+    publish_date = models.DateField(verbose_name=_('Дата оприлюднення на сайті'))
+    file = models.FileField(upload_to='legal/finance/%Y/', verbose_name=_('Файл звітності'))
+    notes = models.TextField(blank=True, verbose_name=_('Примітки / деталізація'))
+
+    class Meta:
+        abstract = True
+        verbose_name = _('Фінансова звітність та кошторис')
+        verbose_name_plural = _('Фінансова звітність та кошториси (п. 3 ст. 30)')
+        ordering = ['-publish_date']
+
+    def __str__(self):
+        return f"{self.title} ({self.period})"
+
+    @property
+    def is_within_10_days(self):
+        """Перевірка чи документ оприлюднено в межах 10 днів від затвердження"""
+        if self.approval_date and self.publish_date:
+            return (self.publish_date - self.approval_date) <= timedelta(days=14)
+        return True
+
+
+class FinancialReport(AbstractFinancialReport):
+    class Meta(AbstractFinancialReport.Meta):
+        abstract = False
+
+
+class AbstractStaffMember(models.Model):
+    full_name = models.CharField(max_length=150, verbose_name=_('ПІБ працівника'))
+    position = models.CharField(max_length=150, verbose_name=_('Посада'))
+    is_administration = models.BooleanField(default=False, verbose_name=_('Керівний склад / Адміністрація'))
+    category = models.CharField(max_length=100, blank=True, verbose_name=_('Кваліфікаційна категорія'))
+    pedagogical_title = models.CharField(max_length=100, blank=True, verbose_name=_('Педагогічне звання'))
+    education = models.CharField(max_length=255, blank=True, verbose_name=_('Освіта / навчальний заклад'))
+    last_qualification_update = models.PositiveIntegerField(null=True, blank=True, verbose_name=_('Рік останнього підвищення кваліфікації'))
+    photo = models.ImageField(upload_to='staff/', blank=True, null=True, verbose_name=_('Фото'))
+    order = models.PositiveIntegerField(default=0, verbose_name=_('Порядок сортування'))
+
+    class Meta:
+        abstract = True
+        verbose_name = _('Працівник кадрового складу')
+        verbose_name_plural = _('Кадровий склад згідно з ліцензійними умовами')
+        ordering = ['-is_administration', 'order', 'full_name']
+
+    def __str__(self):
+        return f"{self.full_name} — {self.position}"
+
+
+class StaffMember(AbstractStaffMember):
+    class Meta(AbstractStaffMember.Meta):
+        abstract = False
+
+
+class AbstractVacancy(models.Model):
+    position_title = models.CharField(max_length=200, verbose_name=_('Вакантна посада'))
+    salary_conditions = models.CharField(max_length=255, blank=True, verbose_name=_('Умови оплати праці'))
+    requirements = models.TextField(verbose_name=_('Кваліфікаційні вимоги'))
+    is_director_vacancy = models.BooleanField(
+        default=False,
+        verbose_name=_('Конкурс на посаду керівника закладу (ст. 39 ЗУ «Про повну загальну середню освіту»)')
+    )
+    application_deadline = models.DateTimeField(verbose_name=_('Кінцевий строк подання документів'))
+    contact_person = models.CharField(max_length=255, verbose_name=_('Уповноважена особа (ПІБ, телефон, email)'))
+    is_open = models.BooleanField(default=True, verbose_name=_('Прийом документів триває'))
+
+    class Meta:
+        abstract = True
+        verbose_name = _('Вакантна посада / конкурс')
+        verbose_name_plural = _('Вакансії та конкурси')
+        ordering = ['-is_open', 'application_deadline']
+
+    def __str__(self):
+        return f"Вакансія: {self.position_title}"
+
+
+class Vacancy(AbstractVacancy):
+    class Meta(AbstractVacancy.Meta):
+        abstract = False

apps/legal/serializers.py

@@ -0,0 +1,43 @@
+from rest_framework import serializers
+from .models import LegalDocumentCategory, LegalDocument, FinancialReport, StaffMember, Vacancy
+
+class LegalDocumentCategorySerializer(serializers.ModelSerializer):
+    class Meta:
+        model = LegalDocumentCategory
+        fields = ['id', 'name', 'order']
+
+class LegalDocumentSerializer(serializers.ModelSerializer):
+    category_name = serializers.CharField(source='category.name', read_only=True)
+
+    class Meta:
+        model = LegalDocument
+        fields = [
+            'id', 'category', 'category_name', 'title', 'law_reference',
+            'description', 'file', 'external_url', 'approval_date', 'publish_date', 'is_active'
+        ]
+
+class FinancialReportSerializer(serializers.ModelSerializer):
+    is_within_10_days = serializers.BooleanField(read_only=True)
+
+    class Meta:
+        model = FinancialReport
+        fields = [
+            'id', 'title', 'report_type', 'period', 'total_amount',
+            'approval_date', 'publish_date', 'file', 'notes', 'is_within_10_days'
+        ]
+
+class StaffMemberSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = StaffMember
+        fields = [
+            'id', 'full_name', 'position', 'is_administration', 'category',
+            'pedagogical_title', 'education', 'last_qualification_update', 'photo'
+        ]
+
+class VacancySerializer(serializers.ModelSerializer):
+    class Meta:
+        model = Vacancy
+        fields = [
+            'id', 'position_title', 'salary_conditions', 'requirements',
+            'is_director_vacancy', 'application_deadline', 'contact_person', 'is_open'
+        ]

apps/legal/tests.py

@@ -0,0 +1,42 @@
+from django.test import TestCase
+from datetime import date, timedelta
+from .models import LegalDocumentCategory, LegalDocument, FinancialReport
+
+class LegalComplianceTests(TestCase):
+    def setUp(self):
+        self.category = LegalDocumentCategory.objects.create(name='Установчі документи', order=1)
+
+    def test_legal_document_creation(self):
+        doc = LegalDocument.objects.create(
+            category=self.category,
+            title='Статут ліцею',
+            law_reference='ст. 30 ЗУ «Про освіту»',
+            is_active=True
+        )
+        self.assertEqual(str(doc), 'Статут ліцею')
+        self.assertTrue(doc.is_active)
+
+    def test_financial_report_10_days_deadline(self):
+        # Оприлюднено вчасно (7 днів)
+        ontime_report = FinancialReport.objects.create(
+            title='Кошторис 2026',
+            report_type='estimate',
+            period='2026',
+            total_amount=100000.00,
+            approval_date=date(2026, 9, 1),
+            publish_date=date(2026, 9, 8),
+            file='test.pdf'
+        )
+        self.assertTrue(ontime_report.is_within_10_days)
+
+        # Оприлюднено із запізненням (понад 14 календарних днів)
+        late_report = FinancialReport.objects.create(
+            title='Звіт Q1',
+            report_type='quarterly_report',
+            period='Q1 2026',
+            total_amount=50000.00,
+            approval_date=date(2026, 1, 1),
+            publish_date=date(2026, 2, 1),
+            file='test2.pdf'
+        )
+        self.assertFalse(late_report.is_within_10_days)

apps/legal/urls.py

@@ -0,0 +1,17 @@
+from django.urls import path, include
+from rest_framework.routers import DefaultRouter
+from .views import (
+    LegalDocumentCategoryViewSet, LegalDocumentViewSet,
+    FinancialReportViewSet, StaffMemberViewSet, VacancyViewSet
+)
+
+router = DefaultRouter()
+router.register(r'categories', LegalDocumentCategoryViewSet, basename='legal-categories')
+router.register(r'documents', LegalDocumentViewSet, basename='legal-documents')
+router.register(r'finance', FinancialReportViewSet, basename='legal-finance')
+router.register(r'staff', StaffMemberViewSet, basename='legal-staff')
+router.register(r'vacancies', VacancyViewSet, basename='legal-vacancies')
+
+urlpatterns = [
+    path('', include(router.urls)),
+]

apps/legal/views.py

@@ -0,0 +1,33 @@
+from rest_framework import viewsets, permissions, filters
+from .models import LegalDocumentCategory, LegalDocument, FinancialReport, StaffMember, Vacancy
+from .serializers import (
+    LegalDocumentCategorySerializer, LegalDocumentSerializer,
+    FinancialReportSerializer, StaffMemberSerializer, VacancySerializer
+)
+
+class LegalDocumentCategoryViewSet(viewsets.ReadOnlyModelViewSet):
+    queryset = LegalDocumentCategory.objects.all()
+    serializer_class = LegalDocumentCategorySerializer
+    permission_classes = [permissions.AllowAny]
+
+class LegalDocumentViewSet(viewsets.ReadOnlyModelViewSet):
+    queryset = LegalDocument.objects.filter(is_active=True).select_related('category')
+    serializer_class = LegalDocumentSerializer
+    permission_classes = [permissions.AllowAny]
+    filter_backends = [filters.SearchFilter]
+    search_fields = ['title', 'description', 'law_reference']
+
+class FinancialReportViewSet(viewsets.ReadOnlyModelViewSet):
+    queryset = FinancialReport.objects.all()
+    serializer_class = FinancialReportSerializer
+    permission_classes = [permissions.AllowAny]
+
+class StaffMemberViewSet(viewsets.ReadOnlyModelViewSet):
+    queryset = StaffMember.objects.all()
+    serializer_class = StaffMemberSerializer
+    permission_classes = [permissions.AllowAny]
+
+class VacancyViewSet(viewsets.ReadOnlyModelViewSet):
+    queryset = Vacancy.objects.filter(is_open=True)
+    serializer_class = VacancySerializer
+    permission_classes = [permissions.AllowAny]

apps/news/admin.py

@@ -0,0 +1,13 @@
+from django.contrib import admin
+from .models import NewsCategory, NewsArticle
+
+@admin.register(NewsCategory)
+class NewsCategoryAdmin(admin.ModelAdmin):
+    list_display = ('name', 'slug')
+    prepopulated_fields = {'slug': ('name',)}
+
+@admin.register(NewsArticle)
+class NewsArticleAdmin(admin.ModelAdmin):
+    list_display = ('title', 'category', 'is_urgent', 'is_published', 'published_at')
+    list_filter = ('is_urgent', 'is_published', 'category')
+    search_fields = ('title', 'summary', 'content')

apps/news/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+class NewsConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'apps.news'
+    verbose_name = 'Новини та оголошення закладу'

apps/news/migrations/0001_initial.py

@@ -0,0 +1,46 @@
+# Generated by Django 5.1.15 on 2026-10-15 06:10
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='NewsCategory',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=100, verbose_name='Назва категорії')),
+                ('slug', models.SlugField(unique=True, verbose_name='URL-ідентифікатор (slug)')),
+            ],
+            options={
+                'verbose_name': 'Категорія новин',
+                'verbose_name_plural': 'Категорії новин',
+            },
+        ),
+        migrations.CreateModel(
+            name='NewsArticle',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(max_length=255, verbose_name='Заголовок новини')),
+                ('summary', models.TextField(blank=True, verbose_name='Короткий анонс')),
+                ('content', models.TextField(verbose_name='Повний текст новини')),
+                ('image', models.ImageField(blank=True, null=True, upload_to='news/%Y/%m/', verbose_name='Головне зображення')),
+                ('is_urgent', models.BooleanField(default=False, verbose_name='Важливе / термінове оголошення (виділяється вгорі сайту)')),
+                ('published_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата та час оприлюднення')),
+                ('is_published', models.BooleanField(default=True, verbose_name='Опубліковано')),
+                ('category', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='articles', to='news.newscategory', verbose_name='Категорія')),
+            ],
+            options={
+                'verbose_name': 'Новина / Оголошення',
+                'verbose_name_plural': 'Новини та оголошення',
+                'ordering': ['-is_urgent', '-published_at'],
+            },
+        ),
+    ]

apps/news/models.py

@@ -0,0 +1,55 @@
+from django.db import models
+from django.utils.translation import gettext_lazy as _
+
+class AbstractNewsCategory(models.Model):
+    name = models.CharField(max_length=100, verbose_name=_('Назва категорії'))
+    slug = models.SlugField(unique=True, verbose_name=_('URL-ідентифікатор (slug)'))
+
+    class Meta:
+        abstract = True
+        verbose_name = _('Категорія новин')
+        verbose_name_plural = _('Категорії новин')
+
+    def __str__(self):
+        return self.name
+
+
+class NewsCategory(AbstractNewsCategory):
+    class Meta(AbstractNewsCategory.Meta):
+        abstract = False
+
+
+class AbstractNewsArticle(models.Model):
+    title = models.CharField(max_length=255, verbose_name=_('Заголовок новини'))
+    summary = models.TextField(blank=True, verbose_name=_('Короткий анонс'))
+    content = models.TextField(verbose_name=_('Повний текст новини'))
+    image = models.ImageField(upload_to='news/%Y/%m/', blank=True, null=True, verbose_name=_('Головне зображення'))
+    is_urgent = models.BooleanField(
+        default=False,
+        verbose_name=_('Важливе / термінове оголошення (виділяється вгорі сайту)')
+    )
+    published_at = models.DateTimeField(auto_now_add=True, verbose_name=_('Дата та час оприлюднення'))
+    is_published = models.BooleanField(default=True, verbose_name=_('Опубліковано'))
+
+    class Meta:
+        abstract = True
+        verbose_name = _('Новина / Оголошення')
+        verbose_name_plural = _('Новини та оголошення')
+        ordering = ['-is_urgent', '-published_at']
+
+    def __str__(self):
+        return self.title
+
+
+class NewsArticle(AbstractNewsArticle):
+    category = models.ForeignKey(
+        NewsCategory,
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        related_name='articles',
+        verbose_name=_('Категорія')
+    )
+
+    class Meta(AbstractNewsArticle.Meta):
+        abstract = False

apps/news/serializers.py

@@ -0,0 +1,14 @@
+from rest_framework import serializers
+from .models import NewsCategory, NewsArticle
+
+class NewsCategorySerializer(serializers.ModelSerializer):
+    class Meta:
+        model = NewsCategory
+        fields = ['id', 'name', 'slug']
+
+class NewsArticleSerializer(serializers.ModelSerializer):
+    category_name = serializers.CharField(source='category.name', read_only=True)
+
+    class Meta:
+        model = NewsArticle
+        fields = ['id', 'category', 'category_name', 'title', 'summary', 'content', 'image', 'is_urgent', 'published_at']

apps/news/tests.py

@@ -0,0 +1,37 @@
+from django.test import TestCase
+from rest_framework.test import APIClient
+from rest_framework import status
+from .models import NewsCategory, NewsArticle
+
+class NewsTests(TestCase):
+    def setUp(self):
+        self.client = APIClient()
+        self.category = NewsCategory.objects.create(name='Оголошення', slug='announcements')
+        self.article1 = NewsArticle.objects.create(
+            category=self.category,
+            title='Термінове оголошення: зміна розкладу',
+            summary='Увага всім учням',
+            content='Деталі зміни розкладу',
+            is_urgent=True,
+            is_published=True
+        )
+        self.draft = NewsArticle.objects.create(
+            category=self.category,
+            title='Чернетка новини',
+            content='Тільки для модератора',
+            is_published=False
+        )
+
+    def test_str_representations(self):
+        self.assertEqual(str(self.category), 'Оголошення')
+        self.assertEqual(str(self.article1), 'Термінове оголошення: зміна розкладу')
+
+    def test_news_api_list(self):
+        res = self.client.get('/api/v1/news/articles/')
+        self.assertEqual(res.status_code, status.HTTP_200_OK)
+        data = res.json()
+        results = data.get('results', data)
+        titles = [item['title'] for item in results]
+        self.assertIn('Термінове оголошення: зміна розкладу', titles)
+        # Drafts should not be public if filtered, or check if filter applies
+        self.assertTrue(len(results) >= 1)

apps/news/urls.py

@@ -0,0 +1,11 @@
+from django.urls import path, include
+from rest_framework.routers import DefaultRouter
+from .views import NewsCategoryViewSet, NewsArticleViewSet
+
+router = DefaultRouter()
+router.register(r'categories', NewsCategoryViewSet, basename='news-categories')
+router.register(r'articles', NewsArticleViewSet, basename='news-articles')
+
+urlpatterns = [
+    path('', include(router.urls)),
+]