mo-development

What problem does it solve?

Provides clear, enforceable guidance to developers building Monica .NET modules and hosted services so modules are correctly registered, configured, and observable across host and web runtimes.

Core Features & Use Cases

• Module pattern and registration: Explains the Module{Name}, Option, Guide, and BuilderExtensions pattern and how to claim dependencies and register modules consistently.
• Unified result model and boundaries: Defines when to use Res/Res<T> at UI-facing boundaries and when internal services should use standard .NET returns and exceptions.
• Hosted-service observability: Describes MoBackgroundService, RecordState usage, heartbeat, history sizing, and CoordinatedLeaderService for leader-aware tasks.
• Use case: Convert an internal background task into a well-behaved Monica hosted service that records operational state, validates required guide configuration keys, and downgrades safely from web to non-web hosting when needed.

Quick Start

Ask for step-by-step guidance to create a new Monica module that registers a facade returning Res<T>, declares dependencies, and adds a MoBackgroundService using RecordState for observability.