API для управления фильмами, жанрами и отзывами с системой аутентификации и ролями.

• Go 1.24 или выше
• PostgreSQL 16 или выше
• Docker и Docker Compose (опционально, для упрощенного запуска)

Самый простой способ запустить проект:

1. Запустите все сервисы (база данных + API + Admin):

   docker-compose up -d

2. Миграции применяются автоматически при запуске API сервера.

3. Сервисы будут доступны на:

   • API: http://localhost:8080
   • Admin панель: http://localhost:8081

go mod download

Используйте Docker Compose только для базы данных:

docker-compose up -d db

Или используйте свою локальную установку PostgreSQL.

# Создайте базу данных
createdb -U app app

# Примените миграции (требуется golang-migrate)
migrate -path internal/migrations -database "postgres://app:app@localhost:5432/app?sslmode=disable" up

Windows (PowerShell):

$env:DB_DSN="postgres://app:app@localhost:5432/app?sslmode=disable"
$env:JWT_SECRET="your-secret-key-here-change-in-production"
$env:PORT="8080"
$env:MIGRATIONS_PATH="internal/migrations"

Windows (CMD):

set DB_DSN=postgres://app:app@localhost:5432/app?sslmode=disable
set JWT_SECRET=your-secret-key-here-change-in-production
set PORT=8080
set MIGRATIONS_PATH=internal/migrations

Linux/Mac:

export DB_DSN="postgres://app:app@localhost:5432/app?sslmode=disable"
export JWT_SECRET="your-secret-key-here-change-in-production"
export PORT="8080"
export MIGRATIONS_PATH="internal/migrations"

Или создайте файл .env (если используете инструмент для загрузки .env файлов).

go run cmd/api/main.go

Сервер будет доступен на http://localhost:8080

• GET /api/v1/health - Проверка здоровья сервиса
• POST /api/v1/auth/register - Регистрация нового пользователя
• POST /api/v1/auth/login - Вход в систему
• GET /api/v1/genres - Список всех жанров
• GET /api/v1/genres/:id - Получить жанр по ID
• GET /api/v1/movies - Список всех фильмов
• GET /api/v1/movies/:id - Получить фильм по ID
• GET /api/v1/movies/:id/reviews - Список отзывов к фильму
• GET /api/v1/users/:id/reviews - Список отзывов пользователя

• GET /api/v1/me - Информация о текущем пользователе
• PUT /api/v1/me - Обновление профиля текущего пользователя
• PUT /api/v1/me/password - Изменение пароля
• GET /api/v1/me/reviews - Мои отзывы
• POST /api/v1/movies/:id/reviews - Создать отзыв к фильму
• PUT /api/v1/reviews/:id - Обновить отзыв
• DELETE /api/v1/reviews/:id - Удалить отзыв

• GET /api/v1/users - Список всех пользователей
• GET /api/v1/users/:id - Получить пользователя по ID
• PUT /api/v1/users/:id - Обновить пользователя
• PUT /api/v1/users/:id/role - Изменить роль пользователя
• DELETE /api/v1/users/:id - Удалить пользователя
• GET /api/v1/stats - Статистика системы
• GET /api/v1/audit-logs - Логи аудита
• POST /api/v1/genres - Создать жанр
• PUT /api/v1/genres/:id - Обновить жанр
• DELETE /api/v1/genres/:id - Удалить жанр
• POST /api/v1/movies - Создать фильм
• PUT /api/v1/movies/:id - Обновить фильм
• DELETE /api/v1/movies/:id - Удалить фильм

API использует JWT токены для аутентификации. После регистрации или входа вы получите токен, который нужно передавать в заголовке:

Authorization: Bearer <your-token>

• user - обычный пользователь (по умолчанию)

  • Может создавать и управлять своими отзывами
  • Может просматривать фильмы и жанры
  • Может обновлять свой профиль

• admin - администратор

  • Все права пользователя
  • Управление пользователями
  • Управление фильмами и жанрами
  • Просмотр статистики и логов аудита

При запуске API сервера миграции базы данных применяются автоматически. Путь к миграциям настраивается через переменную окружения MIGRATIONS_PATH.

Система включает background worker для обработки событий отзывов:

• Автоматическое обновление среднего рейтинга фильма при создании/обновлении/удалении отзыва
• Запись событий в audit log

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

В API включён простой in-memory rate limiting middleware:

• лимит: 60 запросов в минуту на один IP-адрес
• при превышении возвращается 429 Too Many Requests с телом:
  • {"error":"rate limit exceeded"}

API использует следующие middleware:

• Request ID - уникальный ID для каждого запроса
• Logger - логирование запросов
• Rate Limit - ограничение частоты запросов
• CORS - настройка CORS заголовков
• Body Limit - ограничение размера тела запроса (1MB)
• Auth - проверка JWT токена
• Role-based access control - проверка ролей для admin endpoints

В корне репозитория лежит файл postman_collection.json с примерными запросами:

• Auth: регистрация и логин (/api/v1/auth/register, /api/v1/auth/login)
• Genres: список и создание жанра (для admin)
• Movies: список и создание фильма (для admin)
• Reviews: создание отзыва авторизованным пользователем

Как использовать:

1. Импортируйте postman_collection.json в Postman.
2. В переменной base_url оставьте http://localhost:8080 или измените при необходимости.
3. Зарегистрируйте пользователя и залогиньтесь, возьмите токен и заполните:
   • {{admin_token}} — токен admin-пользователя
   • {{user_token}} — токен обычного пользователя

golang-project/
├── cmd/
│   ├── api/          # API сервер
│   └── admin/        # Admin панель
├── internal/
│   ├── database/     # Подключение к БД
│   ├── handler/      # HTTP обработчики
│   ├── middleware/   # Middleware
│   ├── migrations/   # SQL миграции
│   ├── models/       # Модели данных
│   ├── repository/   # Репозитории
│   ├── router/       # Роутинг
│   └── service/      # Бизнес-логика
└── pkg/              # Публичные пакеты

Для запуска тестов:

go test ./...

Для запуска тестов с покрытием:

go test -cover ./...

docker-compose down

Для удаления данных базы данных:

docker-compose down -v

This project was developed by kbtu students as an students project for the Open Source / Digital Public Goods assignment.

This project contributes to UN Sustainable Development Goal 9 — Industry, Innovation and Infrastructure.
It provides a modern, fully open-source backend API that demonstrates how to build scalable digital services using Go, PostgreSQL and Docker. By publishing the complete source code, the project promotes technological innovation, knowledge sharing and reuse of infrastructure solutions.

• Passwords are stored using secure hashing.
• Authentication is performed via JWT tokens.
• Sensitive configuration (database credentials, JWT secret) is managed exclusively through environment variables and is never committed to the repository.
• Rate limiting (60 requests per minute per IP) is implemented to protect against abuse.
• The project follows security best practices and can be extended with additional privacy features if needed.

We welcome contributions!
Please read CONTRIBUTING.md for details on our code of conduct, development process, and how to submit pull requests.

This project is licensed under the MIT License — see the LICENSE file for details.

This project adheres to the Contributor Covenant Code of Conduct.
We expect all contributors and users to follow it to ensure a welcoming and inclusive environment.