school-library-api 0.1.0__tar.gz

school_library_api-0.1.0/PKG-INFO

@@ -0,0 +1,17 @@
+Metadata-Version: 2.4
+Name: school-library-api
+Version: 0.1.0
+Summary: REST API школьной библиотеки учебников (Django + DRF)
+Project-URL: Homepage, https://github.com/yourname/school-library-api
+Author-email: Your Name <you@example.com>
+License: MIT
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 5.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.11
+Requires-Dist: django-filter>=24.0
+Requires-Dist: django>=5.0
+Requires-Dist: djangorestframework>=3.15
+Requires-Dist: psycopg[binary]>=3.1

school_library_api-0.1.0/backend/Dockerfile

@@ -0,0 +1,22 @@
+# syntax=docker/dockerfile:1
+FROM python:3.11-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PYTHONUNBUFFERED=1
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y \
+    build-essential \
+    libpq-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY requirements.txt /app/
+RUN pip install --upgrade pip && pip install -r requirements.txt
+
+COPY ./backend /app/backend
+WORKDIR /app/backend
+
+ENV DJANGO_SETTINGS_MODULE=core.settings
+
+CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

school_library_api-0.1.0/backend/core/asgi.py

@@ -0,0 +1,16 @@
+"""
+ASGI config for core project.
+
+It exposes the ASGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/6.0/howto/deployment/asgi/
+"""
+
+import os
+
+from django.core.asgi import get_asgi_application
+
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'core.settings')
+
+application = get_asgi_application()

school_library_api-0.1.0/backend/core/settings.py

@@ -0,0 +1,143 @@
+"""
+Django settings for core project.
+
+Generated by 'django-admin startproject' using Django 6.0.6.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/6.0/topics/settings/
+
+For the full list of settings and their values, see
+https://docs.djangoproject.com/en/6.0/ref/settings/
+"""
+
+from pathlib import Path
+import os
+import dotenv
+
+dotenv.load_dotenv()
+
+# Build paths inside the project like this: BASE_DIR / 'subdir'.
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+
+# Quick-start development settings - unsuitable for production
+# See https://docs.djangoproject.com/en/6.0/howto/deployment/checklist/
+
+# SECURITY WARNING: keep the secret key used in production secret!
+SECRET_KEY = 'django-insecure-=ac++6&wy5gthazc(e(!^5ss3=wuwjb@hn**uj&&y(8$&4gns1'
+
+# SECURITY WARNING: don't run with debug turned on in production!
+DEBUG = True
+
+ALLOWED_HOSTS = []
+
+
+# Application definition
+
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'rest_framework',
+    'rest_framework.authtoken',
+    'school_library.users',
+    'school_library.libraly'
+]
+
+AUTH_USER_MODEL = 'users.User'
+
+REST_FRAMEWORK = {
+    "DEFAULT_AUTHENTICATION_CLASSES":[
+        'users.authentication.BearerToken'
+    ],
+    "DEFAULT_PERMISSION_CLASSES": [
+        "rest_framework.permissions.IsAuthenticatedOrReadOnly",
+    ],
+    "DEFAULT_FILTER_BACKENDS": [
+        "django_filters.rest_framework.DjangoFilterBackend",
+    ],
+}
+
+MIDDLEWARE = [
+    'django.middleware.security.SecurityMiddleware',
+    'django.contrib.sessions.middleware.SessionMiddleware',
+    'django.middleware.common.CommonMiddleware',
+    'django.middleware.csrf.CsrfViewMiddleware',
+    'django.contrib.auth.middleware.AuthenticationMiddleware',
+    'django.contrib.messages.middleware.MessageMiddleware',
+    'django.middleware.clickjacking.XFrameOptionsMiddleware',
+]
+
+ROOT_URLCONF = 'core.urls'
+
+TEMPLATES = [
+    {
+        'BACKEND': 'django.template.backends.django.DjangoTemplates',
+        'DIRS': [],
+        'APP_DIRS': True,
+        'OPTIONS': {
+            'context_processors': [
+                'django.template.context_processors.request',
+                'django.contrib.auth.context_processors.auth',
+                'django.contrib.messages.context_processors.messages',
+            ],
+        },
+    },
+]
+
+WSGI_APPLICATION = 'core.wsgi.application'
+
+
+# Database
+# https://docs.djangoproject.com/en/6.0/ref/settings/#databases
+
+DATABASES = {
+    "default": {
+        "ENGINE": "django.db.backends.postgresql",
+        "NAME": os.environ.get("POSTGRES_DB", "school_library"),
+        "USER": os.environ.get("POSTGRES_USER", "library_user"),
+        "PASSWORD": os.environ.get("POSTGRES_PASSWORD", "library_password"),
+        "HOST": os.environ.get("POSTGRES_HOST", "db"),
+        "PORT": os.environ.get("POSTGRES_PORT", "5432"),
+    }
+}
+
+
+# Password validation
+# https://docs.djangoproject.com/en/6.0/ref/settings/#auth-password-validators
+
+AUTH_PASSWORD_VALIDATORS = [
+    {
+        'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
+    },
+]
+
+
+# Internationalization
+# https://docs.djangoproject.com/en/6.0/topics/i18n/
+
+LANGUAGE_CODE = 'en-us'
+
+TIME_ZONE = 'UTC'
+
+USE_I18N = True
+
+USE_TZ = True
+
+
+# Static files (CSS, JavaScript, Images)
+# https://docs.djangoproject.com/en/6.0/howto/static-files/
+
+STATIC_URL = 'static/'

