BotPages/docs/GETTING_STARTED.md

Быстрый старт — BotPages

Эта инструкция поможет запустить и протестировать проект локально.

Требования

• .NET 8 SDK
• Токен Telegram (если используете Telegram-адаптер)

Сборка

dotnet build

Запуск демонстрации

1. Откройте проект Demo.
2. Внесите токен Telegram (если используется) в код инициализации адаптера или в переменные окружения проекта Demo.
3. Запустите:

dotnet run --project Demo

Пример конфигурации приложения

var app = new BotPagesApp(stateStorage, logger)
    .AddAdapter("telegram", new TelegramAdapterSetup("<token>"))
    .AddDefaultPage<WelcomePage>()
    .MapCommand<WelcomePage>("/start")
    .AddMiddleware(new LoggingMiddleware(logger));

await app.Build(CancellationToken.None);

Как написать страницу

• Наследуйте StatefulPage для страниц с пер-сессионным состоянием.
• Наследуйте SingletonPage для одноэкземплярных страниц.
• Переопределите OnEnter, OnUpdate, OnText, OnButton, OnFile, OnError по необходимости.
• Для автоматического маппинга маршрутов используйте AutoMapRoute().

Тестирование команд

• Команды регистрируются в BotPagesApp.MapCommand.
• Шаблон команд поддерживает именованные и опциональные аргументы: /cmd {a} {b?}.

Подсказки

• Middleware выполняются в том порядке, в котором их добавляют в BotPagesApp.
• Команды имеют приоритет над обработкой страниц (если текст начинается с /).

Если требуется подробный справочник API — смотрите docs/API_REFERENCE.md.