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

apps/core/models.py

@@ -0,0 +1,134 @@
+from django.db import models
+from django.utils.translation import gettext_lazy as _
+
+class AbstractSchoolProfile(models.Model):
+    """
+    Абстрактна базова модель профілю закладу загальної середньої освіти.
+    Розробники можуть наслідувати цей клас для додавання специфічних полів (наприклад, типи спеціалізацій, філії).
+    """
+    name = models.CharField(
+        max_length=255,
+        verbose_name=_('Повна назва закладу освіти'),
+        help_text=_('Наприклад: Ліцей "Інтелект та Інновації" Київської міської ради')
+    )
+    short_name = models.CharField(
+        max_length=100,
+        blank=True,
+        verbose_name=_('Скорочена назва')
+    )
+    edrpou = models.CharField(
+        max_length=10,
+        unique=True,
+        verbose_name=_('Код ЄДРПОУ')
+    )
+    founder = models.CharField(
+        max_length=255,
+        verbose_name=_('Засновник закладу освіти'),
+        help_text=_('Орган державної влади, відповідна рада територіальної громади або уповноважена особа')
+    )
+    address = models.CharField(
+        max_length=255,
+        verbose_name=_('Місцезнаходження (юридична адреса)')
+    )
+    phone = models.CharField(
+        max_length=50,
+        verbose_name=_('Контактний телефон')
+    )
+    email = models.EmailField(
+        verbose_name=_('Офіційна електронна адреса')
+    )
+    website = models.URLField(
+        blank=True,
+        verbose_name=_('Адреса веб-сайту')
+    )
+    licensed_capacity = models.PositiveIntegerField(
+        default=0,
+        verbose_name=_('Ліцензований обсяг (кількість учнів)')
+    )
+    actual_students = models.PositiveIntegerField(
+        default=0,
+        verbose_name=_('Фактична кількість здобувачів освіти')
+    )
+    education_language = models.CharField(
+        max_length=100,
+        default='Українська',
+        verbose_name=_('Мова (мови) освітнього процесу')
+    )
+    logo = models.ImageField(
+        upload_to='school/logo/',
+        blank=True,
+        null=True,
+        verbose_name=_('Логотип / герб закладу')
+    )
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        abstract = True
+        verbose_name = _('Профіль закладу освіти')
+        verbose_name_plural = _('Профіль закладу освіти')
+        ordering = ['id']
+
+    def __str__(self):
+        return f"{self.name} (ЄДРПОУ {self.edrpou})"
+
+
+class SchoolProfile(AbstractSchoolProfile):
+    """Стандартна реалізація профілю школи за замовчуванням."""
+    class Meta(AbstractSchoolProfile.Meta):
+        abstract = False
+
+
+class AbstractThemeSettings(models.Model):
+    """
+    Абстрактна базова модель налаштувань теми та колірного оформлення.
+    """
+    primary_color = models.CharField(
+        max_length=20,
+        default='#1e3a8a',
+        verbose_name=_('Основний колір (Primary Hex)')
+    )
+    primary_hover = models.CharField(
+        max_length=20,
+        default='#172554',
+        verbose_name=_('Колір при наведенні (Primary Hover Hex)')
+    )
+    secondary_color = models.CharField(
+        max_length=20,
+        default='#059669',
+        verbose_name=_('Додатковий колір (Secondary Hex)')
+    )
+    accent_color = models.CharField(
+        max_length=20,
+        default='#d97706',
+        verbose_name=_('Акцентний колір (Accent Hex)')
+    )
+    font_family = models.CharField(
+        max_length=100,
+        default='Inter, system-ui, sans-serif',
+        verbose_name=_('Основний шрифт')
+    )
+
+    class Meta:
+        abstract = True
+        verbose_name = _('Налаштування теми та брендингу')
+        verbose_name_plural = _('Налаштування тем та брендингу')
+
+    def __str__(self):
+        return f"Тема для закладу освіти"
+
+
+class ThemeSettings(AbstractThemeSettings):
+    """Стандартна реалізація теми, прив'язана до SchoolProfile."""
+    school = models.OneToOneField(
+        SchoolProfile,
+        on_delete=models.CASCADE,
+        related_name='theme',
+        verbose_name=_('Заклад освіти')
+    )
+
+    class Meta(AbstractThemeSettings.Meta):
+        abstract = False
+
+    def __str__(self):
+        return f"Тема для {self.school.name}"

