2026-11-16 17:30:51 +03:00
2026-11-16 17:30:51 +03:00
2026-11-16 17:30:51 +03:00
2026-11-16 17:30:51 +03:00
2026-11-13 19:15:25 +03:00
2026-11-16 17:30:51 +03:00
2026-11-13 19:15:25 +03:00
2026-11-16 17:26:19 +03:00
2026-11-16 17:26:19 +03:00
2026-11-13 19:15:27 +03:00
2026-11-13 19:15:25 +03:00
2026-11-13 19:15:25 +03:00
2026-11-16 17:30:51 +03:00
2026-11-16 17:30:51 +03:00
2026-11-16 17:30:51 +03:00
2026-11-13 19:15:25 +03:00
2026-11-13 19:15:25 +03:00
2026-11-13 19:15:25 +03:00
2026-11-16 17:30:51 +03:00

Тестовое задание

Бизнес требования

Требуемые сущности:

erDiagram
    Profile ||--o{ Skill : Навыки
    Profile ||--o{ Link : Ссылки
    Profile ||--o{ Experience : "Опыт работы"
    Profile ||--o{ Project : "Проекты"
    
    Profile {
        string firstName "имя"
        string lastName "фамилия"
        string description "краткое описание" 
    }
    
    Link {
        string name "название"
        string link "адрес ссылки"
    }
    
    Skill {
        string name "название навыка" 
    }
    
    Project {
        string name "название проекта"
        string link "адрес проекта или его репозитория"
        string description "описание"
    }
    
    Experience {
        string company "компания"
        string position "должность"
        string period "период работы"
        string[] achievements "достижения" 
    }  

Требования:

  • Автоподготовка базы данных
  • Автозаполнение данных при старте
  • Доступ по GraphQL

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

Неявные требования

Особых неявных требований нет

Решения

База данных

Конечно, в данном ТЗ данных столько, что достаточно было бы одного JSON файла, но возьмем БД postgres

Postgres - популярная, широкий функционал. Уже есть инфраструктура для нее.

Другие варианты:

  • MariaDB - достаточно широкий функционал. Нет под нее инфраструктуры.
  • SQLite - небольшая, встраиваемая. Инфраструктуры не требуется
  • MongoDB - документная, что тоже подходит. Нет под нее инфраструктуры.

Подготовка БД

Под подготовкой БД я понял создание базы данных и накатывание на нее миграций.

Создание БД:

  • локально: вручную созданная БД
  • на "проде" использую уже имеющуюся у меня инфраструктуру: БД будет создаваться скриптом на сервере

Миграции:

Так как миграция работает с бизнес-данными (а данные терять и повреждать нельзя), то накатывание миграций должно быть достаточно явным процессом, и сама миграция должна быть однозначной.

Потому просто дать команду "приведи БД в соответствие со схемой" в orm библиотеке небезопасно, требуется именно миграция.

Подходящим считаю накатывать миграцию перед публикацией новой версии приложения прямо в CI.

Автозаполнение данных на старте

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

В реальном приложении это надо обсудить, а здесь достаточно такого решения.

Остальное

  • Выделенного фронта нет, есть Apollo Playground, который доступен из библиотек.

Архитектура

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

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

Горизонтальное разделение ответственности

Потребности в разделении на несколько модулей нет: один модуль, один ресолвер, нужные сущности.

Вот кейс по проектированию биллинга, где разделение ответственности дает преимущества.

Вертикальное разделение ответственности

Обычно модуль я делю на такие слои:

  • Resolver: Точки входа, права доступа. Без бизнес логики
  • Service: Бизнес логика
  • Data Access Layer: Проектно специфичные методы для доступа к данным. Бизнес логика присутствует, только если она нужна на уровне БД
  • Repository: API библиотеки БД

В данном случае Data Access Layer будет явно излишним.

Так же эти слои показывают направление связей:

  • Resolver имеет доступ только к Service
  • Service имеет доступ только к Repository

Сущности

Идентификаторы сущностям на уровне API не нужны, поэтому в GraphQL они не отдаются. Внутри БД они есть: Prisma требует у модели уникальный идентификатор, и id (autoincrement) заодно даёт стабильные связи profileId и порядок выдачи. Наружу это не протекает — DTO описывает только бизнес-поля.

Профиль ровно один, но запись профиля оставлю: так вложенность (профиль → навыки/ссылки/опыт/проекты) выражена отношением в БД, а не соглашением «все строки таблицы принадлежат профилю».

GraphQL

Разделил на отдельные ресолверы для разделения ответственности

S
Description
No description provided
Readme
1.2 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 95.9%
Nix 2.1%
Dockerfile 2%