2.9 KiB

Raw Blame History

cards

Веб-сервер на C++20 с использованием Boost.Beast и PostgreSQL. Отдаёт случайные записи из базы данных по REST API.

Требования

Компилятор с поддержкой C++20 (GCC 10+, Clang 10+)
CMake >= 3.14
PostgreSQL (runtime) + libpq + libpqxx >= 7.0
Boost (system)
nlohmann_json 3.x

Установка зависимостей (Debian/Ubuntu):

sudo apt-get install libboost-all-dev libpq-dev libpqxx-dev nlohmann-json3-dev cmake build-essential

Сборка

./configure.sh

Или вручную:

mkdir -p build && cd build
cmake ..
make -j"$(nproc)"
cd ..

Бинарник: build/bin/cards

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

По умолчанию читает config.json из рабочей директории. Можно указать путь к другому файлу:

./build/bin/cards /path/to/config.json

Поля `config.json`

server

Поле	Тип	Значение по умолчанию
address	string	`"0.0.0.0"`
port	int	`8080`
threads	int	`4`

database

Поле	Тип	Значение по умолчанию
host	string	`"localhost"`
port	int	`5432`
dbname	string	`"testdb"`
user	string	`"postgres"`
password	string	(пусто)

Переменные окружения

Переопределяют соответствующие поля config.json:

DB_HOST
DB_PORT
DB_NAME
DB_USER
DB_PASSWORD

Пример:

DB_PASSWORD=secret ./build/bin/cards

API

Метод	Путь	Описание
GET	`/`	Случайная запись из таблицы `random_data`
GET	`/health`	Проверка состояния сервера

Пример ответа `GET /`

{
    "id": 3,
    "name": "Gamma",
    "value": 300,
    "description": "Third test record",
    "created_at": "2025-01-01 12:00:00",
    "timestamp": 1735732800000000000
}

Пример ответа `GET /health`

{
    "status": "ok",
    "timestamp": 1735732800000000000
}

База данных

При первом запуске автоматически создаётся таблица random_data и заполняется десятью тестовыми записями.

Схема таблицы:

CREATE TABLE random_data (
    id          SERIAL PRIMARY KEY,
    name        VARCHAR(100) NOT NULL,
    value       INTEGER NOT NULL,
    description TEXT,
    created_at  TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

Сборка deb-пакета

cd build
cmake ..
cpack

Результат: cards-1.0.0-Linux.deb

Завершение работы

Для остановки сервера отправьте сигнал SIGINT (Ctrl+C) или SIGTERM.

2.9 KiB Raw Blame History Unescape Escape