Merge branch 'development'

Author: HaikAsatryan

.editorconfig

@@ -1,191 +1,97 @@
-###############################
-#   PandaTech Editor Config   #
-###############################
+# .editorconfig — Asatryan.MonoSlice template
+# Only entries that deviate from Roslyn SDK defaults. Restating defaults is intentionally avoided.
+# Build-time enforcement requires <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>.
 
+root = true
 
-################################
-# ReSharper Generated Settings #
-################################
-
+############################################################
+# All files — EditorConfig spec keys (no SDK provides these)
+############################################################
 [*]
-charset = utf-8-bom
-end_of_line = crlf
-trim_trailing_whitespace = false
-insert_final_newline = false
+charset = utf-8
+end_of_line = lf
 indent_style = space
 indent_size = 4
+insert_final_newline = true
+trim_trailing_whitespace = true
 
-# Microsoft .NET properties
-csharp_preferred_modifier_order = public, private, protected, internal, file, new, static, abstract, virtual, sealed, readonly, override, extern, unsafe, volatile, async, required:suggestion
-csharp_style_prefer_utf8_string_literals = true:suggestion
-csharp_style_var_elsewhere = true:suggestion
-csharp_style_var_for_built_in_types = true:suggestion
-csharp_style_var_when_type_is_apparent = true:suggestion
-dotnet_naming_rule.unity_serialized_field_rule.import_to_resharper = True
-dotnet_naming_rule.unity_serialized_field_rule.resharper_description = Unity serialized field
-dotnet_naming_rule.unity_serialized_field_rule.resharper_guid = 5f0fdb63-c892-4d2c-9324-15c80b22a7ef
-dotnet_naming_rule.unity_serialized_field_rule.severity = warning
-dotnet_naming_rule.unity_serialized_field_rule.style = lower_camel_case_style
-dotnet_naming_rule.unity_serialized_field_rule.symbols = unity_serialized_field_symbols
-dotnet_naming_style.lower_camel_case_style.capitalization = camel_case
-dotnet_naming_symbols.unity_serialized_field_symbols.applicable_accessibilities = *
-dotnet_naming_symbols.unity_serialized_field_symbols.applicable_kinds =
-dotnet_naming_symbols.unity_serialized_field_symbols.resharper_applicable_kinds = unity_serialised_field
-dotnet_naming_symbols.unity_serialized_field_symbols.resharper_required_modifiers = instance
-dotnet_style_parentheses_in_arithmetic_binary_operators = never_if_unnecessary:none
-dotnet_style_parentheses_in_other_binary_operators = always_for_clarity:none
-dotnet_style_parentheses_in_relational_binary_operators = never_if_unnecessary:none
-dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
-dotnet_style_predefined_type_for_member_access = true:suggestion
-dotnet_style_qualification_for_event = false:suggestion
-dotnet_style_qualification_for_field = false:suggestion
-dotnet_style_qualification_for_method = false:suggestion
-dotnet_style_qualification_for_property = false:suggestion
-dotnet_style_require_accessibility_modifiers = for_non_interface_members:suggestion
-
-# ReSharper properties
-resharper_align_linq_query = true
-resharper_align_multiline_calls_chain = true
-resharper_apply_auto_detected_rules = false
-resharper_braces_for_for = required
-resharper_braces_for_foreach = required
-resharper_braces_for_ifelse = required
-resharper_braces_for_while = required
-resharper_cpp_insert_final_newline = true
-resharper_csharp_indent_size = 3
-resharper_csharp_max_enum_members_on_line = 0
-resharper_csharp_tab_width = 3
-resharper_csharp_wrap_arguments_style = chop_if_long
-resharper_csharp_wrap_parameters_style = chop_if_long
-resharper_formatter_off_tag = @formatter:off
-resharper_formatter_on_tag = @formatter:on
-resharper_formatter_tags_enabled = true
-resharper_keep_existing_declaration_parens_arrangement = false
-resharper_keep_existing_expr_member_arrangement = false
-resharper_keep_existing_initializer_arrangement = false
-resharper_keep_existing_switch_expression_arrangement = false
-resharper_max_array_initializer_elements_on_line = 0
-resharper_max_initializer_elements_on_line = 0
-resharper_place_accessorholder_attribute_on_same_line = false
-resharper_place_accessor_attribute_on_same_line = false
-resharper_place_field_attribute_on_same_line = false
-resharper_place_simple_anonymousmethod_on_single_line = false
-resharper_place_simple_embedded_statement_on_same_line = false
-resharper_place_simple_initializer_on_single_line = false
-resharper_place_simple_property_pattern_on_single_line = false
-resharper_use_indent_from_vs = false
-resharper_wrap_after_property_in_chained_method_calls = true
-resharper_wrap_array_initializer_style = chop_if_long
-resharper_wrap_chained_method_calls = chop_always
-resharper_wrap_linq_expressions = chop_always
-resharper_wrap_list_pattern = chop_if_long
-resharper_wrap_object_and_collection_initializer_style = chop_always
-resharper_wrap_property_pattern = chop_always
-
-# ReSharper inspection severities
-resharper_arrange_redundant_parentheses_highlighting = hint
-resharper_arrange_this_qualifier_highlighting = hint
-resharper_arrange_type_member_modifiers_highlighting = hint
-resharper_arrange_type_modifiers_highlighting = hint
-resharper_built_in_type_reference_style_for_member_access_highlighting = hint
-resharper_built_in_type_reference_style_highlighting = hint
-resharper_enforce_foreach_statement_braces_highlighting = warning
-resharper_enforce_for_statement_braces_highlighting = warning
-resharper_enforce_if_statement_braces_highlighting = warning
-resharper_enforce_lock_statement_braces_highlighting = warning
-resharper_enforce_using_statement_braces_highlighting = warning
-resharper_enforce_while_statement_braces_highlighting = warning
-resharper_mvc_action_not_resolved_highlighting = warning
-resharper_mvc_area_not_resolved_highlighting = warning
-resharper_mvc_controller_not_resolved_highlighting = warning
-resharper_mvc_masterpage_not_resolved_highlighting = warning
-resharper_mvc_partial_view_not_resolved_highlighting = warning
-resharper_mvc_template_not_resolved_highlighting = warning
-resharper_mvc_view_component_not_resolved_highlighting = warning
-resharper_mvc_view_component_view_not_resolved_highlighting = warning
-resharper_mvc_view_not_resolved_highlighting = warning
-resharper_razor_assembly_not_resolved_highlighting = warning
-resharper_redundant_base_qualifier_highlighting = warning
-resharper_web_config_module_not_resolved_highlighting = warning
-resharper_web_config_type_not_resolved_highlighting = warning
-resharper_web_config_wrong_module_highlighting = warning
-
-[{*.har,*.jsb2,*.jsb3,*.json,*.jsonc,*.postman_collection,*.postman_collection.json,*.postman_environment,*.postman_environment.json,.babelrc,.eslintrc,.prettierrc,.stylelintrc,.ws-context,bowerrc,jest.config}]
-indent_style = space
+############################################################
+# Project + config files (2-space convention)
+############################################################
+[*.{csproj,props,targets,slnx,resx,xml,config,nuspec,json,yml,yaml,md}]
 indent_size = 2
 
