Skip to content
bitzorcas
EN

Reference

Overview

Release notes and version history for BitzOrcas.Modern.

Last updated

Notable changes to the project, newest first.

2026-06-22 — Architecture template & code generation

  • Code generation CLI — Added EF Core adapter templates and integration event templates, scaffolding now covers both SqlSugar + EF Core ORM paths.
  • Minimal runnable template — Added a dotnet new solution template that generates a complete project skeleton (BuildingBlocks + Hosts + Platform + Tests) from scratch.
  • Seed framework — Introduced ISeedStep / SeedRunner / CsvSeedReader / CsvSeedStepBase seed framework infrastructure, supporting CSV-driven reproducible seed data.

2026-06-21 — Documentation & ADRs

  • Architecture docs — Added target directory layout ADR and migration rules ADR, clarifying BuildingBlocks / Platform / Hosts namespace conventions and cross-layer reference constraints.
  • Developer guides — Added module development guide and adapter development guide, covering IAppModule contract, five-part structure, and adapter status matrix (Default / Production / Optional / Unavailable).

2026-06-20 — CI hardening & API refactor

  • Quality gates — Promoted trim publish from a soft gate to a hard gate. verify-all.sh now enforces dotnet publish -p:PublishTrimmed=true checks.
  • CI pipeline — Optimized GitHub Actions workflow structure and caching strategy.
  • API Host — Refactored service composition registration and endpoint mapping into per-module extension methods. Replaced Caller with CurrentUser type to unify user context.
  • Default adapters — Added default adapter implementations to ensure DI closure, so the Host builds successfully even with no business modules registered.
  • Observability — Added BitzOrcasActivitySources naming convention tests, enforcing a unified naming scheme for all ActivitySources.

2026-06-19 — Persistence unification

  • Persistence base classes — Unified persistence entity base classes and primary key generation (Snowflake ID), eliminating primary key type discrepancies between SqlSugar and EF Core adapters.
  • Catalog module — Implemented Catalog management module with related contract definitions.

2026-06-18 — Platform modules batch

First complete batch of business modules, covering domain logic, persistence adapters, and contract interfaces for 7 platform modules.

  • Audit module — Implemented audit sharded routing and periodic retention cleanup (6 audit categories, Quartz-scheduled cleanup).
  • Notifications module — Implemented core notification platform (multi-channel notification dispatch).
  • Files module — Implemented file asset upload, confirmation, download authorization, and deletion (S3-compatible storage).
  • Platform Billing module — Initialized platform billing module foundation and core services.
  • Tickets module — Implemented ticket platform core functionality and interfaces.
  • Chat module — Implemented chat channel core functionality with persistence support.
  • Webhooks — Implemented webhook subscription and signing mechanism.
  • Solution — Added complete Visual Studio solution files (.sln + .slnx).

2026-06-17 — Project initialization

BitzOrcas.Modern project created, establishing the core architecture baseline.

  • Module governance — Implemented IAppModule contract, module dependency graph, and startup validation.
  • API Key auth — Added API Key authentication scheme with integration test coverage.
  • Snowflake ID — Supported Snowflake ID machine and datacenter bit configuration, integrated with OpenTelemetry tracing.
  • Tenant unification — Unified tenant ID type to string, improved timezone and audit logic.
  • Code style — Added unified code style configuration and Git configuration files.