Раздел 1: Архитектура

---
# Системные метаданные (совместимо с Knowledge)
source: consultant_plus
category: consumer_rights
access_level: manager
brand_id: shared
indexed_at: 2026-01-20T10:30:00Z

# Специфичные метаданные Lex
document_type: federal_law
document_number: "ФЗ-2300-1"
document_date: 2025-12-15
effective_date: 2026-03-01
relevance: high
original_url: "https://www.consultant.ru/document/..."
---

## Резюме

**Название:** О защите прав потребителей (в редакции от 15.12.2025)
**Суть:** Новые правила возврата товаров, купленных дистанционным способом
**На кого распространяется:** Продавцы, маркетплейсы, покупатели
**Срок вступления в силу:** 01.03.2026
**Ключевые положения:**
- Срок возврата увеличен до 30 дней для товаров, купленных на маркетплейсах
- Маркетплейс несёт солидарную ответственность с продавцом
- Новые требования к информированию покупателя

**Влияние на бизнес:** Высокое. Необходимо обновить политику возврата и информационные материалы.

---

## Полный текст

[Полный текст документа]

# Проверка доступа к Lex
ALLOWED_ROLES = ["manager", "senior", "director", "admin"]

# Функции с ограниченным доступом
SENIOR_PLUS_FUNCTIONS = [
    "manual_upload",
    "delete_document"
]

ADMIN_ONLY_FUNCTIONS = [
    "edit_keywords",
    "edit_relevance_threshold",
    "manage_sources"
]

def check_lex_access(user: User, function: str) -> bool:
    if user.role not in ALLOWED_ROLES:
        return False
    
    if function in ADMIN_ONLY_FUNCTIONS:
        return user.role == "admin"
    
    if function in SENIOR_PLUS_FUNCTIONS:
        return user.role in ["senior", "director", "admin"]
    
    return True

GET /api/v1/lex/alerts?status=unread&category=marking&limit=10
Authorization: Bearer {token}

Response 200:
{
  "alerts": [
    {
      "id": 456,
      "document_id": 123,
      "type": "new_law",
      "title": "ФЗ о маркировке товаров лёгкой промышленности",
      "category": "marking",
      "relevance": "high",
      "effective_date": "2026-03-01",
      "summary": "Новые требования к маркировке...",
      "created_at": "2026-01-20T08:00:00Z",
      "status": "unread"
    }
  ],
  "total": 1,
  "unread_count": 1
}

POST /api/v1/lex/upload
Authorization: Bearer {token}
Content-Type: multipart/form-data

file: [PDF/DOCX file]
# или
url: "https://www.consultant.ru/document/..."

Response 200:
{
  "success": true,
  "document_id": 124,
  "relevance_score": 0.85,
  "category": "consumer_rights",
  "relevance_level": "high",
  "summary": "..."
}

Response 400:
{
  "success": false,
  "reason": "low_relevance",
  "relevance_score": 0.42,
  "threshold": 0.60
}

# Database
DATABASE_URL=postgresql://adolf:password@postgres:5432/adolf

# Redis (shared with Watcher)
REDIS_URL=redis://redis:6379/0

# AI
TIMEWEB_AI_URL=https://api.timeweb.cloud/ai/v1
TIMEWEB_AI_KEY=xxx

# Lex settings
LEX_RELEVANCE_THRESHOLD=0.60
LEX_TASK_QUEUE=task_queue:lex
LEX_BATCH_SIZE=50

# Knowledge Base
TIMEWEB_KB_URL=https://api.timeweb.cloud/kb/v1
TIMEWEB_KB_ID=xxx

-- lex_settings
INSERT INTO lex_settings (key, value, description) VALUES
('relevance_threshold', '0.60', 'Минимальный порог релевантности (0-1)'),
('max_documents_per_day', '100', 'Максимум документов в день'),
('alert_on_high_relevance', 'true', 'Алерт только для высокой релевантности'),
('enabled_categories', '["trade","marking","consumer_rights","advertising","tax","labor","personal_data"]', 'Активные категории'),
('parse_full_text', 'true', 'Сохранять полный текст документа');

INSERT INTO lex_keywords (category, keywords, weight) VALUES
('trade', '["маркетплейс","дистанционная торговля","интернет-магазин","розничная торговля","оптовая торговля","электронная коммерция"]', 1.0),
('marking', '["маркировка товаров","Честный ЗНАК","товары лёгкой промышленности","одежда","текстиль","обувь"]', 1.2),
('consumer_rights', '["возврат товара","защита прав потребителей","гарантия","претензия","недостаток товара"]', 1.1),
('advertising', '["реклама в интернете","таргетированная реклама","маркетинг","рекламная деятельность"]', 0.9),
('tax', '["НДС","УСН","налог на прибыль","самозанятые","индивидуальный предприниматель"]', 1.0),
('labor', '["трудовой договор","удалённая работа","дистанционная работа","ГПХ","гражданско-правовой договор"]', 0.8),
('personal_data', '["персональные данные","обработка ПДн","согласие на обработку","оператор ПДн"]', 0.9),
('platforms', '["Wildberries","Ozon","Яндекс.Маркет","Яндекс Маркет"]', 1.5);

Watcher tasks (цены) > Lex tasks (документы)

/app/modules/lex/
├── __init__.py
├── api/
│   ├── __init__.py
│   ├── router.py              # FastAPI роутер
│   ├── schemas.py             # Pydantic модели
│   └── dependencies.py        # Зависимости
├── services/
│   ├── __init__.py
│   ├── task_generator.py      # Генерация задач парсинга
│   ├── ai_filter.py           # Фильтрация по релевантности
│   ├── ai_classifier.py       # Классификация документов
│   ├── ai_summarizer.py       # Генерация резюме
│   ├── document_formatter.py  # Формирование Markdown
│   ├── alert_engine.py        # Генерация алертов
│   ├── upload_handler.py      # Ручная загрузка
│   └── statistics.py          # Статистика
├── adapters/
│   ├── __init__.py
│   ├── consultant_plus.py     # Адаптер КонсультантПлюс
│   └── garant.py              # Адаптер Гарант
├── models/
│   ├── __init__.py
│   ├── document.py            # SQLAlchemy модели
│   ├── alert.py
│   ├── keyword.py
│   └── settings.py
├── tasks/
│   ├── __init__.py
│   ├── generate_tasks.py      # Celery задача генерации
│   ├── process_results.py     # Обработка результатов
│   └── maintenance.py         # Очистка, статистика
├── prompts/
│   ├── __init__.py
│   ├── filter_prompt.py       # Промпт фильтрации
│   ├── classifier_prompt.py   # Промпт классификации
│   └── summarizer_prompt.py   # Промпт резюмирования
└── utils/
    ├── __init__.py
    ├── text_extractor.py      # Извлечение текста
    └── validators.py          # Валидация