-[{*.yaml,*.yml}]
-indent_style = space
-indent_size = 2
-
-[*.cs]
-indent_style = space
-indent_size = 3
-tab_width = 3
-
-[*.{appxmanifest,asax,ascx,aspx,axaml,build,c,c++,c++m,cc,ccm,cginc,compute,cp,cpp,cppm,cshtml,cu,cuh,cxx,cxxm,dtd,fs,fsi,fsscript,fsx,fx,fxh,h,hh,hlsl,hlsli,hlslinc,hpp,hxx,inc,inl,ino,ipp,ixx,master,ml,mli,mpp,mq4,mq5,mqh,mxx,nuspec,paml,razor,resw,resx,shader,skin,tpp,usf,ush,uxml,vb,xaml,xamlx,xoml,xsd}]
-indent_style = space
-indent_size = 4
-tab_width = 4
+[*.{cmd,bat}]
+end_of_line = crlf
 
-#########################
-# Custom added settings #
-#########################
+############################################################
+# C# — surface style rules at build that ship below warning by default
+############################################################
 [*.cs]
-dotnet_diagnostic.cs8600.severity = error #Converting null literal or possible null value to non-nullable type.
-dotnet_diagnostic.cs8601.severity = error #Possible null reference assignment.
-dotnet_diagnostic.cs8602.severity = error #possible dereference of a null reference
-dotnet_diagnostic.cs8603.severity = error #possible null reference return
-dotnet_diagnostic.cs8604.severity = error #possible null reference argument for parameter
-dotnet_diagnostic.cs8605.severity = error #Unboxing a possibly null value
-dotnet_diagnostic.cs8618.severity = error # Non-nullable field is uninitialized. Consider declaring as nullable.
-dotnet_diagnostic.cs8625.severity = error # Cannot convert null literal to non-nullable reference type.
-dotnet_diagnostic.cs8762.severity = error # Nullability of reference types in type doesn't match overridden member.
-dotnet_diagnostic.cs1717.severity = error #variable is assigned to itself
-dotnet_diagnostic.cs1718.severity = error #comparison made to same variable
-dotnet_diagnostic.cs0659.severity = error #overriding object.Equals but not overriding object.GetHashCode
-dotnet_diagnostic.cs0251.severity = error #Indexing an array with a negative index (array indices always start at zero)
-dotnet_diagnostic.s3363.severity = none #Never set DateTime as PrimaryKey. Ignored as we never do it but have warnings for cache entities.
-dotnet_diagnostic.ca2016.severity = error #Forwarding cancellation tokens
-csharp_style_namespace_declarations = file_scoped:error
+dotnet_diagnostic.IDE0055.severity = warning # apply formatting (dotnet-format)
+dotnet_diagnostic.IDE0011.severity = warning # add braces; csharp_prefer_braces is true by default but ships silent
+
+# Bug detectors escalated to error — fail the build, not just nag
+dotnet_diagnostic.CA1849.severity = error # call async methods in async context
+dotnet_diagnostic.CA1853.severity = error # unnecessary ContainsKey before indexer
+dotnet_diagnostic.CA1854.severity = error # prefer IDictionary.TryGetValue
+dotnet_diagnostic.CA1862.severity = error # use StringComparison overloads (no ToLower/ToUpper for compare)
+dotnet_diagnostic.CA2016.severity = error # forward CancellationToken to async calls
+dotnet_diagnostic.CA2017.severity = error # logging template parameter count mismatch
+dotnet_diagnostic.CA2023.severity = error # invalid braces in logging message template
+dotnet_diagnostic.CA2200.severity = error # rethrow correctly to preserve stack trace
+dotnet_diagnostic.CA2245.severity = error # do not assign property to itself
+dotnet_diagnostic.CS0659.severity = error # override Equals without GetHashCode
+dotnet_diagnostic.CS1717.severity = error # variable assigned to itself
+dotnet_diagnostic.CS1718.severity = error # comparison made to same variable
+
+# Non-default option values
+csharp_style_namespace_declarations = file_scoped
+csharp_using_directive_placement = outside_namespace
+dotnet_sort_system_directives_first = true
+dotnet_separate_import_directive_groups = false
+dotnet_style_namespace_match_folder = true
+
+# ReSharper / Rider inspection suppressions
 resharper_entity_framework_model_validation_unlimited_string_length_highlighting = none
 