apps/core/serializers.py

@@ -0,0 +1,18 @@
+from rest_framework import serializers
+from .models import SchoolProfile, ThemeSettings
+
+class ThemeSettingsSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = ThemeSettings
+        fields = ['primary_color', 'primary_hover', 'secondary_color', 'accent_color', 'font_family']
+
+class SchoolProfileSerializer(serializers.ModelSerializer):
+    theme = ThemeSettingsSerializer(read_only=True)
+
+    class Meta:
+        model = SchoolProfile
+        fields = [
+            'id', 'name', 'short_name', 'edrpou', 'founder', 'address',
+            'phone', 'email', 'website', 'licensed_capacity', 'actual_students',
+            'education_language', 'logo', 'theme', 'updated_at'
+        ]

apps/core/templatetags/__init__.py

@@ -0,0 +1 @@
+# Template tags for core app

apps/core/templatetags/compliance_tags.py

@@ -0,0 +1,13 @@
+from django import template
+from apps.core.compliance import ComplianceAuditor
+
+register = template.Library()
+
+
+@register.simple_tag
+def get_compliance_report():
+    """
+    Повертає аудит-звіт відповідності закладу освіти вимогам
+    ст. 30 ЗУ «Про освіту» та суміжного законодавства.
+    """
+    return ComplianceAuditor.get_audit_report()

apps/core/tests.py

