Compare commits

..
7 Commits
Author SHA1 Message Date
arswarog 66337ae989 deploy: staging single-container via host caddy-docker-proxy
CI / Сборка (push) Failing after 5s
CI / Деплой на стейджинг (push) Skipped
CI / Проверка кода (push) Skipped
- drop caddy/SSL in container (staging only): api service gets caddy labels,
  host caddy terminates TLS and routes ${BRANCH}.it-smi.jt4d.ru.net -> :5000
- simplify Dockerfile to single-stage, healthcheck -> /, .dockerignore
- pin packageManager yarn@4.18.0 and use corepack: project is Yarn 4 (berry
  lockfile), base image and CI runner ship Yarn 1 and failed on install
- rewrite ci.yaml/cleanup.yaml for flat project (single api image, no Nx)
2026-11-13 19:54:00 +03:00
arswarog 8da8c241e9 profile: guery profile (minimal) 2026-11-13 19:18:36 +03:00
arswarog 6cd287cf78 profile: create module structure 2026-11-13 19:18:17 +03:00
arswarog 2e8eaa0478 graphql: add graphql 2026-11-13 19:17:56 +03:00
arswarog a1e0fdcb92 db: prisma init 2026-11-13 19:17:16 +03:00
arswarog 0403d1b489 all: install prisma 2026-11-13 19:17:16 +03:00
arswarog 0b7c76b290 chore: prettier 2026-11-13 19:16:45 +03:00
11 changed files with 1669 additions and 1353 deletions

No files matched your search

