# SLOT-H: Single Logical Operating Tool for Hosting

---

## Что это, чёрт возьми, такое?

SLOT-H - это не фреймворк. Если вы пришли сюда за очередным "пайп-лайн-сервис-контейнер-инъекцией", то вы ошиблись дверью.

Это **боевая экосистема**, которая родилась из 25 лет боли, 15 лет непрерывного продакшена и сотен проектов, которые нужно было поддерживать.

Она делает одну вещь и делает её хорошо: **позволяет одному коду работать на множестве проектов одновременно**.

Пишете код один раз. SLOT-H разворачивает его на десятках сайтов. Одна база данных. Одна логика. Одна точка входа.

Без микросервисов. Без контейнеризации. Без головной боли, которая обычно идёт в комплекте.

---

## 100% российская разработка

Это не просто слова. Это факт, который отличает SLOT-H от 99% проектов на GitHub.

**Весь код SLOT-H написан с нуля в России. С 2011 года.**

В репозитории нет:

- Ни одного стороннего пакета через Composer
- Ни одной библиотеки, написанной за пределами России
- Ни одного коммита от иностранного разработчика
- Ни одной зависимости, которую нужно устанавливать отдельно

**Исключения:**

1. **jQuery 1.12.4** - единственная сторонняя библиотека, которая используется в ядре. Она вшита в код и не требует отдельной установки.

2. **В полной версии** допускается подключение плагинов, работающих поверх jQuery (автокомплит, chosen, datetimepicker и т.п.). Они подключаются по желанию и только для решения конкретных задач на фронтенде.

**Никакого Composer. Никаких vendor-папок на сотни мегабайт. Никакого "а давайте подтянем ещё одну зависимость, потому что так удобно".**

Каждая строчка кода в ядре SLOT-H написана вручную, осознанно и с пониманием того, зачем это нужно. Это не "собрал из готовых компонентов". Это "спроектировал, написал, отладил и 15 лет поддерживаю".

**Это не патриотизм. Это прагматизм.**

Когда ты используешь чужую библиотеку, ты берёшь на себя обязательство:

- Следить за её обновлениями
- Искать замену, если автор перестал поддерживать
- Разбираться в чужом коде, когда что-то идёт не так
- Тащить зависимости, которые тянут свои зависимости

SLOT-H этих проблем не знает. Всё, что есть в ядре, написано здесь и сейчас под конкретные задачи. Если что-то ломается - чинится здесь же. Если нужно что-то добавить - добавляется без оглядки на совместимость с десятком внешних пакетов.

---

## Философия: «Соглашение важнее правил»

Вот здесь многие начинают нервно дёргаться, потому что привыкли к "правильному" и "неправильному". Забудьте.

В SLOT-H есть простая идея:

> **Ядро знает, как правильно. Ты просто описываешь логику.**

Что это значит на практике:

**1. Ты работаешь в модулях.** Вся твоя бизнес-логика сидит в контроллерах, моделях и представлениях. Ты не думаешь о роутинге, автозагрузке или защите от CSRF - ядро уже сделало это за тебя. Потому что оно делало это 15 лет и знает, что делает.

**2. Ядро само решает, как правильно.** Ты не настраиваешь роуты, не правишь .htaccess под каждый чих. Ты просто кладёшь файл туда, где он должен лежать, и даёшь ему правильное имя. Всё остальное ядро найдёт само.

**3. Соглашения - это не скучно, это быстро.** Хочешь новую страницу? Создай метод в контроллере и phtml-файл с таким же именем. Всё. Не нужно лезть в конфиги, не нужно регистрировать роуты. Система знает, где искать. Выработай привычку, и ты перестанешь замечать, как быстро летит время.

**4. Кода должно быть ровно столько, сколько нужно, и ни строчкой больше.** Не пишите лишнего. В SLOT-H это не поощряется.

---

## Откуда это взялось?

2011 год. Автор сидит с десятым проектом, который полностью повторяет девятый, но написан по-другому, потому что в девятом он сделал одну ошибку, а в десятом уже другую. Один баг - десять правок. Одно обновление - десять часов работы. Это не разработка, это каторга.

Первая версия SLOT-H была тупым набором скриптов, которые унифицировали хотя бы базу данных. С тех пор система выросла, как домашний питомец, которого перекормили:

- **2015** - уже не скрипты, а целая экосистема
- **2020** - десятки проектов в продакшене
- **2026** - 15 лет эволюции

За это время система пережила:

- Переход с MySQL на поддержку PostgreSQL и MongoDB (потому что клиенты любят разнообразие)
- Рефакторинг ORM в сторону прозрачности (потому что магия хороша только в книгах)
- Адаптацию под PHP 8.x (потому что 7.x больше не обновляют)
- Открытие демо-версии (потому что скрывать хороший код - грех)

И тысячи других изменений, больших и маленьких.

---

## Чем SLOT-H не является (и почему это хорошо)

**Это не фреймворк.** Фреймворк - это как швейцарский нож: вроде всё есть, но чтобы открыть пиво, нужно прочитать инструкцию. SLOT-H - это как простая отвертка: всегда под рукой, всегда работает и не требует инструкции.

**Это не учебный проект.** Тот код, который ты видишь, кормит семью автора. Уже 15 лет. Это не игрушка для портфолио. Это боевой инструмент.

**Это не попытка быть лучше Laravel или Symfony.** Это просто другой подход. Он может тебе подойти, а может и нет. Автору подошёл - и он кормит этим свою семью уже 15 лет.

---

## Кому это вообще нужно?

**Архитекторы**  
Увидят, как можно строить мультипроектные системы без микросервисов и прочей модной ерунды.

**Разработчики, которые устали от магии**  
Найдут прагматичные решения, которые работают годами. Без хайпа. Без переписывания каждые полгода.

**Владельцы проектов**  
Поймут, как сократить затраты на поддержку, не теряя в качестве.

**Студенты и новички**  
Увидят реальный код, а не учебные примеры. Настоящий продакшен с 15-летней историей.

---

## Что внутри (кратко)

- **Модульность.** Контроллеры, модели, представления. Всё по полочкам.
- **Мультипроектность.** Один код - десятки проектов. project_id правит миром.
- **Локализация.** Автоматический перевод через очереди. Без боли.
- **ORM без магии.** MySQL, PostgreSQL, MongoDB. Честные JOIN, понятные WHERE.
- **Безопасность.** Динамическая подпись форм. Меняется каждые 30 секунд. Подделать - не получится.
- **Работает везде.** Apache/Nginx, PHP 7.x-8.x, MySQL 8. Минимум требований.

---

## Лицензия

**MIT.** Бесплатно. Для любых целей.

- **Статус:** боевой, работает в продакшене
- **Возраст:** 15 лет непрерывной эволюции
- **Автор:** 25 лет опыта и всё ещё не выгорел

---

## Что дальше?

- ➡️ [Раздел 02. Требования к серверу](/docs/02-requirements)
- ➡️ [Раздел 03. Быстрый старт](/docs/03-quick-start)
- ➡️ [Раздел 04. Философия](/docs/04-philosophy)