school_library_api-0.1.0/backend/core/urls.py

@@ -0,0 +1,23 @@
+"""
+URL configuration for core project.
+
+The `urlpatterns` list routes URLs to views. For more information please see:
+    https://docs.djangoproject.com/en/6.0/topics/http/urls/
+Examples:
+Function views
+    1. Add an import:  from my_app import views
+    2. Add a URL to urlpatterns:  path('', views.home, name='home')
+Class-based views
+    1. Add an import:  from other_app.views import Home
+    2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
+Including another URLconf
+    1. Import the include() function: from django.urls import include, path
+    2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
+"""
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('api/', include('libraly.urls'))
+]

school_library_api-0.1.0/backend/core/wsgi.py

@@ -0,0 +1,16 @@
+"""
+WSGI config for core project.
+
+It exposes the WSGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/6.0/howto/deployment/wsgi/
+"""
+
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'core.settings')
+
+application = get_wsgi_application()

school_library_api-0.1.0/backend/docker-compose.yml

@@ -0,0 +1,33 @@
+version: "3.9"
+
+services:
+  web:
+    build: .
+    container_name: library_web
+    command: python manage.py runserver 0.0.0.0:8000
+    volumes:
+      - ./backend:/app/backend
+    env_file:
+      - .env
+    depends_on:
+      - db
+    ports:
+      - "8000:8000"
+
+  db:
+    image: postgres:14
+    container_name: library_db
+    restart: always
+    env_file:
+      - .env
+    environment:
+      POSTGRES_DB: ${POSTGRES_DB}
+      POSTGRES_USER: ${POSTGRES_USER}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    ports:
+      - "5432:5432"
+
+volumes:
+  postgres_data:

school_library_api-0.1.0/backend/libraly/admin.py

@@ -0,0 +1,46 @@
+from django.contrib import admin
+from .models import Subject, Textbook, Borrow
+
+
+class BorrowInline(admin.TabularInline):
+    model = Borrow
+    extra = 0
+
+
+@admin.register(Subject)
+class SubjectAdmin(admin.ModelAdmin):
+    list_display = ("id", "name", "created_at")
+    search_fields = ("name",)
+    list_filter = ("created_at",)
+
+
+@admin.register(Textbook)
+class TextbookAdmin(admin.ModelAdmin):
+    list_display = ("id", "title", "subject", "shelf_code", "is_available_admin")
+    list_filter = ("subject",)
+    search_fields = ("title", "shelf_code")
+    inlines = [BorrowInline]
+    list_select_related = ("subject",)
+
+    @admin.display(boolean=True, description="Доступен")
+    def is_available_admin(self, obj):
+        return not obj.borrows.filter(status=Borrow.STATUS_ACTIVE).exists()
+
+
+@admin.action(description="Отметить как возвращённые")
+def mark_returned(modeladmin, request, queryset):
+    from django.utils import timezone
+
+    queryset.filter(status=Borrow.STATUS_ACTIVE).update(
+        status=Borrow.STATUS_RETURNED, returned_at=timezone.now()
+    )
+
+
+@admin.register(Borrow)
+class BorrowAdmin(admin.ModelAdmin):
+    list_display = ("id", "student", "textbook", "status", "due_date", "borrowed_at")
+    list_filter = ("status", "due_date", "student")
+    search_fields = ("student__email", "textbook__title", "textbook__shelf_code")
+    actions = [mark_returned]
+    date_hierarchy = "borrowed_at"
+    list_select_related = ("student", "textbook", "textbook__subject")

school_library_api-0.1.0/backend/libraly/apps.py