@@ -0,0 +1,123 @@
+from pathlib import Path
+from django.test import TestCase
+from rest_framework.test import APIClient
+from rest_framework import status
+from .models import SchoolProfile, ThemeSettings
+
+class CoreModelAndApiTests(TestCase):
+    def setUp(self):
+        self.client = APIClient()
+        self.profile = SchoolProfile.objects.create(
+            name='Ліцей №1 м. Києва',
+            short_name='Ліцей №1',
+            edrpou='12345678',
+            founder='Київська міська рада',
+            address='вул. Хрещатик, 1, м. Київ',
+            phone='+380 44 111-22-33',
+            email='school1@kyiv.edu.ua',
+            licensed_capacity=1000,
+            actual_students=950,
+            education_language='Українська'
+        )
+        self.theme = ThemeSettings.objects.create(
+            school=self.profile,
+            primary_color='#1e3a8a',
+            primary_hover='#172554',
+            secondary_color='#059669',
+            accent_color='#d97706'
+        )
+
+    def test_school_profile_str(self):
+        self.assertEqual(str(self.profile), 'Ліцей №1 м. Києва (ЄДРПОУ 12345678)')
+
+    def test_theme_settings_str(self):
+        self.assertIn('Ліцей №1 м. Києва', str(self.theme))
+
+    def test_profile_api_read_only(self):
+        res = self.client.get('/api/v1/core/profile/')
+        self.assertEqual(res.status_code, status.HTTP_200_OK)
+        data = res.json()
+        results = data.get('results', data)
+        self.assertTrue(len(results) > 0)
+        item = results[0]
+        self.assertEqual(item['edrpou'], '12345678')
+        self.assertIn('theme', item)
+        self.assertEqual(item['theme']['primary_color'], '#1e3a8a')
+
+    def test_manifest_capabilities_api(self):
+        res = self.client.get('/api/v1/core/manifest/')
+        self.assertEqual(res.status_code, status.HTTP_200_OK)
+        data = res.json()
+        self.assertIn('school', data)
+        self.assertEqual(data['school']['name'], 'Ліцей №1 м. Києва')
+        self.assertIn('modules', data)
+        self.assertTrue(data['modules']['legal'])
+        self.assertIn('navigation', data)
+        self.assertTrue(len(data['navigation']) > 0)
+        self.assertIn('compliance', data)
+        self.assertTrue(data['compliance']['article_30'])
+
+    def test_compliance_auditor_and_api(self):
+        from .compliance import ComplianceAuditor
+        report = ComplianceAuditor.get_audit_report()
+        self.assertIn('score', report)
+        self.assertIn('checks', report)
+        self.assertIn('warnings', report)
+        self.assertTrue(report['total_count'] > 0)
+
+        # Test API endpoint
+        res = self.client.get('/api/v1/core/compliance/')
+        self.assertEqual(res.status_code, status.HTTP_200_OK)
+        data = res.json()
+        self.assertEqual(data['score'], report['score'])
+        self.assertEqual(data['total_count'], report['total_count'])
+
+    def test_admin_index_renders_compliance_dashboard(self):
+        from django.contrib.auth.models import User
+        admin_user = User.objects.create_superuser(username='admin_test', password='password123', email='admin@test.com')
+        self.client.force_login(admin_user)
+        res = self.client.get('/admin/')
+        self.assertEqual(res.status_code, 200)
+        content = res.content.decode('utf-8')
+        self.assertIn('Монітор виконання ст. 30 ЗУ «Про освіту»', content)
+        self.assertIn('Рівень відповідності', content)
+
+    def test_cli_startproject_and_school_creation(self):
+        import tempfile
+        import shutil
+        from argparse import Namespace
+        from .cli import cmd_startproject, cmd_create_school
+
+        temp_dir = tempfile.mkdtemp()
+        try:
+            # Test startproject
+            args_start = Namespace(name='test_school_cli', output_dir=temp_dir)
+            cmd_startproject(args_start)
+            project_path = Path(temp_dir) / 'test_school_cli'
+            self.assertTrue((project_path / 'manage.py').exists())
+            self.assertTrue((project_path / 'config' / 'settings.py').exists())
+
+            # Test create-school
+            args_create = Namespace(
+                name='Нова Гімназія №12',
+                short_name='Гімназія №12',
+                edrpou='99887766',
+                founder='Міська Рада',
+                city='Львів',
+                address='вул. Франка, 10',
+                phone='+380 32 200-00-00',
+                email='gymn12@lviv.ua',
+                capacity=800,
+                actual=750,
+                language='Українська',
+                primary_color='#2563eb'
+            )
+            cmd_create_school(args_create)
+            school = SchoolProfile.objects.get(edrpou='99887766')
+            self.assertEqual(school.name, 'Нова Гімназія №12')
+            self.assertEqual(school.licensed_capacity, 800)
+        finally:
+            shutil.rmtree(temp_dir, ignore_errors=True)
+
+
+

apps/core/urls.py

@@ -0,0 +1,14 @@
+from django.urls import path, include
+from rest_framework.routers import DefaultRouter
+from .views import SchoolProfileViewSet, ThemeSettingsViewSet, SchoolManifestView, ComplianceAuditView
+
+router = DefaultRouter()
+router.register(r'profile', SchoolProfileViewSet, basename='school-profile')
+router.register(r'theme', ThemeSettingsViewSet, basename='school-theme')
+
+urlpatterns = [
+    path('manifest/', SchoolManifestView.as_view(), name='school-manifest'),
+    path('capabilities/', SchoolManifestView.as_view(), name='school-capabilities'),
+    path('compliance/', ComplianceAuditView.as_view(), name='school-compliance'),
+    path('', include(router.urls)),
+]

apps/core/views.py

