# 📋 ЛОГИКА ДАТ И ЧЕКБОКСОВ - ПОЛНОЕ РУКОВОДСТВО

**Версия**: v4.1.17  
**Дата**: 2026-01-14  
**Обновление**: Исправлены права доступа (см. ACCESS_RIGHTS.md)

---

## ⚠️ **ВАЖНО: ПРАВА ДОСТУПА**

**Детальная информация о правах доступа находится в файле:**
📄 **[ACCESS_RIGHTS.md](./ACCESS_RIGHTS.md)**

**Краткая сводка:**
- **Admin**: полный доступ (календари + toggle)
- **User**: подтверждение MAT-1/MAT-2 + toggle всех полей
- **Guest**: только просмотр

---

## 🔄 **TÖÖLEHTI (WORKSHEETS) - 3-ШАГОВЫЙ ЦИКЛ**

### **Как работает:**

#### **ШАГ 1: Пусто → Серый фон с датой**
- **Состояние**: Пустая ячейка `-`
- **Действие**: Клик по ячейке
- **Результат**: 
  - Появляется **текущая дата**
  - Фон **СЕРЫЙ** (не подтверждено)
  - `worksheets_date` = TODAY
  - `worksheets_confirmed` = 0

#### **ШАГ 2: Серый → Зеленый фон (подтверждение)**
- **Состояние**: Дата с серым фоном
- **Действие**: Клик по ячейке
- **Результат**:
  - Дата **остается**
  - Фон становится **ЗЕЛЕНЫЙ** (подтверждено)
  - `worksheets_date` = **сохраняется**
  - `worksheets_confirmed` = 1

#### **ШАГ 3: Зеленый → Пусто (сброс)**
- **Состояние**: Дата с зеленым фоном
- **Действие**: Клик по ячейке
- **Результат**:
  - Дата **удаляется**
  - Ячейка становится **пустой** `-`
  - `worksheets_date` = NULL
  - `worksheets_confirmed` = 0

### **Визуальная схема:**
```
┌─────────────┐         ┌──────────────────┐         ┌──────────────────┐         ┌─────────────┐
│   ПУСТО     │  Клик 1 │   СЕРЫЙ ФОН      │  Клик 2 │   ЗЕЛЕНЫЙ ФОН    │  Клик 3 │   ПУСТО     │
│     -       │ ──────> │  14.01.2026      │ ──────> │  14.01.2026      │ ──────> │     -       │
│             │         │ (не подтверждено)│         │  (подтверждено)  │         │             │
└─────────────┘         └──────────────────┘         └──────────────────┘         └─────────────┘
     ^                                                                                     │
     │                                                                                     │
     └─────────────────────────────────────────────────────────────────────────────────────┘
                                        Цикл повторяется
```

---

## 🟢 **MAT-1 (MATERIAL) - КАЛЕНДАРЬ + ПОДТВЕРЖДЕНИЕ**

### **Функционал:**
- **Календарь**: Клик по ячейке → открывается календарь
- **Выбор даты**: Выбрать дату → сохраняется `material_date`
- **Кнопка подтверждения** ✓: Клик → зеленая рамка
  - `material_confirmed` = 1
  - Ячейка с зеленой рамкой

### **Кто может изменять:**
- ✅ Admin
- ✅ Public User (все)

### **База данных:**
- `status_checkboxes.material_date` (TEXT)
- `status_checkboxes.material_confirmed` (INTEGER, 0 или 1)

---

## 🔒 **MAT-2 (MATERIAL2) - ЗАВИСИТ ОТ MAT-1**

### **Блокировка:**
- **Заблокировано**: Если MAT-1 пустая
- **Показывается**: 🔒 с подсказкой "MAT-1 peab olema täidetud"
- **Разблокировано**: Когда MAT-1 заполнена

