Распределённый калькулятор

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

Структура проекта

• cmd/orchestrator — HTTP и gRPC сервис (Оркестратор)
• cmd/agent — gRPC клиент (Агент), выполняющий вычислительные задачи
• internal/database — работа с SQLite (модели, миграции, CRUD)
• internal/orchestrator — логика HTTP-обработчиков, парсер выражений, планировщик задач, gRPC сервер
• internal/agent — gRPC-воркер, выполняющий вычисления

Быстрый старт

1. Клонируем репозиторий:

   git clone https://github.com/StarwinM/go_final_sprint3.git
   cd go_final_sprint3

2. Устанавливаем зависимости:

   go mod tidy

3. Настраиваем переменные окружения:

   export JWT_SECRET="your_jwt_token_here"
   export COMPUTING_POWER=4  # опционально

4. Запускаем оркестратор:

   go run ./cmd/orchestrator

5. В новом терминале запускаем агента (можно несколько экземпляров):

   go run ./cmd/agent

6. Открываем приложение в браузере по адресу:

   http://localhost:8080
   

API

Базовый URL: http://localhost:8080/api/v1

1. Регистрация пользователя

• POST /register

  curl -s -X POST http://localhost:8080/api/v1/register \
    -H "Content-Type: application/json" \
    -d '{"login":"user1","password":"pass123"}'

• Коды ответа:

  • 200 Created — успешно
  • 400 Bad Request — неверный формат или пустые поля
  • 409 Conflict — логин уже занят

2. Вход (JWT)

• POST /login

  curl -s -X POST http://localhost:8080/api/v1/login \
    -H "Content-Type: application/json" \
    -d '{"login":"user1","password":"pass123"}'

• Коды ответа:

  • 200 OK и JSON:

    { "token": "<JWT_TOKEN>" }

  • 400 Bad Request — неверный формат
  • 401 Unauthorized — неверные логин/пароль

3. Отправка выражения на вычисление

• POST /calculate

  curl -s -X POST http://localhost:8080/api/v1/calculate \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <JWT_TOKEN>" \
    -d '{"expression":"(2+3)*4"}'

• Коды ответа:

  • 200 Created и JSON:

    {
      "id": 1,
      "expression": "(2+3)*4",
      "status": "pending"
    }

  • 400 Bad Request — пустое или некорректное выражение
  • 401 Unauthorized — отсутствует или неверный токен

4. Получение статуса и результата

• GET /expressions — список всех ваших выражений
• GET /expressions/<id> — конкретное выражение по ID

curl -s -X GET http://localhost:8080/api/v1/expressions/<id> \
  -H "Authorization: Bearer <JWT_TOKEN>"

• Коды ответа:
  • 200 OK и JSON-объект/массив:

    [
      {
        "id": 1,
        "user_id": 1,
        "expression": "(2+3)*4",
        "status": "done",
        "result": 20,
        "steps": ["Result: 5","Result: 20"],
        "created_at": "...",
        "updated_at": "..."
      }
    ]

Тестирование

go test ./internal/orchestrator/parser.go
go test ./internal/agent/worker.go
go test ./internal/orchestrator

---