AdData Analytics & Processing System

Система для прийому, валідації та аналізу маркетингових звітів (CSV / XLSX) з рольовим доступом (Користувач / Адміністратор) та кабінетом аналітики.

---

1. Налаштування змінних оточення (.env)

Перед запуском проекту необхідно налаштувати або перевірити файли конфігурації в папці environment/:

environment/db.env (Конфігурація бази даних PostgreSQL)

• POSTGRES_DB — назва бази даних (наприклад, process_csv_db).
• POSTGRES_USER — ім'я користувача БД (наприклад, postgres).
• POSTGRES_PASSWORD — надійний пароль до БД.

environment/backend.env (Конфігурація Django-сервера)

• DEBUG — режим відладки (True для розробки, False для продакшену).
• SECRET_KEY — секретний ключ Django для безпеки токенів та сесій.
• DB_NAME, DB_USER, DB_PASSWORD — мають повністю збігатися зі значеннями, вказаними в db.env.
• DB_HOST — хост бази даних (за замовчуванням db для Docker).

environment/frontend.env (Конфігурація React-додатка)

• VITE_API_URL — базовий URL для запитів на бекенд (за замовчуванням /api через проксі-сервер Nginx).

---

2. Швидкий запуск додатка

Усі основні команди керування проектом об'єднані в Makefile:

Крок 1: Збірка контейнерів

Складання Docker-образів для фронтенду, бекенду та веб-сервера Nginx:

make build

Крок 2: Запуск системи

Запуск контейнерів у фоновому режимі:

make up

Крок 3: Міграції бази даних

Створення таблиць та структури бази даних:

make migrate

Крок 4: Створення користувачів

Ви можете створити готових демо-користувачів для тестування обох рівнів доступу:

make create_users

Створені акаунти:

• Адміністратор: admin@example.com / Пароль: admin
• Звичайний користувач: user@example.com / Пароль: user

Для створення власного адміністратора вручную запустіть команду:

make superuser

---

3. Запуск автоматичних тестів (PyTest)

Для перевірки працездатності бекенду, парсерів та рівнів доступу запустіть:

make test

---

4. Зупинка проекту

Щоб зупинити роботу контейнерів:

make down