Bicycle/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project

Bicycle — самописный PHP-фреймворк, разрабатываемый с нуля. Проект находится в стадии начальной разработки.

Предполагаемая архитектура

Фреймворк строится по принципу MVC + Service Container:

• System/Classes/ — основные классы: Application, Router, Container, Middleware, Request, Response и др.
• System/Http/ — обработчики HTTP-статусов (404, 503 и т.д.)
• System/Database/ — QueryBuilder / ORM
• System/View/ — шаблонизатор
• System/Console/ — CLI-команды
• config/ — конфигурационные файлы (.php массивы)
• index.php — точка входа
• bin/bicycle — CLI-точка входа

Когда структура будет создана

Установка зависимостей

composer install

Запуск встроенного сервера

php -S localhost:8000

Запуск тестов

./vendor/bin/phpunit
# один тест:
./vendor/bin/phpunit tests/Unit/RouterTest.php

Линтер / статический анализ

./vendor/bin/phpcs --standard=PSR12 System/
./vendor/bin/phpstan analyse System/ --level=5

CLI фреймворка

php bin/bicycle <command>

Соглашения

• PHP 8.1+, строгая типизация (declare(strict_types=1))
• Стандарт кода — PSR-12
• Пространство имён корня: Bicycle\
• Автозагрузка через Composer PSR-4: "Bicycle\\": "System/Classes/"