Centralize BaseUrl logic via AcEnv; enforce fail-fast

Refactored BaseUrl handling so FruitBankConstClient delegates all access to AcEnv.BaseUrl in AyCode.Core, ensuring a single source of truth and fail-fast validation. Removed redundant _baseUrl field and logic from FruitBankConstClient. Updated startup files to hydrate BaseUrl from configuration and improved comments to clarify the new delegation and configuration conventions.

AyCode.Core/Consts/AcEnv.cs

@@ -22,6 +22,18 @@ namespace AyCode.Core.Consts
 
         public static ulong MaxLogItemsPerSession = 250;
 
+        /// <summary>
+        /// A szerver base URL-je (pl. "https://localhost:59579") — a kliens-hostok hidratálják induláskor
+        /// a configból (konvenció: "AyCode:Urls:BaseUrl"). A hub-/link-URL-ek EBBŐL az egy értékből származnak.
+        /// Fail-fast: hidratálatlan olvasás exception — hiányzó/rossz URL-lel nem megyünk tovább csendben.
+        /// </summary>
+        private static string? _baseUrl;
+        public static string BaseUrl
+        {
+            get => !string.IsNullOrWhiteSpace(_baseUrl) ? _baseUrl : throw new InvalidOperationException("AcEnv.BaseUrl nincs beállítva — a host indulásakor hidratáld a configból (konvenció: 'AyCode:Urls:BaseUrl').");
+            set => _baseUrl = value;
+        }
+
         private static IConfiguration? _appConfiguration = null;
         public static IConfiguration AppConfiguration => _appConfiguration ??= GetAppSettingsConfiguration();
 

AyCode.Services/Nav/docs/EKAER_INTERFACE.md

@@ -82,6 +82,15 @@ A fenti `user` / `passwordHash` / `signingKey` az **ADÓZÓé** (a bejelentésre
 
 > **Másik interfész (2024–25): a „NAV M2M általános gépi interfész"** — ÚJ, általánosabb beküldő-csatorna, ahol **a fejlesztő a kliensprogramot regisztrálja** a NAV-nál (a végfelhasználók is regisztrálnak + NAV-tól kapott titkos kódokat írnak be). Ez **NEM** a fenti klasszikus EKÁER 2.2 XML-interfész. Ha a NAV oda terel, ott VAN fejlesztői regisztráció — production előtt érdemes tisztázni, melyik a hatályos.
 
+### Teszt-környezet — külön belépés + technikai felhasználó (2026-07, gyakorlatból)
+
+A **TESZT-rendszer credentialjai NEM a saját portál-belépési adatok** (a személyes Ügyfélkapu/EKÁER login a teszt-API-hoz `InvalidUserOrPassword`-öt ad). A menet:
+1. **Teszt-hozzáférés igénylése** a NAV-nál (Kapcsolatfelvétel → „EKÁER, Informatikai problémák"; a levélben: cégnév, adószám, cím/telefon, e-mail) → a NAV e-mailben küld **kifejezetten generált teszt-belépést**.
+2. A teszt-felületen a profilban **technikai felhasználó + kulcsok** generálása: `username` (technikai user, NEM a személyes login), `password`, **XML aláírókulcs** (`signingKey`).
+3. A `taxNumber` a **teszthez regisztrált cég** adószámának első 8 jegye.
+
+Ezek kerülnek az `INavCredentials`-be (a fogyasztónál: `Ekaer:Credentials`). A `BaseUrl` a teszt-hoszt (pl. `https://import-test.ekaer.nav.gov.hu`). **Endpoint:** `{BaseUrl}/TradeCardManagementService/customer/{művelet}` — a művelet-utat a kód fűzi.
+
 ## Műveletek (`tradeCardOperations` → `operation`)
 
 | Operation | Jelentés |

AyCode.Services/SignalRs/AcBinaryHubProtocol.cs

@@ -164,8 +164,7 @@ public class AcBinaryHubProtocol : IHubProtocol
 
         _chunkStates = new ConditionalWeakTable<IInvocationBinder, AsyncChunkState>();
 
-        _logger?.LogInformation(
-            "AcBinaryHubProtocol initialized name={Name} mode={ProtocolMode} isBrowser={IsBrowser} chunkSize={ChunkSize} initCap={InitCap} flushPolicy={FlushPolicy} flushTimeoutMs={FlushTimeoutMs} useGen={UseGen} wireMode={WireMode} interning={Interning} compression={Compression}",
+        _logger?.LogInformation("AcBinaryHubProtocol initialized name={Name} mode={ProtocolMode} isBrowser={IsBrowser} chunkSize={ChunkSize} initCap={InitCap} flushPolicy={FlushPolicy} flushTimeoutMs={FlushTimeoutMs} useGen={UseGen} wireMode={WireMode} interning={Interning} compression={Compression}",
             Name, _protocolMode, IsBrowser, _options.BufferWriterChunkSize, _options.InitialBufferCapacity,
             _flushPolicy, _flushTimeout.TotalMilliseconds,
             _options.UseGeneratedCode, _options.WireMode, _options.UseStringInterning, _options.UseCompression);

AyCode.Services/SignalRs/AcSignalRClientBase.cs

@@ -100,13 +100,28 @@ namespace AyCode.Services.SignalRs
 
         public async Task StartConnection()
         {
+            var wasConnected = IsConnected();
+
             if (GetConnectionState() == HubConnectionState.Disconnected)
                 await StartConnectionInternal();
 
             if (!IsConnected())
                 await TaskHelper.WaitToAsync(IsConnected, ConnectionTimeout, 10, 25);
+
+            // Átmenet-hook: csak TÉNYLEGES felépüléskor tüzel (a StartConnection minden küldés előtt lefut,
+            // már-kapcsolt állapotban nem hívjuk). Párhuzamos felépülésnél ritkán kétszer is tüzelhet —
+            // az override legyen idempotens.
+            if (!wasConnected && IsConnected())
+                await OnConnectionEstablished();
         }
 
+        /// <summary>
+        /// Kapcsolat-felépüléskor fut (első connect ÉS reconnectek után). A küldő-út várja meg —
+        /// hosszú munkát fire-and-forget taskként indítson, ne blokkolja az adatforgalmat.
+        /// Idempotensnek kell lennie (párhuzamos felépülésnél kétszer is tüzelhet).
+        /// </summary>
+        protected virtual Task OnConnectionEstablished() => Task.CompletedTask;
+
         public async Task StopConnection()
         {
             await StopConnectionInternal();