======================================================================
📘 TITLE: 📊 ГАЙД: ОЦИФРОВКА ТАБЛИЦ И СКАНОВ В ВАЛИДНЫЙ JSON В GEMINI 📊 | АВТОВЫДАЧА
📂 CATEGORY: Google Gemini
📄 FILENAME: gayd_otsifrovka_tablits_i_skanov_v_validnyy_json_v_gemini_avtovyd_guide.txt
======================================================================

📊 ГАЙД: СТРУКТУРИРОВАННОЕ ИЗВЛЕЧЕНИЕ ДАННЫХ (STRUCTURED OUTPUTS / JSON SCHEMA) В GEMINI 📊

🔹 ВВЕДЕНИЕ:
Gemini API нативно поддерживает параметр `response_schema`, гарантирующий, что модель вернет 100% валидный JSON, строго соответствующий заданной схеме без лишнего вступительного текста и markdown-разметки.

🔹 ШАГ 1: ПРИМЕР СТРОГОЙ ОЦИФРОВКИ ЧЕКОВ НА PYTHON (PYDANTIC)
```python
import google.generativeai as genai
from pydantic import BaseModel, Field
from typing import List

class ReceiptItem(BaseModel):
    name: str = Field(description="Наименование товара")
    qty: float = Field(description="Количество")
    price: float = Field(description="Цена за единицу")
    total: float = Field(description="Сумма позиции")

class Receipt(BaseModel):
    store_name: str
    date: str
    items: List[ReceiptItem]
    total_sum: float

model = genai.GenerativeModel(
    model_name="gemini-2.0-flash",
    generation_config={
        "response_mime_type": "application/json",
        "response_schema": Receipt,
    }
)

img = genai.upload_file("receipt_scan.jpg")
response = model.generate_content(["Извлеки данные чека", img])
print(response.text) # Выдает строгий JSON без markdown!
```

🔹 ШАГ 2: МАССОВАЯ ОБРАБОТКА В БАЗУ ДАННЫХ
Полученный структурированный JSON можно напрямую валидировать и сохранять в PostgreSQL через SQLAlchemy или отправлять в CRM без ручной проверки оператором.

💡 Если у вас возникнут любые вопросы по выполнению шагов из этого гайда — напишите в чат заказа, я с радостью подскажу!