### **Функционал (когда разблокирована):**
- **Календарь**: Клик → открывается календарь
- **Выбор даты**: Выбрать дату → сохраняется `material2_date`
- **Кнопка подтверждения** ✓: Клик → зеленая рамка
  - `material2_confirmed` = 1

### **Кто может изменять:**
- ✅ Admin
- ✅ Public User (если MAT-1 заполнена)

### **База данных:**
- `status_checkboxes.material2_date` (TEXT)
- `status_checkboxes.material2_confirmed` (INTEGER, 0 или 1)

---

## 📦 **PAKETT (PACKAGE) - КАЛЕНДАРЬ**

### **Функционал:**
- **Календарь**: Клик → открывается календарь
- **Выбор даты**: Выбрать дату → сохраняется `package_date`
- **Нет подтверждения**: Только дата (без кнопки ✓)

### **Кто может изменять:**
- ✅ Admin
- ✅ Public User (все)

### **База данных:**
- `status_checkboxes.package_date` (TEXT)

---

## 🔴 **LÕIKUS (CUTTING) - ТОЛЬКО ADMIN**

### **Функционал:**
- **Toggle**: Клик → дата появляется/исчезает
- **Автоматическая дата**: Устанавливается на **сегодня**
- **Ошибка-флаг** 🚫: `cutting_error`
  - Если установлена → красная метка
  - Блокирует **VALMIS** и **VÄLJAS**

### **Кто может изменять:**
- 🔴 **ТОЛЬКО Admin**

### **База данных:**
- `status_checkboxes.cutting_date` (TEXT)
- `status_checkboxes.cutting_error` (INTEGER, 0 или 1)

---

## 🔴 **KLAAS (GLAZING) - ТОЛЬКО ADMIN**

### **Функционал:**
- **Toggle**: Клик → дата появляется/исчезает
- **Автоматическая дата**: Устанавливается на **сегодня**
- **Ошибка-флаг** 🚫: `glazing_error`
  - Если установлена → красная метка
  - Блокирует **VALMIS** и **VÄLJAS**

### **Кто может изменять:**
- 🔴 **ТОЛЬКО Admin**

### **База данных:**
- `status_checkboxes.glazing_date` (TEXT)
- `status_checkboxes.glazing_error` (INTEGER, 0 или 1)

---

## 🔒 **VALMIS (READY) - Admin/User Toggle + БЛОКИРОВКА ТОЛЬКО ПО ERROR ФЛАГАМ**

### **ВАЖНО: ТЕКСТ ПРОБЛЕМЫ НЕ БЛОКИРУЕТ!**
Текст в поле "Probleemid" (серая метка ⚠️) **НЕ** блокирует VALMIS!

### **Блокировка:**
Поле **ЗАБЛОКИРОВАНО ТОЛЬКО**, если установлен **ЛЮБОЙ error флаг** (красная галочка ✗):
   - `worksheets_error = 1`
   - `cutting_error = 1`
   - `glazing_error = 1`
   - `ready_error = 1`
   - `issued_error = 1`

**НЕ блокируется**, если:
- Есть только текст в `production_records.problems` (серая метка ⚠️)
- Все error флаги = 0

### **Визуальное отображение:**
- **Заблокировано**: 🔒 + сообщение "Vigade märked on seatud (punased kolmnurgad)"
- **Разблокировано**: Toggle как обычно

### **Функционал (когда разблокирована):**
- **Toggle**: Клик → дата появляется/исчезает
- **Автоматическая дата**: Устанавливается на **сегодня**

### **Кто может изменять:**
- ✅ **Admin + User** (изменено в v4.1.18)

### **База данных:**
- `status_checkboxes.ready_date` (TEXT)
- `status_checkboxes.ready_error` (INTEGER, 0 или 1)

---

## 🔒 **VÄLJAS (ISSUED) - Admin/User Toggle + БЛОКИРОВКА ТОЛЬКО ПО ERROR ФЛАГАМ**