@@ -0,0 +1,130 @@
+from rest_framework import viewsets, permissions
+from rest_framework.views import APIView
+from rest_framework.response import Response
+from django.apps import apps
+from .models import SchoolProfile, ThemeSettings
+from .serializers import SchoolProfileSerializer, ThemeSettingsSerializer
+
+class SchoolProfileViewSet(viewsets.ReadOnlyModelViewSet):
+    queryset = SchoolProfile.objects.all().select_related('theme')
+    serializer_class = SchoolProfileSerializer
+    permission_classes = [permissions.AllowAny]
+
+
+class ThemeSettingsViewSet(viewsets.ReadOnlyModelViewSet):
+    queryset = ThemeSettings.objects.all()
+    serializer_class = ThemeSettingsSerializer
+    permission_classes = [permissions.AllowAny]
+
+
+class SchoolManifestView(APIView):
+    """
+    Системний маніфест закладу освіти для фреймворку:
+    Повертає профіль школи, динамічний перелік активних модулів та меню навігації.
+    """
+    permission_classes = [permissions.AllowAny]
+
+    def get(self, request, *args, **kwargs):
+        profile = SchoolProfile.objects.select_related('theme').first()
+        school_data = SchoolProfileSerializer(profile).data if profile else {
+            "name": "Офіційний вебсайт закладу освіти",
+            "short_name": "Заклад освіти",
+            "edrpou": "",
+            "founder": "Орган місцевого самоврядування",
+            "address": "",
+            "phone": "",
+            "email": "",
+            "website": "",
+            "licensed_capacity": 0,
+            "actual_students": 0,
+            "education_language": "Українська",
+            "logo": None,
+            "theme": {
+                "primary_color": "#1e3a8a",
+                "primary_hover": "#172554",
+                "secondary_color": "#059669",
+                "accent_color": "#d97706",
+                "font_family": "Inter, system-ui, sans-serif"
+            }
+        }
+
+        # Dynamic module detection based on INSTALLED_APPS
+        has_legal = apps.is_installed('apps.legal')
+        has_admissions = apps.is_installed('apps.admissions')
+        has_nutrition = apps.is_installed('apps.nutrition')
+        has_safety = apps.is_installed('apps.safety')
+        has_news = apps.is_installed('apps.news')
+        has_schedule = apps.is_installed('apps.schedule')
+        has_gallery = apps.is_installed('apps.gallery')
+
+        modules = {
+            'legal': has_legal,
+            'admissions': has_admissions,
+            'nutrition': has_nutrition,
+            'safety': has_safety,
+            'news': has_news,
+            'schedule': has_schedule,
+            'gallery': has_gallery,
+        }
+
+        navigation = []
+        if has_legal:
+            navigation.append({'id': 'legal', 'title': 'Прозорість (ст. 30)', 'icon': 'FileCheck'})
+            navigation.append({'id': 'finance', 'title': 'Кошторис та звітність', 'icon': 'DollarSign'})
+        if has_admissions:
+            navigation.append({'id': 'admissions', 'title': 'Вступ та зарахування', 'icon': 'Users'})
+        if has_schedule:
+            navigation.append({'id': 'schedule', 'title': 'Розклад', 'icon': 'Calendar'})
+        if has_nutrition:
+            navigation.append({'id': 'nutrition', 'title': 'Харчування', 'icon': 'Utensils'})
+        if has_safety:
+            navigation.append({'id': 'safety', 'title': 'Безпека та булінг', 'icon': 'ShieldAlert'})
+        if has_news:
+            navigation.append({'id': 'news', 'title': 'Новини', 'icon': 'Newspaper'})
+        if has_gallery:
+            navigation.append({'id': 'gallery', 'title': 'Галерея', 'icon': 'Image'})
+
+        return Response({
+            'school': school_data,
+            'modules': modules,
+            'navigation': navigation,
+            'compliance': {
+                'article_30': True,
+                'wcag_version': '2.1 AA',
+                'privacy_law_enforced': True,
+                'financial_deadline_days': 10
+            }
+        })
+
+
+from .compliance import ComplianceAuditor
+
+class ComplianceAuditView(APIView):
+    """
+    API монітора інформаційної відкритості закладу освіти:
+    Повертає деталізований звіт відповідності вимогам ст. 30 ЗУ «Про освіту»,
+    відсоток виконання та оперативні попередження щодо строків.
+    """
+    permission_classes = [permissions.AllowAny]
+
+    def get(self, request, *args, **kwargs):
+        report = ComplianceAuditor.get_audit_report()
+        return Response(report)
+
+
+from django.views.generic import TemplateView
+
+class PublicSchoolHomeView(TemplateView):
+    """
+    Публічна головна сторінка закладу освіти з підтримкою доступності WCAG 2.1 AA
+    та автоматичним відображенням статусу ст. 30 ЗУ «Про освіту».
+    """
+    template_name = 'school/home.html'
+
+    def get_context_data(self, **kwargs):
+        ctx = super().get_context_data(**kwargs)
+        ctx['school'] = SchoolProfile.objects.select_related('theme').first()
+        ctx['compliance'] = ComplianceAuditor.get_audit_report()
+        return ctx
+
+

