db_example_app/README.md

80 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

### Пример приложения для работы с БД
Небольшое десктоп‑приложение на PyQt5 для работы с PostgreSQL и Neo4j.
### Стек
- PyQt5 — графический интерфейс
- PostgreSQL (psycopg2) — реляционная БД для пользователей
- Neo4j — графовая БД для фильмов
- python-dotenv — загрузка параметров подключения из файла `.env`
### Скриншоты
**PostgreSQL:**
![form.png](form.png)
**Neo4j:**
![neo_form.png](neo_form.png)
### Требования
- Python 3.10+
- Установленный PostgreSQL и доступ к серверу БД
- Установленный Neo4j и загруженный обучающий граф фильмов (Movie Graph example)
### Настройка окружения
1. Переименовать файл примера переменных окружения `.env_example` в `.env`:
Затем откройте `.env` и при необходимости измените значения:
```env
POSTGRES_USER=postgres
POSTGRES_DB=university
POSTGRES_PASS=your_password
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
NEO_ACTIVE=false # включить Neo4j-часть приложения, установив true
NEO_USER=neo4j
NEO_PASS=your_password
NEO_HOST=neo4j://localhost:7687
```
2. Создайте и активируйте виртуальное окружение:
Windows, PowerShell:
```powershell
cd C:\Users\Litoq\Documents\Projects\db_example_app
py -m venv .venv
.\.venv\Scripts\Activate.ps1
```
Linux, bash:
```bash
cd ~/Projects/db_example_app
python3 -m venv .venv
source .venv/bin/activate
```
3. Установите зависимости:
```bash
pip install -r requirements.txt
```
### Запуск приложения
В активированном виртуальном окружении выполните:
```powershell
py main.py
```
Приложение подключится к PostgreSQL, создаст БД/таблицу и тестовые данные (если их ещё нет), выполнит запрос к Neo4j (если активно) и отобразит результаты в двух окнах.