Update knowledge base

.claude/development/patterns.md

@@ -0,0 +1,111 @@
+# Code Patterns
+
+Переиспользуемые паттерны кодовой базы. Используй существующие — не изобретай новые без необходимости.
+
+---
+
+## 1. Kernel — статический контейнер
+
+```php
+// Инициализация (один раз при старте воркера)
+Kernel::init($container);
+
+// Получение сервиса
+$service = Kernel::getContainer()->get(MyService::class);
+```
+
+Kernel хранит единственный инстанс контейнера на весь процесс воркера.
+
+---
+
+## 2. ContainerFactory — сборка контейнера
+
+```php
+$factory = new ContainerFactory($config, $environment);
+$container = $factory->build();
+```
+
+Autoload: все файлы из `routes/` и `services/` подхватываются автоматически.
+Не регистрируй маршруты и сервисы вручную в `index.php` — кладёт файлы в соответствующие директории.
+
+---
+
+## 3. Router и RouteDefinition
+
+```php
+// routes/api.php
+return [
+    new RouteDefinition('GET', '/users/{id}', UserController::class, 'show'),
+];
+```
+
+Router находит нужный маршрут по методу и пути, извлекает параметры и вызывает контроллер.
+
+---
+
+## 4. Middleware — цепочка обработки запроса
+
+```php
+class MyMiddleware implements MiddlewareInterface {
+    public function handle(Request $request, callable $next): Response {
+        // до
+        $response = $next($request);
+        // после
+        return $response;
+    }
+}
+```
+
+Middleware регистрируются в контейнере и применяются ко всем запросам в воркере.
+
+---
+
+## 5. ORM — атрибуты сущностей
+
+```php
+#[Collection('users')]
+class UserEntity {
+    #[Field('_id')]
+    public string $id;
+
+    #[Field('name')]
+    public string $name;
+}
+```
+
+Repository наследует базовый класс и получает методы `find`, `findOne`, `save`, `delete` из коробки.
+
+---
+
+## 6. JWT Auth
+
+```php
+// AuthMiddleware автоматически валидирует Bearer-токен
+// В контроллере — получить текущего пользователя из request
+$user = $request->getAttribute('user');
+```
+
+`JwtService` отвечает за выпуск и верификацию токенов. Конфиг: секрет и TTL через `Config`.
+
+---
+
+## 7. Config — конфигурация
+
+```php
+$value = Config::get('key');
+$value = Config::get('section.key', $default);
+```
+
+Конфиг загружается из `environment.php` (или `.env`). Доступен глобально через статический метод.
+
+---
+
+## 8. WorkerRunner — цикл обработки запросов
+
+```php
+// Внутри worker.php
+$runner = new WorkerRunner($kernel);
+$runner->run(); // FrankenPHP loop: запрос → роутинг → middleware → контроллер → ответ
+```
+
+`WorkerRunner` перехватывает исключения и возвращает корректный HTTP-ответ даже при ошибке.