@@ -0,0 +1,5 @@
+from django.apps import AppConfig
+
+
+class LibralyConfig(AppConfig):
+    name = 'libraly'

school_library_api-0.1.0/backend/libraly/migrations/0001_initial.py

@@ -0,0 +1,43 @@
+# Generated by Django 6.0.6 on 2026-06-15 01:06
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Borrow',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('borrowed_at', models.DateTimeField(auto_now_add=True)),
+                ('due_date', models.DateField()),
+                ('returned_at', models.DateTimeField(blank=True, null=True)),
+                ('status', models.PositiveSmallIntegerField(choices=[(0, 'active'), (1, 'returned'), (2, 'overdue')], default=0)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Subject',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=255, unique=True)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Textbook',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(db_index=True, max_length=255)),
+                ('author', models.CharField(max_length=255)),
+                ('shelf_code', models.CharField(max_length=64)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+            ],
+        ),
+    ]

school_library_api-0.1.0/backend/libraly/migrations/0002_initial.py

@@ -0,0 +1,41 @@
+# Generated by Django 6.0.6 on 2026-06-15 01:06
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('libraly', '0001_initial'),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='borrow',
+            name='student',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='borrows', to=settings.AUTH_USER_MODEL),
+        ),
+        migrations.AddField(
+            model_name='textbook',
+            name='subject',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='textbooks', to='libraly.subject'),
+        ),
+        migrations.AddField(
+            model_name='borrow',
+            name='textbook',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='borrows', to='libraly.textbook'),
+        ),
+        migrations.AddIndex(
+            model_name='textbook',
+            index=models.Index(fields=['subject', 'title'], name='libraly_tex_subject_eefda8_idx'),
+        ),
+        migrations.AlterUniqueTogether(
+            name='textbook',
+            unique_together={('subject', 'shelf_code')},
+        ),
+    ]

school_library_api-0.1.0/backend/libraly/models.py

