# Data Dictionary / Словарь данных

## Описание полей датасета

### 1. `docId`
- **Тип**: String (UUID)
- **Описание**: Уникальный идентификатор документа в формате UUID
- **Пример**: `0009fdfc-f2c8-4ab7-9562-9e5da0e9f102`
- **Обязательное**: Да

### 2. `Violation_Type`
- **Тип**: String (категориальное)
- **Описание**: Тип нарушения рекламного законодательства
- **Возможные значения**:
  - `substance` - нарушения, связанные с содержанием рекламы (недостоверная, неэтичная реклама и т.д.)
  - `placement` - нарушения правил размещения рекламы (место, время, способ распространения)
- **Обязательное**: Да

### 3. `document_date`
- **Тип**: Date (YYYY-MM-DD)
- **Описание**: Дата принятия решения ФАС
- **Формат**: ISO 8601 (YYYY-MM-DD)
- **Пример**: `2021-09-07`
- **Обязательное**: Да

### 4. `FASbd_link`
- **Тип**: URL
- **Описание**: Прямая ссылка на решение в официальной базе данных ФАС России
- **Пример**: `https://br.fas.gov.ru/cases/4d3ec9bc-68ec-40c8-8187-4c5d47909382/`
- **Обязательное**: Да

### 5. `FAS_division`
- **Тип**: String
- **Описание**: Территориальное подразделение ФАС, рассмотревшее дело
- **Примеры**: 
  - `Московское УФАС`
  - `Санкт-Петербургское УФАС`
  - `ФАС России` (центральный аппарат)
- **Обязательное**: Да

### 6. `violation_found`
- **Тип**: String
- **Описание**: Установлен ли факт нарушения
- **Возможные значения**:
  - `да` - нарушение установлено
  - `нет` - нарушение не установлено
- **Обязательное**: Да

### 7. `defendant_name`
- **Тип**: String
- **Описание**: Наименование лица, привлекаемого к административной ответственности (рекламодатель или рекламораспространитель)
- **Примеры**: `ООО "КТЛ"`, `ИП Иванов И.И.`
- **Обязательное**: Да

### 8. `defendant_industry`
- **Тип**: String
- **Описание**: Отрасль/сфера деятельности лица, привлекаемого к административной ответственности 
- **Примеры**:
  - `Розничная торговля`
  - `Финансовые услуги`
  - `Медицинские услуги`
- **Обязательное**: Да

### 9. `ad_description`
- **Тип**: Text
- **Описание**: Подробное описание рекламного материала, включая формат, визуальные элементы, контекст размещения
- **Пример**: `Реклама услуг комиссионного магазина, который принимает под залог и покупает бывшую в употреблении технику...`
- **Обязательное**: Да

### 10. `ad_content_cited`
- **Тип**: Text
- **Описание**: Прямая цитата текста из рекламы, которая стала предметом рассмотрения
- **Пример**: `"Срочный выкуп техники по максимальной цене в городе!"`
- **Обязательное**: Нет (может отсутствовать для визуальной рекламы)

### 11. `ad_platform`
- **Тип**: String
- **Описание**: Платформа или канал распространения рекламы
- **Примеры**:
  - `Наружная реклама`
  - `Интернет-сайт`
  - `Телевидение`
- **Обязательное**: Да

### 12. `violation_summary`
- **Тип**: Text
- **Описание**: Краткое изложение сути нарушения
- **Пример**: `Использование превосходной степени без указания конкретного критерия сравнения`
- **Обязательное**: Да

### 13. `FAS_arguments`
- **Тип**: Text
- **Описание**: Подробная аргументация ФАС, включая:
  - Анализ рекламных материалов
  - Ссылки на экспертные заключения
  - Толкование норм закона
  - Оценку представленных доказательств
- **Обязательное**: Да

### 14. `legal_provisions`
- **Тип**: String (список)
- **Описание**: Нарушенные нормы Федерального закона "О рекламе"
- **Формат**: Разделенные запятыми статьи и части
- **Примеры**:
  - `ч. 1 ст. 5` - недостоверная реклама
  - `ч. 2 ст. 5` - недобросовестная реклама
  - `ст. 21` - реклама алкоголя
  - `ст. 24` - реклама лекарств
- **Обязательное**: Да

### 15. `thematic_tags`
- **Тип**: String (список)
- **Описание**: Тематические теги для категоризации кейсов
- **Примеры тегов**:
  - `некорректные сравнения`
  - `БАД_дисклеймер`
  - `запрет_умолчаний`
- **Формат**: Разделенные запятыми теги
- **Обязательное**: Нет

## Особенности данных

### Обработка пропущенных значений
- Пустые значения могут встречаться в полях `ad_content_cited` и `thematic_tags`
- Все остальные поля являются обязательными

### Кодировка
- UTF-8 для всех текстовых полей
- Разделитель в CSV: `;` (точка с запятой)

### Временной охват
- Данные охватывают период с 2019 по 2025 год

### Региональное распределение
- Представлены все федеральные округа России
- Около 30% кейсов - решения центрального аппарата ФАС
- 70% - решения территориальных управлений

## Примечания по использованию

1. **Для юридического анализа**: Поле `legal_provisions` позволяет быстро фильтровать кейсы по конкретным статьям закона

2. **Для ML-моделей**: Комбинация полей `ad_description` + `ad_content_cited` дает полное представление о рекламном материале

3. **Для статистики**: Поля `defendant_industry` и `ad_platform` позволяют анализировать отраслевые тренды

4. **Временной анализ**: Поле `document_date` в формате ISO позволяет легко проводить временной анализ и выявлять тренды активности регулятора
