avito-test-work

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

avito-test-work

★ 10 Open GitHub ↗

Тестовое задание в avito на golang-разработчика.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Тестовое задание на позицию стажера-бекендера

## Микросервис для работы с балансом пользователей.

**Проблема:**

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

**Задача:**

Необходимо реализовать микросервис для работы с балансом пользователей (зачисление средств, списание средств, перевод средств от пользователя к пользователю, а также метод получения баланса пользователя). Сервис должен предоставлять HTTP API и принимать/отдавать запросы/ответы в формате JSON.
Подробнее тестовое задание описано [тут](https://github.com/avito-tech/autumn-2021-intern-assignment/blob/main/README.md).

**Решение:**

Для обеспечения корректности данных операции над баланасом пользователя выполняются в транзакциях со строгой изоляцией [`Serializable`](https://postgrespro.ru/docs/postgrespro/9.5/transaction-iso). С таким уровнем изоляции каждая транзакция будет исполнятся будто последовательно, что обеспечивает корректность значений при параллельных запросах на обновление баланса.

Архитектура проекта была вдохнавлена [go-clean-template](https://github.com/evrone/go-clean-template). В слое `entity` находится модель данных, в слое `usecase` описаны пути работы с моделью данных, в `repo` работа с хранилищем данных.

АPI микросервиса предоставляет следующий функционал:

1. Создание нового аккаунта
2. Получение полей аккаунта
3. Обновление баланса аккаунта
4. Перевод средств между аккаунтами
5. Получение истории транзакций аккаунта с возможностью сортировки и пагинации

После успешного запуска проекта интерактивная документация API доступна по [ссылке](http://0.0.0.0:8080/swagger/index.html).

**Развёртывание:**

Запуск сервера и СУБД:
```shell
make run
```

Запуск юнит-тестов:
```shell
make unit-test
```

Запуск интеграционных тестов:
```shell
make integration-test
```

Генерация swagger документации:
```shell
make run-swag
```

Остановка сервера и СУБД, удаление контейнеров и сети:
```shell
make down
```

**Конфигурирование:**

Через переменные окружения можно настроить реквизиты доступа к СУБД. Чтобы их задать, необходимо создать и заполнить `.env` файл. Пример его заполнения в файле `.env.example`. Для быстрой демонстрации проекта в `docker-compose.yml` прописаны значения переменных окружения по умолчанию.

Для конфигурирования не конфиденциальных переменных достаточно прописать их в `config/config.yml`. При изменении портов необходимо изменить обновить информацию в коде интеграционных тестов. Код инициализации СУБД находится в файле `init/init.sql`.

**Примеры:**

***Создание аккаунта***

```shell
curl -X POST "http://0.0.0.0:8080/v1/account/"
```

```json
"data": {
  "id": 1,
  "balance": 0,
  "created_dt": "2022-07-11T18:37:27.126846Z"
}
```

***Получить аккаунт по ID***

```shell
curl -X GET "http://0.0.0.0:8080/v1/account/1"

```

```json
"data": {
    "id": 1,
    "balance": 56,
    "created_dt": "2022-07-11T18:37:27.126846Z"
}
```
    
***Обновить баланс, начислить 56 рублей***

```shell
curl -X PUT "http://0.0.0.0:8080/v1/account/1?amount=56"
```

```json
"data": {
    "id": 1,
    "balance": 56,
    "created_dt": "2022-07-11T18:37:27.126846Z"
}
```

***Обновить баланс, снять 16 рублей***

```shell
curl -X PUT "http://0.0.0.0:8080/v1/account/1?amount=-16"
```

```json
"data": {
    "id": 1,
    "balance": 40,
    "created_dt": "2022-07-11T18:37:27.126846Z"
}
```

***Перевести 10 рублей от аккаунта 1 аккаунту 2 (должен был быть создан заранее)***

```shell
curl -X PUT "http://0.0.0.0:8080/v1/account/amount/1/transfer/2?amount=10"
```

```json
"data": {
    "accrualAccount": {
        "id": 2,
        "balance": 10,
        "created_dt": "2022-07-11T18:46:41.585732Z"
    },
    "redeemAccount": {
        "id": 1,
        "balance": 30,
        "created_dt": "2022-07-11T18:37:27.126846Z"
    }
}
```
***Получить историю транзакций аккаунта 1 c сортировкой по убыванию даты операции (по умолчанию)***

```shell
curl -X GET "http://0.0.0.0:8080/v1/account/history/1?limit=15&offset=0"
```

```json
"data": [
    {
        "id": 1,
        "trans_dt": "2022-07-11T18:50:21.906308Z",
        "account_id": 1,
        "doc_num": -999,
        "type": "accrual",
        "amount": 56
    },
    {
        "id": 2,
        "trans_dt": "2022-07-11T18:50:25.121921Z",
        "account_id": 1,
        "doc_num": -999,
        "type": "redeem",
        "amount": -16
    },
    {
        "id": 3,
        "trans_dt": "2022-07-11T18:50:27.348807Z",
        "account_id": 1,
        "doc_num": 2,
        "type": "redeem",
        "amount": -10
    }
]
```

***Получить историю транзакций аккаунта 1 c сортировкой по возрастанию суммы операции***

```shell
curl -X GET "http://0.0.0.0:8080/v1/account/history/1?limit=15&offset=0&sort=amount&isDecreasing=false"
```

```json
"data": [
    {
        "id": 1,
        "trans_dt": "2022-07-11T18:50:21.906308Z",
        "account_id": 1,
        "doc_num": -999,
        "type": "accrual",
        "amount": 56
    },
    {
        "id": 3,
        "trans_dt": "2022-07-11T18:50:27.348807Z",
        "account_id": 1,
        "doc_num": 2,
        "type": "redeem",
        "amount": -10
    },
    {
        "id": 2,
        "trans_dt": "2022-07-11T18:50:25.121921Z",
      "account_id": 1,
        "doc_num": -999,
        "type": "redeem",
        "amount": -16
    }
]
```

avito-test-work

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README