README.md

# PHP Team Code Standards

> Корпоративные правила `АНО "Цифровой аудит"` написания кода для команды Битрикс24-разработки

[![PHP](https://img.shields.io/badge/PHP-8.1%2B%20%2F%208.4-blue)](https://www.php.net/)
[![Platform](https://img.shields.io/badge/Platform-Bitrix24-FF6600)](https://www.bitrix24.ru/)
[![Standard](https://img.shields.io/badge/Standard-PSR--12-green)](https://www.php-fig.org/psr/psr-12/)
[![Version](https://img.shields.io/badge/Docs-v2.0-lightgrey)](./src/index.md)

---

## О репозитории

Этот репозиторий содержит **официальный стандарт написания кода PHP-команды**. Документация охватывает весь стек разработки на платформе Битрикс24: от соглашений по именованию до архитектурных паттернов, ORM, кеширования, агентов и логирования.

Руководство опирается на принципы **SOLID, DRY, KISS, YAGNI** и адаптировано под особенности Битрикс24-разработки (ORM Bitrix, CRM API, EventManager, AbstractAgent).

### Для кого

- **Разработчики** — базовый ориентир при написании и ревью кода
- **Тимлиды** — чеклист для код-ревью и онбординга новых участников
- **Новые члены команды** — точка входа в стандарты проекта

### Структура документации

```
README.md          ← этот файл
src/
  index.md         ← вступление и полное оглавление
  01-naming.md
  02-functions.md
  03-classes.md
  04-controllers.md
  05-arrays.md
  06-conditions.md
  07-typing.md
  08-errors.md
  09-security.md
  10-database.md
  11-performance.md
  12-testing.md
  13-comments.md
  14-general.md
  15-events.md
  16-logging.md
  17-agents.md
  tips/
    index.md       ← список тематических статей
    isset-vs-empty.md
```

### Быстрый старт

📖 **[Читать документацию → src/index.md](./src/index.md)**

---

## Версии

| Версия | Дата | Изменения |
|--------|------|-----------|
| 2.0 | 2026 | Исправленная и дополненная редакция |
| 1.0 | 2026 | Первая версия |

---

## Вклад в документацию

Нашли неточность или хотите добавить пример? Создайте PR или issue. Новые тематические статьи по конкретным конструкциям и паттернам добавляются в папку [`src/tips/`](./src/tips/index.md).
stupid git server