@@ -0,0 +1,61 @@
+from django.db import models
+from django.conf import settings
+from django.db.models import Q
+from rest_framework.authentication import get_user_model
+
+User = get_user_model()
+
+
+class Subject(models.Model):
+    name = models.CharField(max_length=255, unique=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+
+    def __str__(self):
+        return self.name
+
+
+class Textbook(models.Model):
+    subject = models.ForeignKey(Subject, on_delete=models.CASCADE, related_name="textbooks")
+    title = models.CharField(max_length=255, db_index=True)
+    author = models.CharField(max_length=255)
+    shelf_code = models.CharField(max_length=64)
+    created_at = models.DateTimeField(auto_now_add=True)
+
+    class Meta:
+        unique_together = ("subject", "shelf_code")
+        indexes = [
+            models.Index(fields=["subject", "title"]),
+        ]
+
+    def __str__(self):
+        return f"{self.title} ({self.shelf_code})"
+
+
+class Borrow(models.Model):
+    STATUS_ACTIVE = 0
+    STATUS_RETURNED = 1
+    STATUS_OVERDUE = 2
+    STATUS_CHOICES = (
+        (STATUS_ACTIVE, "active"),
+        (STATUS_RETURNED, "returned"),
+        (STATUS_OVERDUE, "overdue"),
+    )
+
+    student = models.ForeignKey(
+        User,
+        on_delete=models.CASCADE,
+        related_name="borrows",
+    )
+    textbook = models.ForeignKey(
+        Textbook,
+        on_delete=models.CASCADE,
+        related_name="borrows",
+    )
+    borrowed_at = models.DateTimeField(auto_now_add=True)
+    due_date = models.DateField()
+    returned_at = models.DateTimeField(null=True, blank=True)
+    status = models.PositiveSmallIntegerField(choices=STATUS_CHOICES, default=STATUS_ACTIVE)
+    created_at = models.DateTimeField(auto_now_add=True)
+
+    def __str__(self):
+        return f"{self.student} -> {self.textbook}"

school_library_api-0.1.0/backend/libraly/permissions.py

@@ -0,0 +1,31 @@
+from rest_framework.permissions import BasePermission, SAFE_METHODS
+from django.contrib.auth import get_user_model
+
+User = get_user_model()
+
+
+class IsAdmin(BasePermission):
+    def has_permission(self, request, view):
+        return (
+            request.user
+            and request.user.is_authenticated
+            and request.user.role == User.ROLE_ADMIN
+        )
+
+
+class IsLibrarian(BasePermission):
+    def has_permission(self, request, view):
+        return (
+            request.user
+            and request.user.is_authenticated
+            and request.user.role in (User.ROLE_LIBRARIAN, User.ROLE_ADMIN)
+        )
+
+
+class IsStudent(BasePermission):
+    def has_permission(self, request, view):
+        return (
+            request.user
+            and request.user.is_authenticated
+            and request.user.role == User.ROLE_STUDENT
+        )

school_library_api-0.1.0/backend/libraly/serializers.py

@@ -0,0 +1,53 @@
+from rest_framework import serializers
+from django.contrib.auth import get_user_model
+
+from .models import Subject, Textbook, Borrow
+
+User = get_user_model()
+
+
+class SubjectSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = Subject
+        fields = [
+            "id",
+            "name",
+            "created_at"
+        ]
+
+
+class TextbookSerializer(serializers.ModelSerializer):
+    subject_name = serializers.CharField(source="subject.name", read_only=True)
+    is_available = serializers.SerializerMethodField()
+
+    class Meta:
+        model = Textbook
+        fields = [
+            "id",
+            "subject",
+            "subject_name",
+            "title",
+            "author",
+            "shelf_code",
+            "is_available",
+            "created_at",
+        ]
+
+    def get_is_available(self, obj):
+        return not obj.borrows.filter(status=Borrow.STATUS_ACTIVE).exists()
+
+
+class BorrowSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = Borrow
+        fields = [
+            "id",
+            "student",
+            "textbook",
+            "borrowed_at",
+            "due_date",
+            "returned_at",
+            "status",
+            "created_at",
+        ]
+        read_only_fields = ["borrowed_at", "returned_at", "status", "created_at"]

school_library_api-0.1.0/backend/libraly/tests/conftest.py

@@ -0,0 +1,59 @@
+import pytest
+from django.contrib.auth import get_user_model
+from rest_framework.test import APIClient
+from libraly.models import Subject, Textbook, Borrow
+
+User = get_user_model()
+
+
+@pytest.fixture
+def api_client():
+    return APIClient()
+
+
+@pytest.fixture
+def admin_user(db):
+    user = User.objects.create_user(
+        email="admin@test.ru",
+        password="admin123",
+        role=User.ROLE_ADMIN,
+        is_staff=True,
+        is_superuser=True,
+    )
+    return user
+
+
+@pytest.fixture
+def librarian_user(db):
+    user = User.objects.create_user(
+        email="librarian@test.ru",
+        password="lib123",
+        role=User.ROLE_LIBRARIAN,
+        is_staff=True,
+    )
+    return user
+
+
+@pytest.fixture
+def student_user(db):
+    user = User.objects.create_user(
+        email="student@test.ru",
+        password="student123",
+        role=User.ROLE_STUDENT,
+    )
+    return user
+
+
+@pytest.fixture
+def subject(db):
+    return Subject.objects.create(name="Математика")
+
+
+@pytest.fixture
+def textbook(db, subject):
+    return Textbook.objects.create(
+        subject=subject,
+        title="Алгебра 8 класс",
+        author="Мордкович",
+        shelf_code="MAT-001",
+    )

school_library_api-0.1.0/backend/libraly/tests/test_models.py

@@ -0,0 +1,46 @@
+import pytest
+from django.db import IntegrityError
+from django.contrib.auth import get_user_model
+from libraly.models import Subject, Textbook, Borrow
+
+User = get_user_model()
+
+
+@pytest.mark.django_db
+def test_textbook_unique_together(subject):
+    Textbook.objects.create(
+        subject=subject,
+        title="Алгебра 8 класс",
+        author="Мордкович",
+        shelf_code="MAT-001",
+    )
+    with pytest.raises(IntegrityError):
+        Textbook.objects.create(
+            subject=subject,
+            title="Алгебра 8 класс",
+            author="Мордкович",
+            shelf_code="MAT-001",
+        )
+
+
+@pytest.mark.django_db
+def test_borrow_unique_constraints_active(textbook):
+    student = User.objects.create_user(
+        email="stud1@test.ru", password="pass", role=User.ROLE_STUDENT
+    )
+
+    Borrow.objects.create(
+        student=student,
+        textbook=textbook,
+        due_date="2026-06-30",
+        status=Borrow.STATUS_ACTIVE,
+    )
+
+    # Вторая активная для того же student+textbook -> IntegrityError
+    with pytest.raises(IntegrityError):
+        Borrow.objects.create(
+            student=student,
+            textbook=textbook,
+            due_date="2026-06-30",
+            status=Borrow.STATUS_ACTIVE,
+        )

school_library_api-0.1.0/backend/libraly/tests.py

@@ -0,0 +1,3 @@
+from django.test import TestCase
+
+# Create your tests here.