Python Django Rest - Возврат дополнительного поля с наименьшим, наибольшим и средним значениями некоторого другого поля

Я новичок в Django и API в целом, и я хочу создать API на базе Django, используя Django Rest Framework.

Вот что я хочу сделать:

Конечная точка отчета о возрастном диапазоне:

curl -H 'Content-Type: application/json' localhost:8000/reports/employees/age/

Ответ: 

{
    "younger": {
        "id": "1",
        "name": "Anakin Skywalker",
        "email": "skywalker@ssys.com.br",
        "department": "Architecture",
        "salary": "4000.00",
        "birth_date": "01-01-1983"},
    "older": {
        "id": "2",
        "name": "Obi-Wan Kenobi",
        "email": "kenobi@ssys.com.br",
        "department": "Back-End",
        "salary": "3000.00",
        "birth_date": "01-01-1977"},
    "average": "40.00"
}

Конечная точка для отчета о диапазоне зарплат:

curl -H 'Content-Type: application/json' localhost:8000/reports/employees/salary/

Ответ: 

{
    "lowest ": {
        "id": "2",
        "name": "Obi-Wan Kenobi",
        "email": "kenobi@ssys.com.br",
        "department": "Back-End",
        "salary": "3000.00",
        "birth_date": "01-01-1977"},
    "highest": {
        "id": "3",
        "name": "Leia Organa",
        "email": "organa@ssys.com.br",
        "department": "DevOps",
        "salary": "5000.00",
        "birth_date": "01-01-1980"},
    "average": "4000.00"
}

У меня есть два приложения, employees и reports.

Вот Employees/models.py:

class Employee(models.Model):
    name = models.CharField(max_length=250, default='FirstName LastName')
    email = models.EmailField(max_length=250, default='employee@email.com')
    departament = models.CharField(max_length=250, default='Full-Stack')
    salary = models.DecimalField(max_digits=15, decimal_places=2, default=0)
    birth_date = models.DateField()
< 
class EmployeeSerializer(serializers.ModelSerializer):
    class Meta:
        model = Employee
        fields = ['id', 'name', 'email', 'departament', 'salary', 'birth_date']
< < < 
Employee.objects.aggregate(Max("salary"), Min("salary"), Avg("salary"))

Но как мне его использовать?

Я не знаю, где использовать или как это сделать, поскольку мое понимание API и Django Rest Framework все еще очень слабое.

Должен ли он находиться в моем reports/view.py? Или в моем employees/serializers.py?

Нужно ли мне создавать файл reports/serializers.py?

Нужно ли переопределить функцию list() класса ReportSalaryListAPIView в моем reports/views.py? (Этот класс еще не существует)

Я очень запуталась и потерялась. Пожалуйста, помогите направить меня в правильном направлении.

Заранее спасибо.

Идея

Для хранения вычисляемых значений не нужны дополнительные поля, поскольку они вычисляются на основе строк в базе данных.

  1. Сначала вы находите min_salary, max_salary и avg_salary с помощью метода агрегации.
  2. Используйте найденные min_salary и max_salary для поиска сотрудников.
  3. Реализуйте класс сериализатора, который сериализует highest, lowest и average отчет о зарплате сотрудника.
  4. Сериализуйте lowest, highest и avarage с помощью реализованного класса сериализатора.

Code

На мой взгляд, код для выполнения логики должен находиться на другом уровне, обычно называемом сервисным уровнем.

# employees/services.py
class EmployeeSalaryReport:
    def __init__(self, lowest, highest, average):
        self.lowest = lowest
        self.highest = highest
        self.average = average

def get_employee_salary_report():
    salary_report_dict = Employee.objects.aggregate(
        min_salary=Min("salary"),
        max_salary=Max("salary"),
        avg_salary=Avg("salary"),
    )
    lowest_salary_employee = Employee.objects.filter(
        salary=salary_report_dict.get("min_salary")
    ).first()
    highest_salary_employee = Employee.objects.filter(
        salary=salary_report_dict.get("max_salary")
    ).first()
    return EmployeeSalaryReport(
        lowest=lowest_salary_employee,
        highest=highest_salary_employee,
        average=salary_report_dict.get("avg_salary"),
    )

# employees/serializers.py
class EmployeeSalaryReportSerializer(serializers.Serializer):
    lowest = EmployeeSerializer()
    highest = EmployeeSerializer()
    average = serializers.FloatField()

# employees/views.py
from rest_framework import views
from rest_framework.response import Response

from employees.services import get_employee_salary_report
from employees.serializers import EmployeeSalaryReportSerializer


class ReportSalaryView(views.APIView):
    def get(self, request, *args, **kwargs):
        employee_salary_report = get_employee_salary_report()
        serializer = EmployeeSalaryReportSerializer(employee_salary_report)
        return Response(serializer.data)

# employees/urls.py
from django.urls import path

from employees.views import ReportSalaryView


urlpatterns = [
    ...  # other paths
    path("reports/employees/salary/", ReportSalaryView.as_view(), name="report-salary"),
]
Вернуться на верх