diff --git a/.gitignore b/.gitignore
index 9fed8a4..11fd061 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,4 +2,32 @@ tmp
 logs
 .idea
 files
-archive/*
\ No newline at end of file
+archive/*
+
+# Зависимости Composer без локальных изменений не храним в Git.
+/vendor/*
+!/vendor/browser_detection/
+!/vendor/dbf/
+!/vendor/sms/
+!/vendor/cakephp/
+/vendor/cakephp/*
+!/vendor/cakephp/cakephp/
+!/vendor/composer/
+/vendor/composer/*
+!/vendor/composer/composer/
+!/vendor/dompdf/
+/vendor/dompdf/*
+!/vendor/dompdf/dompdf/
+!/vendor/m1/
+/vendor/m1/*
+!/vendor/m1/env/
+!/vendor/parsecsv/
+/vendor/parsecsv/*
+!/vendor/parsecsv/php-parsecsv/
+!/vendor/squizlabs/
+/vendor/squizlabs/*
+!/vendor/squizlabs/php_codesniffer/
+!/vendor/symfony/
+/vendor/symfony/*
+!/vendor/symfony/debug/
+!/vendor/empty
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..40040e7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# Зависимости приложения
+
+Версии зависимостей зафиксированы в `composer.lock`. Пакеты, совпавшие с
+официальными архивами этих версий, и создаваемые Composer служебные файлы
+исключены из Git.
+
+В `vendor` сохранены ручные DBF/SMS/BrowserDetection-библиотеки, пакеты с
+локальными отличиями и пакеты без подтверждённого эталона. В том числе
+сохраняются правки CakePHP и дополнительные шрифты Dompdf. Состав каталогов
+задан исключениями в `.gitignore`.
+
+Перед восстановлением зависимостей нужно сохранить отслеживаемую часть
+`vendor` в отдельную копию. После восстановления пакетов по `composer.lock`
+в изолированном окружении сохранённые файлы возвращаются поверх пакетов.
+Это сохраняет существующие правки и шрифты; слепая переустановка может их
+перезаписать. Восстановление и проверка работы приложения выполняются отдельно.