diff --git a/LESSONS_LEARNED.md b/LESSONS_LEARNED.md
new file mode 100644
index 0000000..3dab42c
--- /dev/null
+++ b/LESSONS_LEARNED.md
@@ -0,0 +1,12 @@
+# 🧠 Уроки проекта LKM37 (Матрица ошибок)
+
+## 🔴 КРИТИЧЕСКИЕ ОШИБКИ
+1. **LOCAL PROXY**: Никогда не использовать прокси для 192.168.10.x. Это блокирует Gitea и Web-Admin.
+2. **SYSTEMD PATH**: В юнитах всегда прописывать Environment="PATH=...:/usr/bin:/bin", иначе git и системные утилиты не работают.
+3. **FILE TRUNCATION**: Никогда не использовать "..." в write_file. Это убивает код.
+4. **CURL TESTING**: Рапорт "всё ок" возможен ТОЛЬКО после curl-проверки всех 14+ роутов.
+
+## 🟢 ПРАВИЛЬНЫЕ РЕШЕНИЯ
+1. **Artifact Manager**: Хранение file_id в базе (таблица artifacts) для мгновенных рассылок.
+2. **Dual Attachments**: Поддержка фото + документ в одном посте через MediaGroup.
+3. **Infrastructure Map**: Хранение паролей и правил прокси в одном месте (/infra).
diff --git a/VERSIONS.md b/VERSIONS.md
index 4082554..26d4c70 100644
--- a/VERSIONS.md
+++ b/VERSIONS.md
@@ -29,7 +29,7 @@
 
 ---
 
-## 📋 Текущая версия: v1.0 MVP
+## 📋 Текущая версия: v4.8 REBORN
 
 **Дата фиксации:** 26 февраля 2026 г.
 **Статус:** ✅ Готов к эксплуатации