+1
View File
@@ -10,6 +10,7 @@ node_modules
.gitea .gitea
test test
src src
prisma
docs docs
.env .env
.env.* .env.*
+2 -16
View File
@@ -27,9 +27,7 @@ jobs:
password: ${{ secrets.REGISTRY_PASSWORD }} password: ${{ secrets.REGISTRY_PASSWORD }}
- name: Setup Yarn 4 - name: Setup Yarn 4
env: run: npm install -g corepack && corepack enable
COREPACK_ENABLE_DOWNLOAD_PROMPT: 0
run: npm install -g corepack --force && corepack enable
- name: Install dependencies - name: Install dependencies
run: yarn install --immutable run: yarn install --immutable
@@ -48,15 +46,6 @@ jobs:
labels: | labels: |
org.opencontainers.image.ref.name=${{ github.head_ref || github.ref_name }} org.opencontainers.image.ref.name=${{ github.head_ref || github.ref_name }}
- name: Build migrate docker image
uses: docker/build-push-action@v7
with:
context: .
file: Dockerfile.migrate
push: true
tags: git.jt4d.ru/${{ github.repository }}/api:${{ github.head_ref || github.ref_name }}-migrate
cache-from: git.jt4d.ru/${{ github.repository }}/api:latest
deploy-staging: deploy-staging:
name: Деплой на стейджинг name: Деплой на стейджинг
runs-on: ubuntu-latest runs-on: ubuntu-latest
@@ -87,7 +76,6 @@ jobs:
sed -i "s/\${BRANCH}/$BRANCH/g" docker-compose.yml sed -i "s/\${BRANCH}/$BRANCH/g" docker-compose.yml
docker compose pull --quiet docker compose pull --quiet
staging-db-postgres create "${{ github.repository }}" "$BRANCH" staging-db-postgres create "${{ github.repository }}" "$BRANCH"
docker compose run --rm migrate
docker compose down docker compose down
docker compose up -d docker compose up -d
@@ -120,9 +108,7 @@ jobs:
uses: actions/checkout@v4 uses: actions/checkout@v4
- name: Setup Yarn 4 - name: Setup Yarn 4
env: run: npm install -g corepack && corepack enable
COREPACK_ENABLE_DOWNLOAD_PROMPT: 0
run: npm install -g corepack --force && corepack enable
- name: Install dependencies - name: Install dependencies
run: yarn install --immutable run: yarn install --immutable
-19
View File
@@ -1,19 +0,0 @@
FROM git.jt4d.ru/jt4d/node:24-alpine
ENV COREPACK_ENABLE_DOWNLOAD_PROMPT=0
WORKDIR /app
RUN corepack enable
COPY package.json yarn.lock .yarnrc.yml ./
RUN yarn install --immutable && yarn cache clean
COPY prisma.config.ts ./
COPY ./prisma ./prisma
# Прогреваем кэш схемного движка Prisma при сборке: иначе `migrate deploy`
# качает его с binaries.prisma.sh уже на стенде, в момент деплоя.
RUN yarn prisma version
CMD ["yarn", "prisma", "migrate", "deploy"]
+112 -200
View File
@@ -1,214 +1,126 @@
# Тестовое задание <p align="center">
<a href="http://nestjs.com/" target="blank"><img src="https://nestjs.com/img/logo-small.svg" width="120" alt="Nest Logo" /></a>
</p>
## Бизнес требования [circleci-image]: https://img.shields.io/circleci/build/github/nestjs/nest/master?token=abc123def456
[circleci-url]: https://circleci.com/gh/nestjs/nest
Требуемые сущности: <p align="center">A progressive <a href="http://nodejs.org" target="_blank">Node.js</a> framework for building efficient and scalable server-side applications.</p>
<p align="center">
<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/v/@nestjs/core.svg" alt="NPM Version" /></a>
<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/l/@nestjs/core.svg" alt="Package License" /></a>
<a href="https://www.npmjs.com/~nestjscore" target="_blank"><img src="https://img.shields.io/npm/dm/@nestjs/common.svg" alt="NPM Downloads" /></a>
<a href="https://circleci.com/gh/nestjs/nest" target="_blank"><img src="https://img.shields.io/circleci/build/github/nestjs/nest/master" alt="CircleCI" /></a>
<a href="https://discord.gg/G7Qnnhy" target="_blank"><img src="https://img.shields.io/badge/discord-online-brightgreen.svg" alt="Discord"/></a>
<a href="https://opencollective.com/nest#backer" target="_blank"><img src="https://opencollective.com/nest/backers/badge.svg" alt="Backers on Open Collective" /></a>
<a href="https://opencollective.com/nest#sponsor" target="_blank"><img src="https://opencollective.com/nest/sponsors/badge.svg" alt="Sponsors on Open Collective" /></a>
<a href="https://paypal.me/kamilmysliwiec" target="_blank"><img src="https://img.shields.io/badge/Donate-PayPal-ff3f59.svg" alt="Donate us"/></a>
<a href="https://opencollective.com/nest#sponsor" target="_blank"><img src="https://img.shields.io/badge/Support%20us-Open%20Collective-41B883.svg" alt="Support us"></a>
<a href="https://twitter.com/nestframework" target="_blank"><img src="https://img.shields.io/twitter/follow/nestframework.svg?style=social&label=Follow" alt="Follow us on Twitter"></a>
</p>
<!--[![Backers on Open Collective](https://opencollective.com/nest/backers/badge.svg)](https://opencollective.com/nest#backer)
[![Sponsors on Open Collective](https://opencollective.com/nest/sponsors/badge.svg)](https://opencollective.com/nest#sponsor)-->
```mermaid ## Description
erDiagram
Profile ||--o{ Skill : Навыки [Nest](https://github.com/nestjs/nest) framework TypeScript starter repository.
Profile ||--o{ Link : Ссылки
Profile ||--o{ Experience : "Опыт работы" ## Project setup
Profile ||--o{ Project : "Проекты"
```bash
Profile { $ yarn install
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 "достижения"
}
``` ```
### Требования: ## Compile and run the project
- Автоподготовка базы данных ```bash
- Автозаполнение данных при старте # development
- Доступ по GraphQL $ yarn run start
> Требуется уточнить, что бизнес имеет в виду под подготовкой базы данных
### Неявные требования # watch mode
$ yarn run start:dev
Особых неявных требований нет # production mode
$ yarn run start:prod
## Решения
### База данных
Конечно, в данном ТЗ данных столько, что достаточно было бы одного JSON файла, но возьмем БД postgres
Postgres - популярная, широкий функционал. Уже есть инфраструктура для нее.
Другие варианты:
- MariaDB - достаточно широкий функционал. Нет под нее инфраструктуры.
- SQLite - небольшая, встраиваемая. Инфраструктуры не требуется
- MongoDB - документная, что тоже подходит. Нет под нее инфраструктуры.
### Подготовка БД
Под подготовкой БД я понял создание базы данных и накатывание на нее миграций.
**Создание БД:**
- локально: вручную созданная БД
- на "проде" использую уже имеющуюся у меня инфраструктуру: БД будет создаваться скриптом на сервере
**Миграции:**
Так как миграция работает с бизнес-данными (а данные терять и повреждать нельзя), то накатывание миграций должно быть
достаточно явным процессом, и сама миграция должна быть однозначной.
Потому просто дать команду "приведи БД в соответствие со схемой" в orm библиотеке небезопасно, требуется именно миграция.
Подходящим считаю накатывать миграцию перед публикацией новой версии приложения прямо в CI.
### Автозаполнение данных на старте
На старте приложения, проверить количество записей в таблицах, и там, где пусто, заполнить данными из кода или JSON.
В реальном приложении это надо обсудить, а здесь достаточно такого решения.
### Остальное
- Выделенного фронта нет, есть Apollo Playground, который доступен из библиотек.
## Архитектура
> Если строго смотреть на потребности, то архитектура должна быть самой простой, большинство ее элементов можно
> посчитать переусложнением для такой задачи.
>
> Потому некоторые компоненты могут быть избыточны для текущей задачи, но полезны в реальном проекте.
### Горизонтальное разделение ответственности
Потребности в разделении на несколько модулей нет: один модуль, один ресолвер, нужные сущности.
Вот кейс по проектированию [биллинга](https://portfolio.arswarog.ru/cases/billing), где разделение ответственности
дает преимущества.
### Вертикальное разделение ответственности
Обычно модуль я делю на такие слои:
- Resolver / Controller: Точки входа, права доступа. Без бизнес логики
- Service: Бизнес логика
- Data Access Layer: Проектно специфичные методы для доступа к данным. Бизнес логика присутствует, только если она нужна
на уровне БД
- Repository: API библиотеки БД
В данном случае Data Access Layer будет явно излишним.
Так же эти слои показывают направление связей:
- Resolver имеет доступ только к Service
- Service имеет доступ только к Repository
### Сущности
Идентификаторы сущностям на уровне API не нужны, поэтому в GraphQL они не отдаются. Внутри БД они есть:
Prisma требует у модели уникальный идентификатор, и `id` (autoincrement) заодно даёт стабильные
связи `profileId` и порядок выдачи. Наружу это не протекает — DTO описывает только бизнес-поля.
Профиль ровно один, но запись профиля оставлю: так вложенность (профиль → навыки/ссылки/опыт/проекты)
выражена отношением в БД, а не соглашением «все строки таблицы принадлежат профилю».
---
---
---
## ТЗ
Смысл тестового задания в том, чтобы Вы продемонстрировали навык использования всех перечисленных технологий. Время на выполнение тестового задания не ограничено.
Упор на качество. Убедительная просьба – либо отнеситесь к тестовому заданию серьезно, либо не беритесь за него вовсе.
Создайте Вашу цифровую визитку (backend-приложение), которая презентует Вас как специалиста, с обязательным использованием следующих технологий:
- Git;
- TypeScript;
- Node.js;
- NestJS;
- Prisma;
- GraphQL;
- Docker.
Приложение должно предоставлять Apollo Sandbox, через которое можно получить информацию о Вас, Вашем опыте работы, навыках и проектах.
Бэкенд должен содержать:
1. Профиль:
- имя;
- краткое описание;
- ссылки на GitHub/LinkedIn или другие профессиональные ресурсы.
2. Список навыков.
3. Опыт работы:
- компания;
- должность;
- период работы;
- Ваши достижения.
4. Проекты:
- название;
- ссылка на проект/репозиторий.
При запуске приложения база данных должна быть автоматически подготовлена и заполнена Вашими данными.
API должно позволять получить профиль и связанные с ним данные, например:
```graphql
query {
profile {
name
description
skills {
name
}
experience {
company
position
}
projects {
name
}
}
}
``` ```
Конкретную структуру GraphQL API, базы данных и архитектуру приложения выберите самостоятельно. Обоснуйте принятые архитектурные решения в README.md файле. ## Run tests
Бизнес-логика, работа с данными и GraphQL API должны иметь разумное разделение ответственности. ```bash
# unit tests
$ yarn run test
Что оценивается: # e2e tests
- в первую очередь оценивается не количество написанного кода, а качество инженерных решений. $ yarn run test:e2e
Обратите внимание на: # test coverage
- структуру приложения и разделение ответственности; $ yarn run test:cov
- работу GraphQL с вложенными данными для оптимизации запросов к базе данных; ```
- взаимодействие с базой данных;
- инициализацию и заполнение базы данных;
- читаемость и поддерживаемость кода;
- корректную работу приложения после запуска с нуля.
Просим предоставить: ## Deployment
1. Ссылку на проект (для просмотра). Бэкенд можете попробовать развернуть на Vercel/Render/Railway или любым удобным для Вас способом;
2. Ссылку на Git (для ознакомления с исходным кодом). When you're ready to deploy your NestJS application to production, there are some key steps you can take to ensure it runs as efficiently as possible. Check out the [deployment documentation](https://docs.nestjs.com/deployment) for more information.
If you are looking for a cloud-based platform to deploy your NestJS application, check out [Mau](https://mau.nestjs.com), our official platform for deploying NestJS applications on AWS. Mau makes deployment straightforward and fast, requiring just a few simple steps:
```bash
$ yarn install -g @nestjs/mau
$ mau deploy
```
With Mau, you can deploy your application in just a few clicks, allowing you to focus on building features rather than managing infrastructure.
## Observability
In production applications, observability is essential for understanding how your system behaves, detecting issues early, and maintaining reliable performance.
[NestJS Observe](https://observe.nestjs.com) automatically instruments your NestJS application, giving you deep visibility into your system with minimal setup:
- **Distributed tracing:** Follow requests across services and understand how they flow through your system.
- **Waterfall analysis:** Visualize request execution and identify slow operations, bottlenecks, and unexpected delays.
- **Performance analysis:** Analyze application performance in real time and quickly pinpoint areas that need optimization.
- **Metrics:** Track key application and infrastructure metrics to understand system health and performance trends.
- **Logging:** Centralize and correlate logs with traces and other telemetry to make debugging easier.
- **Error tracking:** Detect errors quickly and investigate their root causes with the surrounding context.
- **SLA monitoring:** Track service-level objectives and identify when your application is approaching or exceeding defined thresholds.
- **Alarms and alerts:** Set up alerts for critical errors, performance degradation, SLA violations, and other anomalies so your team can react quickly.
This project is already instrumented. To connect it, run this and approve the code it prints at [observe.nestjs.com/link](https://observe.nestjs.com/link) - signing up for free if you have no account:
```bash
$ npx @nestjs/observe link
```
It writes the app key and secret into `.env` and makes every `nest start` script (`start`, `start:dev`, `start:debug`) load it. In production, set `OBSERVE_APP_KEY` and `OBSERVE_APP_SECRET` in the environment instead.
Or do it by hand: create an application and an API key at [observe.nestjs.com](https://observe.nestjs.com), and set the pair as `OBSERVE_APP_KEY` and `OBSERVE_APP_SECRET` in the environment the app runs in.
The free plan needs no payment details and covers 300,000 events a month. You can also browse the [live demo](https://www.observe-demo.nestjs.com/dashboard) first - the whole dashboard over a busy service's data, with nothing to install.
## Resources
Check out a few resources that may come in handy when working with NestJS:
- Visit the [NestJS Documentation](https://docs.nestjs.com) to learn more about the framework.
- For questions and support, please visit our [Discord channel](https://discord.gg/G7Qnnhy).
- To dive deeper and get more hands-on experience, check out our official video [courses](https://courses.nestjs.com/).
- Deploy your application to AWS with the help of [NestJS Mau](https://mau.nestjs.com) in just a few clicks.
- Auto-instrument your application with [NestJS Observe](https://observe.nestjs.com). Distributed tracing, metrics, and logging made easy. Error tracking and performance monitoring for your NestJS applications.
- Visualize your application graph and interact with the NestJS application in real-time using [NestJS Devtools](https://devtools.nestjs.com).
- Need help with your project (part-time to full-time)? Check out our official [enterprise support](https://enterprise.nestjs.com).
- To stay in the loop and get updates, follow us on [X](https://x.com/nestframework) and [LinkedIn](https://linkedin.com/company/nestjs).
- Looking for a job, or have a job to offer? Check out our official [Jobs board](https://jobs.nestjs.com).
## Support
Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support).
## Stay in touch
- Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec)
- Website - [https://nestjs.com](https://nestjs.com/)
- Twitter - [@nestframework](https://twitter.com/nestframework)
## License
Nest is [MIT licensed](https://github.com/nestjs/nest/blob/master/LICENSE).
-9
View File
@@ -1,13 +1,4 @@
services: services:
migrate:
container_name: it-smi_${BRANCH}_migrate
image: git.jt4d.ru/public/it-smi/api:${BRANCH}-migrate
environment:
DATABASE_URL: postgres://${POSTGRES_USER:-}:${POSTGRES_PASSWORD:-}@${POSTGRES_HOST:-}:${POSTGRES_PORT:-5432}/${POSTGRES_DB:-}
restart: 'no'
networks:
- 'net'
api: api:
container_name: it-smi_${BRANCH}_api container_name: it-smi_${BRANCH}_api
image: git.jt4d.ru/public/it-smi/api:${BRANCH} image: git.jt4d.ru/public/it-smi/api:${BRANCH}
+1 -1
View File
@@ -35,6 +35,7 @@
"dotenv": "^18.0.10", "dotenv": "^18.0.10",
"graphql": "^17.1.0", "graphql": "^17.1.0",
"pg": "^8.23.1", "pg": "^8.23.1",
"prisma": "8.0.0-rc.33",
"reflect-metadata": "^0.2.2", "reflect-metadata": "^0.2.2",
"rxjs": "^7.8.1", "rxjs": "^7.8.1",
"ts-morph": "^28.0.0" "ts-morph": "^28.0.0"
@@ -52,7 +53,6 @@
"oxlint": "^1.58.0", "oxlint": "^1.58.0",
"oxlint-tsgolint": "^7.0.2001", "oxlint-tsgolint": "^7.0.2001",
"prettier": "^3.4.2", "prettier": "^3.4.2",
"prisma": "7.10.1",
"source-map-support": "^0.5.21", "source-map-support": "^0.5.21",
"supertest": "^7.0.0", "supertest": "^7.0.0",
"typescript": "^6.0.2", "typescript": "^6.0.2",
@@ -1,75 +0,0 @@
-- CreateTable
CREATE TABLE "Profile" (
"id" SERIAL NOT NULL,
"firstName" TEXT NOT NULL,
"lastName" TEXT NOT NULL,
"description" TEXT NOT NULL,
CONSTRAINT "Profile_pkey" PRIMARY KEY ("id")
);
-- CreateTable
CREATE TABLE "Skill" (
"id" SERIAL NOT NULL,
"name" TEXT NOT NULL,
"profileId" INTEGER NOT NULL,
CONSTRAINT "Skill_pkey" PRIMARY KEY ("id")
);
-- CreateTable
CREATE TABLE "Link" (
"id" SERIAL NOT NULL,
"name" TEXT NOT NULL,
"link" TEXT NOT NULL,
"profileId" INTEGER NOT NULL,
CONSTRAINT "Link_pkey" PRIMARY KEY ("id")
);
-- CreateTable
CREATE TABLE "Project" (
"id" SERIAL NOT NULL,
"name" TEXT NOT NULL,
"link" TEXT NOT NULL,
"description" TEXT NOT NULL,
"profileId" INTEGER NOT NULL,
CONSTRAINT "Project_pkey" PRIMARY KEY ("id")
);
-- CreateTable
CREATE TABLE "Experience" (
"id" SERIAL NOT NULL,
"company" TEXT NOT NULL,
"position" TEXT NOT NULL,
"period" TEXT NOT NULL,
"achievements" TEXT[] DEFAULT ARRAY[]::TEXT[],
"profileId" INTEGER NOT NULL,
CONSTRAINT "Experience_pkey" PRIMARY KEY ("id")
);
-- CreateIndex
CREATE INDEX "Skill_profileId_idx" ON "Skill"("profileId");
-- CreateIndex
CREATE INDEX "Link_profileId_idx" ON "Link"("profileId");
-- CreateIndex
CREATE INDEX "Project_profileId_idx" ON "Project"("profileId");
-- CreateIndex
CREATE INDEX "Experience_profileId_idx" ON "Experience"("profileId");
-- AddForeignKey
ALTER TABLE "Skill" ADD CONSTRAINT "Skill_profileId_fkey" FOREIGN KEY ("profileId") REFERENCES "Profile"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-- AddForeignKey
ALTER TABLE "Link" ADD CONSTRAINT "Link_profileId_fkey" FOREIGN KEY ("profileId") REFERENCES "Profile"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-- AddForeignKey
ALTER TABLE "Project" ADD CONSTRAINT "Project_profileId_fkey" FOREIGN KEY ("profileId") REFERENCES "Profile"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-- AddForeignKey
ALTER TABLE "Experience" ADD CONSTRAINT "Experience_profileId_fkey" FOREIGN KEY ("profileId") REFERENCES "Profile"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-3
View File
@@ -1,3 +0,0 @@
# Please do not edit this file manually
# It should be added in your version-control system (e.g., Git)
provider = "postgresql"
-53
View File
@@ -11,56 +11,3 @@ generator client {
datasource db { datasource db {
provider = "postgresql" provider = "postgresql"
} }
model Profile {
id Int @id @default(autoincrement())
firstName String
lastName String
description String
skills Skill[]
links Link[]
experiences Experience[]
projects Project[]
}
model Skill {
id Int @id @default(autoincrement())
name String
profileId Int
profile Profile @relation(fields: [profileId], references: [id], onDelete: Cascade)
@@index([profileId])
}
model Link {
id Int @id @default(autoincrement())
name String
link String
profileId Int
profile Profile @relation(fields: [profileId], references: [id], onDelete: Cascade)
@@index([profileId])
}
model Project {
id Int @id @default(autoincrement())
name String
link String
description String
profileId Int
profile Profile @relation(fields: [profileId], references: [id], onDelete: Cascade)
@@index([profileId])
}
model Experience {
id Int @id @default(autoincrement())
company String
position String
period String
achievements String[] @default([])
profileId Int
profile Profile @relation(fields: [profileId], references: [id], onDelete: Cascade)
@@index([profileId])
}
File renamed without changes.
+1553 -977
View File
File diff suppressed because it is too large. Load diff