AB Connector — операторская Laravel-платформа для работы с входящими сообщениями из Telegram и MAX, с админкой на Filament, rule-based автоответами, collector flow и Bitrix24 integration.
Основные shortcuts из composer.json, которые заменяют типовые ручные вызовы:
composer dev # локальный dev-runtime вне Docker
composer docker:build # собрать docker-образы
composer docker:up # поднять полный Docker dev-runtime в фоне
composer docker:dev # запустить Docker dev-runtime в foreground
composer docker:down # остановить контейнеры
composer docker:remove # остановить контейнеры и удалить volumes
composer test:feature:ui # UI feature shard
composer test:feature:bots # bots/webhook shard
composer test:feature:bitrix # Bitrix24 shard
composer test:feature:collector # collector shard
composer test:feature:domain # domain shard
composer test:ci # агрегированный CI-friendly прогонcp .env.example .envБез ngrok Telegram/MAX не смогут доставлять webhook-сообщения на локальный сервер.
- Зарегистрируйся на ngrok.com
- Получи Authtoken и Static Domain
- Заполни в
.env:
NGROK_AUTHTOKEN=your_token
APP_URL=https://your-name.ngrok-free.app
VS Code Dev Container — нужны Docker Desktop и расширение Dev Containers:
Ctrl+Shift+P → Dev Containers: Reopen in Container
Чистый Docker:
composer docker:upПрямой эквивалент: docker compose up -d.
Контейнер автоматически ставит зависимости, применяет миграции и запускает полный dev-runtime: web-server, scheduler, queue workers, логи и frontend watcher.
Не запускай отдельно только php artisan serve: без php artisan schedule:work
статусы каналов через пару минут станут Проверка устарела.
Если нужен foreground-режим с логами:
composer docker:devЕсли нужно войти в контейнер:
docker compose exec dev bash| Сервис | Адрес |
|---|---|
| Admin UI | http://localhost:8000/admin |
| Mailpit | http://localhost:8025 |
| Adminer | http://localhost:8080 |
| ngrok | http://localhost:4040 |
Логин: admin@abrikosoff.local, пароль из ADMIN_USER_SEEDER_PASSWORD.
php artisan test # полный suite
composer test:feature:ui # UI shard
composer test:feature:bots
composer test:feature:bitrix
composer test:feature:collector
composer test:feature:domain
composer test:ci # CI-агрегированный прогон- AGENTS.md — верхнеуровневые рамки, инварианты и правила работы агента
- docs/architecture.md — одностраничная архитектурная карта проекта
- docs/reference/project-scope.md — проектовый контур и текущие жёсткие границы
- docs/reference/local-bootstrap.md — локальный bootstrap и ежедневный dev-runtime
- docs/task-delivery-workflow.md — canonical delivery-playbook; согласованный локальный MVP ведёт к операторской приёмке, а выход в
stagingначинается после явного решения о выкладке - docs/action-ownership.md — кто выполняет GitHub, PR, release и dangerous-op действия
- docs/agent-routing.md — маршрутизация агента к нужным process docs и skills
- docs/agent-docs-lifecycle.md — lifecycle документов, влияющих на действия агента
- docs/clean-stream-release-flow.md — дополнительный appendix по clean-stream extraction и mixed-state cleanup
- docs/staging-laravel-cloud.md — staging, deploy baseline и real Bitrix integration flow
- docs/post-deploy-smoke.md — post-deploy smoke и rev-check контур
- docs/playwright.md — Playwright smoke, локальный и remote запуск
- docs/backup.md — backup и verify runbook
- docs/runbooks/release-rollback.md — rollback/forward-fix decision runbook для release-инцидентов
- docs/runbooks/test-env.md — безопасный PHPUnit/test database контур
- docs/runbooks/telegram-local-bot-api.md — безопасный локальный запуск Telegram Local Bot API для больших входящих файлов
- docs/bitrix24/setup-sheet.md — frozen Bitrix24 ops/setup sheet с подтверждёнными integration values
- docs/bitrix24/dev-local-setup.md — как разработчику подключить свою локалку к общему Bitrix24 staging через
dev-*profile - docs/dialog-workspace.md — текущая модель
Contact overview / Dialog workspace
Полные опубликованные ТЗ, статусы ТЗ, реестр активных работ и архив живут во внешнем репозитории документации: Etogerman/Project-1-specs.
Project-1-specs считается внешним контуром, а не локальным местом для ранних черновиков. До операторского решения о выкладке существенный stream может идти по ТЗ из чата или явно указанного локального черновика вне Project-1 и вне Project-1-specs.
Основной проект не хранит живые указатели на версии ТЗ и не хранит реестр активных работ. Для конкретной работы актуальные Spec repo, Spec doc и Spec revision фиксируются во внешнем репозитории документации, в описании задачи или в PR перед первым внешним code/runtime действием.
docs/reference/active-specs.md оставлен только как legacy snapshot старого
локального реестра и не является source of truth.
- полный suite:
php artisan test - CI-friendly shard suites:
composer test:feature:uicomposer test:feature:botscomposer test:feature:bitrixcomposer test:feature:collectorcomposer test:feature:domain
- агрегирующий прогон для CI:
composer test:ci - локальный полный dev-runtime:
composer dev
Проект работает на Laravel 13, но источник истины по runtime, workflow и integration-контрактам находится в локальных project docs, а не в стоковом Laravel boilerplate.
Если нужна именно framework-справка: