Добавьте файлы проекта.

BotPages.Core/Navigation/INavigationService.cs

@@ -0,0 +1,38 @@
+namespace BotPages.Core
+{
+    /// <summary>
+    /// Сервис навигации по страницам.
+    /// </summary>
+    public interface INavigationService
+    {
+        /// <summary>
+        /// Выполняет push новой страницы и вызывает её Enter.
+        /// </summary>
+        Task PushAsync(string pageId, object? args, UpdateContext ctx, CancellationToken ct);
+
+        /// <summary>
+        /// Выполняет replace текущей страницы и вызывает Enter новой.
+        /// </summary>
+        Task ReplaceAsync(string pageId, object? args, UpdateContext ctx, CancellationToken ct);
+
+        /// <summary>
+        /// Возвращается назад по стеку и вызывает Enter предыдущей.
+        /// </summary>
+        Task PopAsync(UpdateContext ctx, CancellationToken ct);
+
+        /// <summary>
+        /// Применяет декларативный результат страницы (навигация, текст, файлы).
+        /// </summary>
+        Task ApplyResultAsync(UpdateContext ctx, PageResult result, CancellationToken ct);
+
+        /// <summary>
+        /// Возвращает текущую запись стека.
+        /// </summary>
+        Task<NavEntry?> CurrentAsync(UpdateContext ctx, CancellationToken ct);
+
+        /// <summary>
+        /// Возвращает весь стек навигации.
+        /// </summary>
+        Task<IReadOnlyList<NavEntry>> StackAsync(UpdateContext ctx, CancellationToken ct);
+    }
+}

BotPages.Core/Navigation/IStateStore.cs

@@ -0,0 +1,18 @@
+namespace BotPages.Core
+{
+    /// <summary>
+    /// Простое in-memory хранилище состояния пользователя.
+    /// </summary>
+    public interface IStateStore
+    {
+        /// <summary>
+        /// Получает состояние пользователя.
+        /// </summary>
+        Task<UserState> GetAsync(long userId, CancellationToken ct);
+
+        /// <summary>
+        /// Сохраняет состояние пользователя.
+        /// </summary>
+        Task SaveAsync(UserState state, CancellationToken ct);
+    }
+}

BotPages.Core/Navigation/InMemoryStateStore.cs

@@ -0,0 +1,33 @@
+namespace BotPages.Core
+{
+
+    /// <summary>
+    /// In-memory реализация хранилища состояния для прототипирования.
+    /// </summary>
+    public sealed class InMemoryStateStore : IStateStore
+    {
+        private readonly Dictionary<long, UserState> _store = new();
+
+        /// <summary>
+        /// Получает состояние пользователя, создавая новое при отсутствии.
+        /// </summary>
+        public Task<UserState> GetAsync(long userId, CancellationToken ct)
+        {
+            if (!_store.TryGetValue(userId, out var st))
+            {
+                st = new UserState { UserId = userId };
+                _store[userId] = st;
+            }
+            return Task.FromResult(st);
+        }
+
+        /// <summary>
+        /// Сохраняет состояние пользователя.
+        /// </summary>
+        public Task SaveAsync(UserState state, CancellationToken ct)
+        {
+            _store[state.UserId] = state;
+            return Task.CompletedTask;
+        }
+    }
+}

BotPages.Core/Navigation/NavigationService.cs