-
-#########################
-# VS added settings #
-#########################
-
-[*.cs]
-csharp_style_namespace_declarations = file_scoped:error
-csharp_indent_labels = one_less_than_current
-csharp_using_directive_placement = outside_namespace:silent
-csharp_prefer_simple_using_statement = true:suggestion
-csharp_prefer_braces = true:silent
-csharp_style_prefer_method_group_conversion = true:silent
-csharp_style_prefer_top_level_statements = true:silent
-csharp_style_prefer_primary_constructors = true:suggestion
-csharp_style_expression_bodied_methods = false:silent
-csharp_style_expression_bodied_constructors = false:silent
-csharp_style_expression_bodied_operators = false:silent
-csharp_style_expression_bodied_properties = true:silent
-csharp_style_expression_bodied_indexers = true:silent
-csharp_style_expression_bodied_accessors = true:silent
-csharp_style_expression_bodied_lambdas = true:silent
-csharp_style_expression_bodied_local_functions = false:silent
-
-[{*.yaml,*.yml}]
-dotnet_style_namespace_match_folder = true:suggestion
-dotnet_style_operator_placement_when_wrapping = beginning_of_line
-tab_width = 3
-dotnet_style_coalesce_expression = true:suggestion
-dotnet_style_null_propagation = true:suggestion
-dotnet_style_prefer_is_null_check_over_reference_equality_method = true:suggestion
-dotnet_style_prefer_auto_properties = true:silent
-dotnet_style_object_initializer = true:suggestion
-dotnet_style_collection_initializer = true:suggestion
-dotnet_style_prefer_simplified_boolean_expressions = true:suggestion
-dotnet_style_prefer_conditional_expression_over_assignment = true:silent
-
-[*.csv]
-indent_style = tab
-tab_width = 4
+# ReSharper / Rider — brace enforcement for Rider Code Cleanup (mirrors IDE0011 scope)
+resharper_braces_for_ifelse = required
+resharper_braces_for_for = required
+resharper_braces_for_foreach = required
+resharper_braces_for_while = required
+resharper_braces_for_dowhile = required
+resharper_braces_for_using = required
+resharper_braces_for_lock = required
+resharper_braces_for_fixed = required
+
+# ReSharper / Rider — attributes on their own line (Roslyn/dotnet format has no equivalent; Rider Reformat applies it)
+resharper_csharp_place_attribute_on_same_line = never
+
+# Naming. More-specific rules first (Roslyn matches the first applicable rule).
+# Const fields: PascalCase regardless of accessibility (Framework Design Guidelines).
+dotnet_naming_rule.const_fields_pascal.severity = warning
+dotnet_naming_rule.const_fields_pascal.symbols = const_fields
+dotnet_naming_rule.const_fields_pascal.style = pascal_case
+dotnet_naming_symbols.const_fields.applicable_kinds = field
+dotnet_naming_symbols.const_fields.applicable_accessibilities = *
+dotnet_naming_symbols.const_fields.required_modifiers = const
+
+# Static readonly fields: PascalCase (treated as compile-time-ish constants).
+dotnet_naming_rule.static_readonly_pascal.severity = warning
+dotnet_naming_rule.static_readonly_pascal.symbols = static_readonly_fields
+dotnet_naming_rule.static_readonly_pascal.style = pascal_case
+dotnet_naming_symbols.static_readonly_fields.applicable_kinds = field
+dotnet_naming_symbols.static_readonly_fields.applicable_accessibilities = *
+dotnet_naming_symbols.static_readonly_fields.required_modifiers = static, readonly
+
+# Mutable private/internal instance fields: _camelCase.
+dotnet_naming_rule.private_fields_underscore.severity = warning
+dotnet_naming_rule.private_fields_underscore.symbols = private_fields
+dotnet_naming_rule.private_fields_underscore.style = underscore_camel
+dotnet_naming_symbols.private_fields.applicable_kinds = field
+dotnet_naming_symbols.private_fields.applicable_accessibilities = private, internal
+
+dotnet_naming_style.pascal_case.capitalization = pascal_case
+dotnet_naming_style.underscore_camel.required_prefix = _
+dotnet_naming_style.underscore_camel.capitalization = camel_case

