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

2025-12-02 15:57:42 +03:00
parent cf107b62a3
commit 7f69eab545
44 changed files with 1470 additions and 0 deletions
--- a/BotPages.Core/Navigation/NavigationService.cs
+++ b/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();
+        }
+    }
+}