apps/gallery/admin.py

@@ -0,0 +1,18 @@
+from django.contrib import admin
+from .models import PhotoAlbum, GalleryPhoto
+
+class GalleryPhotoInline(admin.TabularInline):
+    model = GalleryPhoto
+    extra = 3
+    fields = ('image', 'caption', 'order')
+
+@admin.register(PhotoAlbum)
+class PhotoAlbumAdmin(admin.ModelAdmin):
+    list_display = ('title', 'event_date', 'created_at')
+    search_fields = ('title', 'description')
+    inlines = [GalleryPhotoInline]
+
+@admin.register(GalleryPhoto)
+class GalleryPhotoAdmin(admin.ModelAdmin):
+    list_display = ('album', 'caption', 'order')
+    list_filter = ('album',)

apps/gallery/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+class GalleryConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'apps.gallery'
+    verbose_name = 'Фото- та відеогалерея'

apps/gallery/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='PhotoAlbum',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(max_length=200, verbose_name='Назва альбому / події')),
+                ('description', models.TextField(blank=True, verbose_name='Опис події')),
+                ('cover_image', models.ImageField(blank=True, null=True, upload_to='gallery/covers/%Y/', verbose_name='Обкладинка альбому')),
+                ('event_date', models.DateField(verbose_name='Дата заходу')),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+            ],
+            options={
+                'verbose_name': 'Фотоальбом',
+                'verbose_name_plural': 'Фотоальбоми',
+                'ordering': ['-event_date'],
+            },
+        ),
+        migrations.CreateModel(
+            name='GalleryPhoto',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('image', models.ImageField(upload_to='gallery/photos/%Y/%m/', verbose_name='Фотографія')),
+                ('caption', models.CharField(blank=True, max_length=255, verbose_name='Підпис до фото')),
+                ('order', models.PositiveIntegerField(default=0, verbose_name='Порядок відображення')),
+                ('album', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='photos', to='gallery.photoalbum', verbose_name='Альбом')),
+            ],
+            options={
+                'verbose_name': 'Фотографія галереї',
+                'verbose_name_plural': 'Фотографії галереї',
+                'ordering': ['order', 'id'],
+            },
+        ),
+    ]

apps/gallery/models.py

@@ -0,0 +1,48 @@
+from django.db import models
+from django.utils.translation import gettext_lazy as _
+
+class AbstractPhotoAlbum(models.Model):
+    title = models.CharField(max_length=200, verbose_name=_('Назва альбому / події'))
+    description = models.TextField(blank=True, verbose_name=_('Опис події'))
+    cover_image = models.ImageField(upload_to='gallery/covers/%Y/', blank=True, null=True, verbose_name=_('Обкладинка альбому'))
+    event_date = models.DateField(verbose_name=_('Дата заходу'))
+    created_at = models.DateTimeField(auto_now_add=True)
+
+    class Meta:
+        abstract = True
+        verbose_name = _('Фотоальбом')
+        verbose_name_plural = _('Фотоальбоми')
+        ordering = ['-event_date']
+
+    def __str__(self):
+        return f"{self.title} ({self.event_date})"
+
+
+class PhotoAlbum(AbstractPhotoAlbum):
+    class Meta(AbstractPhotoAlbum.Meta):
+        abstract = False
+
+
+class AbstractGalleryPhoto(models.Model):
+    image = models.ImageField(upload_to='gallery/photos/%Y/%m/', verbose_name=_('Фотографія'))
+    caption = models.CharField(max_length=255, blank=True, verbose_name=_('Підпис до фото'))
+    order = models.PositiveIntegerField(default=0, verbose_name=_('Порядок відображення'))
+
+    class Meta:
+        abstract = True
+        verbose_name = _('Фотографія галереї')
+        verbose_name_plural = _('Фотографії галереї')
+        ordering = ['order', 'id']
+
+    def __str__(self):
+        return f"Фотографія #{self.id}"
+
+
+class GalleryPhoto(AbstractGalleryPhoto):
+    album = models.ForeignKey(PhotoAlbum, on_delete=models.CASCADE, related_name='photos', verbose_name=_('Альбом'))
+
+    class Meta(AbstractGalleryPhoto.Meta):
+        abstract = False
+
+    def __str__(self):
+        return f"Фото в альбомі {self.album.title}"

