MisterZurg / avito-tech-internship-2023

📝Backend trainee assignment (Summer 2023)

Сервис динамического сегментирования пользователей

Important

Проблема: В Авито часто проводятся различные эксперименты — тесты новых продуктов, тесты интерфейса, скидочные и многие другие. На архитектурном комитете приняли решение централизовать работу с проводимыми экспериментами и вынести этот функционал в отдельный сервис.

Задача: Требуется реализовать сервис, хранящий пользователя и сегменты, в которых он состоит (создание, изменение, удаление сегментов, а также добавление и удаление пользователей в сегмент)

Содержание

TBA

Архитектура Продуктовой задачи

Как запустить?

make run

Используемые зависимости и тулы

• protoc mechanism for serializing structured data.
• gRPC-Gateway plugin that reads protobuf service definitions and generates a reverse-proxy server which translates a RESTful HTTP API into gRPC
• sqlx extension on go's standard database/sql
• pgx pure Go driver and toolkit for PostgreSQL
• env simple and zero-dependencies library to parse environment variables into structs

Задание

Important

API можно посмотреть в contract.swagger.json

Основное задание:

Метод создания сегмента.

Note

Принимает slug (название) сегмента.

.http

POST /v1/example/createSegment HTTP/1.1
Host: localhost:8090
Content-Type: application/json
Accept: */*

{
"slug": "AVITO_DISCOUNT_502"
} 

.proto

service SegmentsService {
  rpc CreateSegment(CreateSegmentRequest) returns (CreateSegmentResponse) {
    option (google.api.http) = {
      post: "/v1/example/createSegment"
      body: "*"
    };
  // ...
}

Метод удаления сегмента.

Note

Принимает slug (название) сегмента.

.http

DELETE /v1/example/deleteSegment/AVITO_DISCOUNT_502 HTTP/1.1
Host: localhost:8090
Content-Type: application/json
Accept: */*

{
"slug": "AVITO_DISCOUNT_502"
}

.proto

service SegmentsService {
  // ...
  rpc DeleteSegment(DeleteSegmentRequest) returns (DeleteSegmentResponse) {
    option (google.api.http) = {
      delete: "/v1/example/deleteSegment/{slug}"
    };
  }
}

Метод добавления пользователя в сегмент.

Note

Принимает список slug (названий) сегментов которые нужно добавить пользователю, список slug (названий) сегментов которые нужно удалить у пользователя, id пользователя.

.http

POST /v1/example/addUserToSegment HTTP/1.1
Host: localhost:8090
Content-Type: application/json
Accept: */*

{
  "slugsAdd": [
    "I_WISH_TO",
    "WORK_AT_AVITO"
  ],
  "slugsDel": [
    "WITHOUT",
    "AVITO_VOICE_MESSAGES"
  ],
  "userId": "10012"
}

.proto

service UsersService {
  rpc AddUserToSegment(AddUserToSegmentRequest) returns (AddUserToSegmentResponse) {
    option (google.api.http) = {
      post: "/v1/example/addUserToSegment"
      body: "*"
    };
  }
  // ...
}

Метод получения активных сегментов пользователя.

Note

Принимает на вход id пользователя.

.http

GET /v1/example/getActiveSegments/1006 HTTP/1.1
Host: localhost:8090
Content-Type: application/json
Accept: */*

{
"user_id": 1006
}

.proto

service UsersService {
  // ...
  rpc GetActiveSegments(GetActiveSegmentsRequest) returns (GetActiveSegmentsResponse) {
    option (google.api.http) = {
      get: "/v1/example/getActiveSegments/{user_id}"
    };
  }
}