.github/workflows/main.yml

@@ -7,7 +7,7 @@ env:
 
 on:
   push:
-    branches: [main]
+    branches: [ main ]
 
 permissions:
   contents: read
@@ -31,8 +31,8 @@ jobs:
       - name: Build
         run: dotnet build ${{ env.PROJECT_PATH }} --no-restore --configuration Release
 
-#      - name: Test
-#        run: dotnet test --no-build --configuration Release --verbosity normal
+      #      - name: Test
+      #        run: dotnet test --no-build --configuration Release --verbosity normal
 
       - name: Pack
         run: dotnet pack ${{ env.PROJECT_PATH }} --no-build --configuration Release --output ${{ env.OUTPUT_DIR }}
@@ -70,4 +70,4 @@ jobs:
               --api-key "$NUGET_API_KEY" \
               --source "${{ env.NUGET_SOURCE }}" \
               --skip-duplicate
-          fi
+          fi

.gitignore

@@ -6,6 +6,10 @@
 # dotenv files
 .env
 
+# MaxMind GeoIP databases — consumer's licensed artifact, mounted at runtime (Geo:DatabasePath).
+# Never commit: EULA forbids redistribution, file is ~tens of MB and refreshed weekly.
+*.mmdb
+
 # User-specific files
 *.rsuser
 *.suo
