claude-meta/memory/projects/kbsV3/MEMORY.md

KbsV3 Memory

Architecture Guide

• See kbsv3-architecture.md for: SAP RFC calls, gRPC communication, DB read/write patterns
• See job-system.md for: full job lifecycle, scheduler pattern, ILongRunningJobService vs IKbsJob, InputData/Payload flow

Plotly.Blazor (v7.0.0)

• ModeFlag namespace: Plotly.Blazor.Traces.ScatterLib
• XAxis.Type needs Plotly.Blazor.LayoutLib.XAxisLib.TypeEnum.Date (not string)
• Title is ambiguous between LayoutLib and LayoutLib.XAxisLib — use fully qualified
• Events (relayout) not implemented in library — use JS interop via el.on('plotly_relayout', ...)

Service Layer Pattern

• Services use JobDbContext injected directly
• Interface in Contract/, implementation in Services/
• Register in Program.cs as builder.Services.AddScoped<IFoo, Foo>()

SAP NCo3 IRfcFunction

• IRfcFunction does NOT implement IDisposable — using var fnc causes CS1674 compile error
• NCo3 manages memory via GC; fnc vars in method scope are eligible for collection after method returns
• Fix 1 from memory-optimization plan is NOT applicable via using; no explicit disposal mechanism available

Job Worker Patterns (IKbsJob vs ILongRunningJobService)

• All KnownJobs in Kbs3SqlService use IKbsJob (NOT ILongRunningJobService)
• IKbsJob runs via LongRunningJobServiceHost with JobType.CallServiceHost
• Auto-registered as keyed service by class name (e.g. "SyncOpexPurchaseOrdersService")
• IKnownJob.ServiceName format: "modulename.ClassName" → host splits on . and resolves last segment
• Do NOT add new JobType enum entries for IKbsJob workers — they all share CallServiceHost
• ILongRunningJobService is for services like AD sync, Hydra — they have dedicated JobType enum entries

Naming

• App is called "KRAH-App" internally (not "KBS" — that's only the technical project name)

HydraArchiveData

• Entity: HydraArchiveReloadId, AcquisitionTime, PdatrefPparamDatasupId, DecimalValue
• Covering index: (HydraArchiveReloadId, AcquisitionTime, PdatrefPparamDatasupId)
• SQL bucket aggregation: DATEDIFF/DATEADD pattern for time-bucket grouping
• Raw SQL via _dbContext.Database.SqlQueryRaw<T>(sql, params)