Back to News

docs: add whole-codebase modernization plan (14 phases + DI + event bus)

By Mohchangelogdawn
Changelog

- MODERNIZATION_PLAN: master doc (Parts A-F) — stratified-legacy map, target

modular-monolith, 6 design principles, Managers/partial folder convention,

the 4 proven in-repo templates, 14-phase roadmap, feedback/sacred-cows

- MODERNIZATION_BUS: spec for a source-generated, sync, zero-alloc domain-

event bus (struct messages, [DomainEventHandler] + [Order], Roslyn

generator emitting PublishCore dispatch; full event catalog; async

side-effects via background channels; when-NOT-to-bus discipline)

- MODERNIZATION_FILE_MAP: strict per-file responsibility map for all 1,240

files (becomes / DI lifetime / bus role / owning phase)

- MODERNIZATION_SAFETY: production rollout protocol — baseline stabilization,

dual-crypto-mode test gate (UseTQCrypto drives 18 branch sites), deploy

gate via update-primal-dev, per-phase rollback, no-behavior-change invariant

- PHASE_0..14: per-phase detail (generic host + MS.DI scaffolding, dead-code

purge, clock unification, Pipelines network, MySqlConnector async DB,

AssemblyLoadContext scripts, Kernel split into 5 DI services, WorldClient

partials, ReceiveDamage via the bus, Vision spatial index, combat/inventory/

social/scripting vertical slices, nullable+polish)