@@ -88,6 +92,8 @@ StyleCopReport.xml
 *.pgc
 *.pgd
 *.rsp
+# but not Directory.Build.rsp, as it configures directory-level build defaults
+!Directory.Build.rsp
 *.sbr
 *.tlb
 *.tli
@@ -422,10 +428,6 @@ autom4te.cache/
 tarballs/
 test-results/
 
-# Mac bundle stuff
-*.dmg
-*.app
-
 # content below from: https://github.com/github/gitignore/blob/main/Global/macOS.gitignore
 # General
 .DS_Store
@@ -484,7 +486,7 @@ $RECYCLE.BIN/
 *.swp
 
 # Added by me
-logs
-LocalFileStorage
+.logs
+.LocalFileStorage
 *.db*
-**.claude
+*.claude

CLAUDE.md

@@ -119,7 +119,7 @@ Three modes: `Disabled`, `EnabledForClients` (blocks non-admin routes), `Enabled
 
 ## Code Style
 
-- 3-space indentation
+- 4-space indentation
 - File-scoped namespaces
 - C# 14 extension members for clean builder APIs
 - `partial class` + `[LoggerMessage]` for high-performance structured logging

README.md

@@ -210,7 +210,7 @@ builder.AddSerilog(
 ### Log Backends
 
 | Value           | Output format                                     |
-|-----------------|----------------------------------------------------|
+|-----------------|---------------------------------------------------|
 | `None`          | Console only, no file output                      |
 | `ElasticSearch` | ECS JSON to file (forward with Filebeat/Logstash) |
 | `Loki`          | Loki JSON to file (forward with Promtail)         |
@@ -382,8 +382,10 @@ The list accepts comma- or semicolon-separated URLs. Invalid entries are logged
 Built on Polly via `Microsoft.Extensions.Http.Resilience`. Two pipeline variants share the same configuration constants
 from a single source of truth:
 
-- **General pipeline** — registered globally via `AddResilienceDefaultPipeline()` on the builder, or used manually via `ResiliencePipelineProvider<string>`
-- **HTTP pipeline** — attached per-client via `AddResilienceDefaultPipeline()` on an `IHttpClientBuilder`, with additional `Retry-After` header support for 429 responses
+- **General pipeline** — registered globally via `AddResilienceDefaultPipeline()` on the builder, or used manually via
+  `ResiliencePipelineProvider<string>`
+- **HTTP pipeline** — attached per-client via `AddResilienceDefaultPipeline()` on an `IHttpClientBuilder`, with
+  additional `Retry-After` header support for 429 responses
 
 ### Options