### **ВАЖНО: ТЕКСТ ПРОБЛЕМЫ НЕ БЛОКИРУЕТ!**
Текст в поле "Probleemid" (серая метка ⚠️) **НЕ** блокирует VÄLJAS!

### **Блокировка:**
**ТА ЖЕ ЛОГИКА** что и **VALMIS**:
- Блокируется **ТОЛЬКО** если установлен **ЛЮБОЙ error флаг** (красная галочка ✗)
- **НЕ** блокируется если есть только текст в `production_records.problems`

### **Функционал (когда разблокирована):**
- **Toggle**: Клик → дата появляется/исчезает
- **Автоматическая дата**: Устанавливается на **сегодня**

### **Кто может изменять:**
- ✅ **Admin + User** (изменено в v4.1.18)

### **Кто может изменять:**
- 🔴 **ТОЛЬКО Admin**

### **База данных:**
- `status_checkboxes.issued_date` (TEXT)
- `status_checkboxes.issued_error` (INTEGER, 0 или 1)

---

## 📊 **СВОДНАЯ ТАБЛИЦА**

| Поле | Тип | Доступ | Логика | Подтверждение | Блокировка |
|------|-----|--------|--------|---------------|-----------|
| **MAT-1** | Календарь | Все | Календарь | ✓ Да | Нет |
| **MAT-2** | Календарь | Все | Календарь | ✓ Да | Если MAT-1 пуста |
| **PAKETT** | Календарь | Все | Календарь | Нет | Нет |
| **Töölehti** | 3-цикл | Admin | Серый→Зеленый→Пусто | Да | Нет |
| **LÕIKUS** | Toggle | Admin | Появляется/Исчезает | Нет | Нет |
| **KLAAS** | Toggle | Admin | Появляется/Исчезает | Нет | Нет |
| **VALMIS** | Toggle | Admin/User | Появляется/Исчезает | Нет | ТОЛЬКО если error флаги (НЕ текст проблемы) |
| **VÄLJAS** | Toggle | Admin/User | Появляется/Исчезает | Нет | ТОЛЬКО если error флаги (НЕ текст проблемы) |

---

## 🔐 **ПРАВА ДОСТУПА**

### **Admin** (admin, aknaproff):
- ✅ Все поля (MAT-1, MAT-2, PAKETT, Töölehti, LÕIKUS, KLAAS, VALMIS, VÄLJAS)
- ✅ Добавление записей
- ✅ Редактирование записей
- ✅ Удаление записей
- ✅ Изменение проблем и ошибок

### **Public User** (kasutaja):
- ✅ MAT-1 (календарь + подтверждение)
- ✅ MAT-2 (календарь + подтверждение, если MAT-1 заполнена)
- ✅ PAKETT (календарь)
- ❌ Töölehti, LÕIKUS, KLAAS, VALMIS, VÄLJAS (только просмотр)
- ❌ Добавление/редактирование/удаление записей

---

## 🎨 **ВИЗУАЛЬНЫЕ ИНДИКАТОРЫ**

### **Цвета:**
- 🟢 **Зеленая рамка**: MAT-1/MAT-2 подтверждены
- 🟢 **Зеленый фон**: Töölehti подтверждено (confirmed=1)
- ⬜ **Серый фон**: Töölehti не подтверждено (confirmed=0)
- 🔴 **Красная метка**: Ошибка-флаг установлен
- 🔒 **Замок**: Поле заблокировано

### **Подсказки:**
- **MAT-2 заблокирована**: "MAT-1 peab olema täidetud"
- **VALMIS/VÄLJAS заблокированы**: Текст проблемы из `production_records.problems`
- **Töölehti Шаг 1**: "Klõps 1: Lisa kuupäev"
- **Töölehti Шаг 2**: "Klõps 2: Kinnita"
- **Töölehti Шаг 3**: "Klõps 3: Tühjenda"

---

## 📝 **AUDIT LOG**