@@ -0,0 +1,108 @@
+namespace BotPages.Core
+{
+    /// <summary>
+    /// Реализация сервиса навигации страниц.
+    /// </summary>
+    public sealed class NavigationService : INavigationService
+    {
+        private readonly IPageRegistry _pages;
+        private readonly IStateStore _store;
+
+        /// <summary>
+        /// Создаёт сервис навигации.
+        /// </summary>
+        public NavigationService(IPageRegistry pages, IStateStore store)
+        {
+            _pages = pages;
+            _store = store;
+        }
+
+        /// <summary>
+        /// Выполняет push новой страницы и вызывает её Enter.
+        /// </summary>
+        public async Task PushAsync(string pageId, object? args, UpdateContext ctx, CancellationToken ct)
+        {
+            var state = await _store.GetAsync(ctx.User.Id, ct);
+            state.Stack.Add(new NavEntry(pageId, args));
+            await _store.SaveAsync(state, ct);
+
+            var pr = await _pages.Get(pageId).EnterAsync(ctx, ct);
+            await ApplyResultAsync(ctx, pr, ct);
+        }
+
+        /// <summary>
+        /// Выполняет replace текущей страницы и вызывает Enter новой.
+        /// </summary>
+        public async Task ReplaceAsync(string pageId, object? args, UpdateContext ctx, CancellationToken ct)
+        {
+            var state = await _store.GetAsync(ctx.User.Id, ct);
+            if (state.Stack.Count > 0) state.Stack[^1] = new NavEntry(pageId, args);
+            else state.Stack.Add(new NavEntry(pageId, args));
+            await _store.SaveAsync(state, ct);
+
+            var pr = await _pages.Get(pageId).EnterAsync(ctx, ct);
+            await ApplyResultAsync(ctx, pr, ct);
+        }
+
+        /// <summary>
+        /// Возвращается назад по стеку и вызывает Enter предыдущей.
+        /// </summary>
+        public async Task PopAsync(UpdateContext ctx, CancellationToken ct)
+        {
+            var state = await _store.GetAsync(ctx.User.Id, ct);
+            if (state.Stack.Count == 0) return;
+
+            var currentId = state.Stack[^1].PageId;
+            await _pages.Get(currentId).ExitAsync(ctx, ct);
+
+            state.Stack.RemoveAt(state.Stack.Count - 1);
+            await _store.SaveAsync(state, ct);
+
+            var next = state.Stack.Count > 0 ? state.Stack[^1].PageId : null;
+            if (next is not null)
+            {
+                var pr = await _pages.Get(next).EnterAsync(ctx, ct);
+                await ApplyResultAsync(ctx, pr, ct);
+            }
+        }
+
+        /// <summary>
+        /// Применяет декларативный результат страницы (навигация, текст, файлы).
+        /// </summary>
+        public async Task ApplyResultAsync(UpdateContext ctx, PageResult result, CancellationToken ct)
+        {
+            if (result.NavigateTo is not null)
+            {
+                if (result.NavigateTo.Replace)
+                    await ReplaceAsync(result.NavigateTo.PageId, result.NavigateTo.Args, ctx, ct);
+                else
+                    await PushAsync(result.NavigateTo.PageId, result.NavigateTo.Args, ctx, ct);
+                return; // навигация сама вызовет Enter новой страницы и применит её результат
+            }
+
+            if (result.Message is not null)
+                await ctx.Client.SendTextAsync(ctx.Chat.Id, result.Message, result.Actions, ct);
+
+            if (result.Files is not null)
+                await ctx.Client.SendFilesAsync(ctx.Chat.Id, result.Files, ct);
+        }
+
+        /// <summary>
+        /// Возвращает текущую запись стека.
+        /// </summary>
+        public async Task<NavEntry?> CurrentAsync(UpdateContext ctx, CancellationToken ct)
+        {
+            var state = await _store.GetAsync(ctx.User.Id, ct);
+            return state.Stack.Count == 0 ? null : state.Stack[^1];
+        }
+
+        /// <summary>
+        /// Возвращает весь стек навигации.
+        /// </summary>
+        public async Task<IReadOnlyList<NavEntry>> StackAsync(UpdateContext ctx, CancellationToken ct)
+        {
+            var state = await _store.GetAsync(ctx.User.Id, ct);
+            return state.Stack.AsReadOnly();
+        }
+    }
+}

BotPages.Core/Navigation/UserState.cs

@@ -0,0 +1,23 @@
+namespace BotPages.Core
+{
+    /// <summary>
+    /// Состояние пользователя: навигационный стек и общий словарь данных.
+    /// </summary>
+    public sealed class UserState
+    {
+        /// <summary>
+        /// Идентификатор пользователя.
+        /// </summary>
+        public long UserId { get; init; }
+
+        /// <summary>
+        /// Навигационный стек страниц.
+        /// </summary>
+        public List<NavEntry> Stack { get; } = new();
+
+        /// <summary>
+        /// Общая сумка данных, доступная на всех страницах.
+        /// </summary>
+        public Dictionary<string, object?> Bag { get; } = new();
+    }
+}