apps/gallery/serializers.py

@@ -0,0 +1,14 @@
+from rest_framework import serializers
+from .models import PhotoAlbum, GalleryPhoto
+
+class GalleryPhotoSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = GalleryPhoto
+        fields = ['id', 'image', 'caption', 'order']
+
+class PhotoAlbumSerializer(serializers.ModelSerializer):
+    photos = GalleryPhotoSerializer(many=True, read_only=True)
+
+    class Meta:
+        model = PhotoAlbum
+        fields = ['id', 'title', 'description', 'cover_image', 'event_date', 'photos']

apps/gallery/tests.py

@@ -0,0 +1,31 @@
+from datetime import date
+from django.test import TestCase
+from rest_framework.test import APIClient
+from rest_framework import status
+from .models import PhotoAlbum, GalleryPhoto
+
+class GalleryTests(TestCase):
+    def setUp(self):
+        self.client = APIClient()
+        self.album = PhotoAlbum.objects.create(
+            title='Свято першого дзвоника',
+            description='Урочиста лінійка 1 вересня',
+            event_date=date(2026, 9, 1)
+        )
+        self.photo = GalleryPhoto.objects.create(
+            album=self.album,
+            caption='Першокласники з квітами',
+            order=1
+        )
+
+    def test_str_representations(self):
+        self.assertEqual(str(self.album), 'Свято першого дзвоника (2026-09-01)')
+        self.assertEqual(str(self.photo), 'Фото в альбомі Свято першого дзвоника')
+
+    def test_albums_api_list(self):
+        res = self.client.get('/api/v1/gallery/albums/')
+        self.assertEqual(res.status_code, status.HTTP_200_OK)
+        data = res.json()
+        results = data.get('results', data)
+        self.assertTrue(len(results) > 0)
+        self.assertEqual(results[0]['title'], 'Свято першого дзвоника')

apps/gallery/urls.py

@@ -0,0 +1,11 @@
+from django.urls import path, include
+from rest_framework.routers import DefaultRouter
+from .views import PhotoAlbumViewSet, GalleryPhotoViewSet
+
+router = DefaultRouter()
+router.register(r'albums', PhotoAlbumViewSet, basename='gallery-albums')
+router.register(r'photos', GalleryPhotoViewSet, basename='gallery-photos')
+
+urlpatterns = [
+    path('', include(router.urls)),
+]

apps/gallery/views.py

@@ -0,0 +1,15 @@
+from rest_framework import viewsets, permissions, filters
+from .models import PhotoAlbum, GalleryPhoto
+from .serializers import PhotoAlbumSerializer, GalleryPhotoSerializer
+
+class PhotoAlbumViewSet(viewsets.ReadOnlyModelViewSet):
+    queryset = PhotoAlbum.objects.all().prefetch_related('photos')
+    serializer_class = PhotoAlbumSerializer
+    permission_classes = [permissions.AllowAny]
+    filter_backends = [filters.SearchFilter]
+    search_fields = ['title', 'description']
+
+class GalleryPhotoViewSet(viewsets.ReadOnlyModelViewSet):
+    queryset = GalleryPhoto.objects.all()
+    serializer_class = GalleryPhotoSerializer
+    permission_classes = [permissions.AllowAny]