feat: Add Multitenancy module with tenant management and database orchestration

- Introduced Multitenancy module for managing tenants, configurations, and migrations.
- Implemented tenant health checks and endpoints for CRUD operations.
- Added documentation for module responsibilities, architecture, and usage.

docs: Create guide for using the framework in .NET 10 Web API

- Provided detailed instructions on project references, Mediator configuration, and module registration.
- Included steps for setting up the HTTP pipeline and application settings.
- Explained how to add custom modules and adhere to coding standards.

feat: Design spec for Eventing building block

- Defined goals and non-goals for the Eventing building block.
- Established conceptual model differentiating domain events from integration events.
- Outlined abstractions for event handling, including IIntegrationEvent, IEventBus, and IEventSerializer.
- Implemented Outbox and Inbox patterns for reliable event processing.
- Integrated eventing with Identity module for user registration events.

Author: iammukeshm

.gitignore

@@ -485,5 +485,4 @@ $RECYCLE.BIN/
 
 # Vim temporary swap files
 *.swp
-/.bmad
-/docs
+/.bmad

docs/framework/README.md

@@ -0,0 +1,49 @@
+# FSH Framework Documentation Index
+
+This folder contains framework-level documentation for the fullstackhero .NET 10 starter kit.
+
+Use these documents as the primary reference for both human developers and AI agents when working in this repo.
+
+## Overview
+
+- `architecture.md`  
+  High-level architecture of the framework: BuildingBlocks, Modules, Playground, cross-cutting concerns (auth, persistence, DDD, mediator, validation, exceptions, multitenancy, health, OpenTelemetry, rate limiting, versioning, etc.).
+
+- `building-blocks.md`  
+  Detailed description of the BuildingBlocks projects:
+  - Core, Persistence, Caching, Mailing, Jobs, Storage, Web.
+  - How they are meant to be used by modules and hosts.
+
+- `module-identity.md`  
+  Identity module deep dive:
+  - Endpoints, token generation/refresh, ASP.NET Identity integration.
+  - Persistence model (`FshUser`, `IdentityDbContext`), permissions, auditing, metrics.
+
+- `module-auditing.md`  
+  Auditing module deep dive:
+  - `IAuditClient`, `ISecurityAudit`, audit envelopes and payloads.
+  - Audit querying endpoints, persistence, and integration with exceptions and security events.
+
+- `module-multitenancy.md`  
+  Multitenancy module deep dive:
+  - Tenant model, Finbuckle integration, migrations, health checks.
+  - Tenant APIs (status, migrations, upgrade, activation).
+
+- `using-framework-in-your-api.md`  
+  How to consume the framework in any .NET 10 Web API:
+  - Using `FSH.Playground.Api` as a reference.
+  - Wiring modules, BuildingBlocks, configuration, and Aspire/AppHost.
+
+- `developer-cookbook.md`  
+  Practical recipes for developers and AI agents:
+  - Add endpoints, modules, DbContexts, jobs.
+  - Use specifications, mailing, storage, observability.
+  - Guidance on patterns to follow and anti-patterns to avoid.
+
+- `contribution-guidelines.md`  
+  Contributor and coding guidelines:
+  - Folder and project layout.
+  - When to add modules vs. features.
+  - Patterns to follow (Minimal APIs, Mediator, FluentValidation, DDD, specifications).
+  - Security, multitenancy, and cross-cutting concerns expectations.
+  - AI-agent specific do’s and don’ts.