hmtpk_schedule_api

README

API ХМТПК Расписание

Этот репозиторий представляет собой API для получения списка групп, преподавателей и расписания Ханты-Мансийского технолого-педагогического колледжа (ХМТПК).

Описание

API предоставляет функциональность HTTP и gRPC серверов для получения информации о группах, преподавателях и расписании занятий.

Особенности

• HTTP сервер: Предоставляет конечные точки для получения списка групп, преподавателей и общего расписания.
• gRPC сервер: Реализует методы gRPC для получения списка групп, преподавателей и деталей расписания.
• Докеризованное развертывание: Включает конфигурацию Docker для удобного развертывания.

Использование

Запуск HTTP сервера

Чтобы запустить HTTP сервер, выполните следующую команду:

docker-compose up http-schedule-server

Это запустит HTTP сервер на порту 80 для HTTP и порту 443 для HTTPS.

Запуск gRPC сервера

Чтобы запустить gRPC сервер, выполните следующую команду:

docker-compose up grpc-schedule-server

Это запустит gRPC сервер на порту 50051.

API Endpoints

HTTP Конечные Точки

• GET /groups: Получить список групп.
• GET /teachers: Получить список преподавателей.
• GET /schedule: Получить общее расписание занятий.

Методы gRPC

• GetGroups: Получить список групп.
• GetTeachers: Получить список преподавателей.
• GetSchedule: Получить детали расписания на основе предоставленных параметров.

Определения Protobuf

syntax = "proto3";

option go_package = "../protobuf";

package Schedule;

message Request {
  string token = 1;
}

message Response {
  string message = 1;
}

message ScheduleRequest {
  string token = 1;
  string date = 2;
  string group = 3;
  string teacher = 4;
}

message ScheduleResponse {
  string message = 1;
}

service Schedule {
  rpc GetGroups (Request) returns (Response);
  rpc GetTeachers (Request) returns (Response);
  rpc GetSchedule (ScheduleRequest) returns (ScheduleResponse);
}

Конфигурация Docker Compose

version: '3'
services:
  redis:
    container_name: schedule-redis
    image: redis:6.2-alpine
    restart: always
    ports:
      - '6379:6379'
    command: redis-server --save 20 1 --loglevel warning --requirepass password
  http-schedule-server:
    container_name: http-schedule-server
    build: .
    ports:
      - "80:80"
      - "443:443"
    restart: always
    command: [ "/app/main", "http"]
  grpc-schedule-server:
    container_name: grpc-schedule-server
    build: .
    ports:
      - "50051:50051"
    restart: always
    command: [ "/app/main", "grpc"]

OpenAPI Specification

Файл openAPI содержит спецификацию API в формате OpenAPI.

Лицензия

Этот проект лицензирован под лицензией MIT.