# Database Migrations

Этот каталог содержит SQL миграции для создания структуры базы данных проекта play-life.

## Использование

### Создание базы данных с нуля

Выполните миграцию для создания всех таблиц и представлений:

```bash
psql -U your_user -d your_database -f 001_create_schema.sql
```

Или через docker-compose:

```bash
docker-compose exec db psql -U playeng -d playeng -f /migrations/001_create_schema.sql
```

## Структура базы данных

### Таблицы

1. **projects** - Проекты
   - `id` (SERIAL PRIMARY KEY)
   - `name` (VARCHAR(255) NOT NULL, UNIQUE)
   - `priority` (SMALLINT)

2. **entries** - Записи с текстом и датами создания
   - `id` (SERIAL PRIMARY KEY)
   - `text` (TEXT NOT NULL)
   - `created_date` (TIMESTAMP WITH TIME ZONE NOT NULL, DEFAULT CURRENT_TIMESTAMP)

3. **nodes** - Узлы, связывающие проекты и записи
   - `id` (SERIAL PRIMARY KEY)
   - `project_id` (INTEGER NOT NULL, FK -> projects.id ON DELETE CASCADE)
   - `entry_id` (INTEGER NOT NULL, FK -> entries.id ON DELETE CASCADE)
   - `score` (NUMERIC(8,4))

4. **weekly_goals** - Недельные цели для проектов
   - `id` (SERIAL PRIMARY KEY)
   - `project_id` (INTEGER NOT NULL, FK -> projects.id ON DELETE CASCADE)
   - `goal_year` (INTEGER NOT NULL)
   - `goal_week` (INTEGER NOT NULL)
   - `min_goal_score` (NUMERIC(10,4) NOT NULL, DEFAULT 0)
   - `max_goal_score` (NUMERIC(10,4))
   - `actual_score` (NUMERIC(10,4), DEFAULT 0)
   - `priority` (SMALLINT)
   - UNIQUE CONSTRAINT: `(project_id, goal_year, goal_week)`

### Materialized View

- **weekly_report_mv** - Агрегированные данные по неделям для каждого проекта
  - `project_id` (INTEGER)
  - `report_year` (INTEGER)
  - `report_week` (INTEGER)
  - `total_score` (NUMERIC)

## Обновление Materialized View

После изменения данных в таблицах `nodes` или `entries`, необходимо обновить materialized view:

```sql
REFRESH MATERIALIZED VIEW weekly_report_mv;
```

## Связи между таблицами

- `nodes.project_id` → `projects.id` (ON DELETE CASCADE)
- `nodes.entry_id` → `entries.id` (ON DELETE CASCADE)
- `weekly_goals.project_id` → `projects.id` (ON DELETE CASCADE)

## Индексы

Созданы индексы для оптимизации запросов:
- `idx_nodes_project_id` на `nodes(project_id)`
- `idx_nodes_entry_id` на `nodes(entry_id)`
- `idx_weekly_goals_project_id` на `weekly_goals(project_id)`
- `idx_weekly_report_mv_project_year_week` на `weekly_report_mv(project_id, report_year, report_week)`