Каждое изменение даты записывается в таблицу `audit_log`:
```sql
INSERT INTO audit_log (user_id, record_id, field, old_value, new_value, action)
VALUES (?, ?, ?, ?, ?, 'toggle_status')
```

**Поля:**
- `user_id`: ID пользователя (1=admin, 2=aknaproff, 4=kasutaja)
- `record_id`: ID записи
- `field`: Название поля (worksheets, cutting, glazing, ready, issued)
- `old_value`: Старое значение даты
- `new_value`: Новое значение даты
- `action`: Тип действия ('toggle_status', 'worksheets_cycle')

---

## ✅ **ПРОВЕРКА**

### **Test Töölehti 3-цикл:**
```bash
# Шаг 1: Пусто → Серый
PATCH /api/records/2/worksheets-cycle
→ {"date": "2026-01-14", "confirmed": 0}

# Шаг 2: Серый → Зеленый
PATCH /api/records/2/worksheets-cycle
→ {"date": "2026-01-14", "confirmed": 1}

# Шаг 3: Зеленый → Пусто
PATCH /api/records/2/worksheets-cycle
→ {"date": null, "confirmed": 0}
```

### **Test блокировка MAT-2:**
```bash
# MAT-1 пустая → MAT-2 заблокирована
SELECT material_date FROM status_checkboxes WHERE record_id = 5
→ NULL
# UI показывает: 🔒 "MAT-1 peab olema täidetud"
```

### **Test блокировка VALMIS:**
```bash
# Есть проблемы → VALMIS заблокирована
SELECT problems FROM production_records WHERE id = 10
→ "Aken vajab parandust"
# UI показывает: 🔒 + текст проблемы
```

---

**Версия**: v4.1.16  
**Статус**: ✅ Работает корректно  
**Дата**: 2026-01-14

---

## 🔒 **ВАЖНО: ПРАВИЛО БЛОКИРОВКИ VALMIS/VÄLJAS**

### **Версия**: v4.1.19
### **Дата изменения**: 2026-01-14

**КРИТИЧЕСКИ ВАЖНО**: Блокировка VALMIS/VÄLJAS работает **ТОЛЬКО** по error флагам!

### **Блокируется**, если установлен **ЛЮБОЙ** из error флагов (красная галочка ✗):
- `worksheets_error = 1`
- `cutting_error = 1`
- `glazing_error = 1`
- `ready_error = 1`
- `issued_error = 1`

### **НЕ БЛОКИРУЕТСЯ**, если:
- Есть **ТОЛЬКО** текст в `production_records.problems` (серая метка ⚠️)
- Все error флаги = 0

### **Визуальные индикаторы:**
- **VALMIS/VÄLJAS заблокированы**: 🔒 + сообщение "Vigade märked on seatud (punased kolmnurgad)"
- **Серая метка с ⚠️**: Указывает на текст проблемы в поле "Probleemid", **НЕ блокирует** VALMIS/VÄLJAS

### **Код проверки блокировки** (backend):
```typescript
if (field === 'ready' || field === 'issued') {
  const statusCheckbox = await c.env.DB.prepare(
    'SELECT worksheets_error, cutting_error, glazing_error, ready_error, issued_error FROM status_checkboxes WHERE record_id = ?'
  ).bind(recordId).first()

  const hasErrorFlags = statusCheckbox && (
    statusCheckbox.worksheets_error || 
    statusCheckbox.cutting_error || 
    statusCheckbox.glazing_error || 
    statusCheckbox.ready_error || 
    statusCheckbox.issued_error
  )

  if (hasErrorFlags) {
    return c.json({ 
      error: 'blocked',
      message: 'Vigade märked on seatud (punased kolmnurgad)'
    }, 403)
  }
}
```

### **Тестирование** (результаты от 2026-01-14):
✅ **Test 1**: Только текст problems → НЕ блокируется → `{"success":true}`  
✅ **Test 2**: Установлен error flag → БЛОКИРУЕТСЯ → `{"error":"blocked","message":"..."}`

---