From 1635eed33bad513aba0b0a19fd7a165ca3423106 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E2=80=9CNaeel=E2=80=9D?= <tazet@narod.ru>
Date: Wed, 26 Aug 2026 16:26:48 +0300
Subject: [PATCH] =?UTF-8?q?docs:=20=D0=BF=D0=BE=D0=B4=D1=80=D0=BE=D0=B1?=
 =?UTF-8?q?=D0=BD=D1=8B=D0=B9=20README=20+=20=D1=81=D1=81=D1=8B=D0=BB?=
 =?UTF-8?q?=D0=BA=D0=B0=20=D0=BD=D0=B0=20DOC/architecture-contracts-flask.?=
 =?UTF-8?q?md=20(=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8=D0=B5=20Sonnet?=
 =?UTF-8?q?)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 30 +++++++++++++++++++++++++++---
 1 file changed, 27 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index f80552d..880aaa0 100644
--- a/README.md
+++ b/README.md
@@ -7,13 +7,37 @@
 Разбирать спецификации договоров и допников (docx/pdf) в структурированный вид,
 отслеживать изменения между версиями, восстанавливать историю договора во времени.
 
-## Состав
+## Архитектура
+
+Подробное описание архитектуры (компоненты, БД, event sourcing, загрузка через
+ВМ-буфер, ZIP, конвейер сравнения) — см. **[`DOC/architecture-contracts-flask.md`](DOC/architecture-contracts-flask.md)**.
+
+Ключевые моменты:
+
+- **Основной сервис** — `contracts-flask/` (Flask + SQLite WAL, managed на Nubes).
+- **Загрузка** — браузер PUT файла в ВМ-буфер (WebDAV), бэк сам тянет с ВМ
+  (managed-gateway рвёт тела > 64 КБ, egress ВМ без лимита).
+- **ZIP** — раскрывается на клиенте (`expandZipClient` → `listZipFiles`).
+- **Event sourcing** — `spec_events` (журнал) + `spec_current` (текущее состояние).
+- **Сравнение** — `/process-v2` (SSE): LLM возвращает ops (ADD/UPDATE/DELETE/
+  UNRESOLVED), применяются через `apply_ops()`.
+- **LLM** — только своя модель `gpt-oss-120b` (api.aillm.ru).
+
+## Состав репозитория
 
 | Папка | Что |
 |---|---|
-| `contracts-app/` | Flask-сервис (основной код) |
+| `contracts-flask/` | Основной сервис (Flask + SQLite, managed на Nubes) |
+| `contractor-legacy/` | Старый Lucee/CFML-сервис (архив) |
+| `convert-service/` | Микросервис конвертации doc → docx |
+| `DOC/` | Документация: архитектура, тестирование |
+| `History/` | История решений, ревью, протоколы |
+| `FILES/` | Заметки, ключи LLM, ТЗ |
 | `dogovora/` | Примеры договоров и допников |
-| `FILES/` | Заметки, ключи LLM |
+| `loadtest/` | Нагрузочное тестирование |
+| `sim/` | Симуляция сценариев |
+| `testgen/` | Генерация тестовых кейсов |
+| `hz/` | Разные заметки |
 
 ## Конфиденциальность