From 4e0cc0b2ba1974c403bbc60e420f80a313221bbf Mon Sep 17 00:00:00 2001
From: apuc <apuc@git.itguild.info>
Date: Tue, 29 Sep 2026 12:47:25 +0300
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5?=
 =?UTF-8?q?=D0=BD=20README=20=D1=81=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD?=
 =?UTF-8?q?=D0=B8=D0=B5=D0=BC=20=D0=B8=20=D0=B8=D0=BD=D1=81=D1=82=D1=80?=
 =?UTF-8?q?=D1=83=D0=BA=D1=86=D0=B8=D0=B5=D0=B9=20=D0=BF=D0=BE=20=D0=BF?=
 =?UTF-8?q?=D0=B5=D1=87=D0=B0=D1=82=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 62 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5f92ce1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,62 @@
+# Органайзер для кошачьего корма (3D-модель)
+
+Органайзер для хранения влажного кошачьего корма. Дизайн по мотивам
+`cat_organaizer_a1_veroi.3mf`: высокая коробка + крышка из двух частей
+(верх с кошачьими ушками + низ с защёлками).
+
+## Содержимое
+
+| Файл | Описание |
+|---|---|
+| `box.stl` | Коробка **без боковой конструкции** (для печати) |
+| `lid_top.stl` | Крышка-верх с кошачьими ушками |
+| `lid_bottom.stl` | Крышка-низ с 4 защёлками |
+| `cat_organaizer_a1_veroi.3mf` | Оригинальный дизайн (исходник) |
+| `view_original.glb` / `view_edited.glb` | Собранные модели для просмотра |
+| `preview_original.html` | Просмотрщик: оригинал |
+| `preview_edited.html` | Просмотрщик: без боковой конструкции |
+| `preview.html` | Просмотрщик с переключателем версий |
+| `generate_box.py` | Параметрический генератор (Python) |
+| `vendor/` | Локальные файлы Three.js (просмотрщик работает без интернета) |
+
+## Просмотр модели
+
+Открой `preview_original.html` или `preview_edited.html` в браузере
+(модель встроена в HTML, интернет не нужен). Управление:
+ЛКМ — вращение, колесо — масштаб, ПКМ — сдвиг.
+
+Для просмотра с других устройств в локальной сети:
+
+```bash
+cd <папка проекта>
+python3 -m http.server 8000 --bind 0.0.0.0
+# затем открыть http://<IP-компьютера>:8000/preview_original.html
+```
+
+## Печать
+
+- **Коробка** (`box.stl`): печатать вертикально, дном вниз
+- **Крышка-верх** (`lid_top.stl`): пластиной вниз, ушки вверх
+- **Крышка-низ** (`lid_bottom.stl`): защёлками вверх
+- Рекомендации: слой 0.2 мм, сопло 0.4 мм, заполнение 20–30%,
+  материал PETG или PLA
+- Сборка: крышка-низ вставляется в отверстие коробки, её защёлки
+  входят в отверстия крышки-верха
+
+## Размеры
+
+- Коробка: 131.5 × 156.2 × 200 мм
+- Крышка-верх: 105 × 155 × 24 мм
+- Крышка-низ: 100.2 × 150.2 × 9 мм
+- Толщина стенок: ~3–4 мм, дно сплошное
+
+## Генератор
+
+`generate_box.py` строит модель параметрически (размеры пакета,
+количество, сегментация для печати). Запуск:
+
+```bash
+python3 generate_box.py
+```
+
+Требуются: `trimesh`, `numpy`, `shapely`, `manifold3d`, `matplotlib`.
\ No newline at end of file