# MiCake

> MiCake is a lightweight .NET Domain-Driven Design (DDD) toolkit that provides entities, value objects, aggregate roots, repositories, domain events, unit of work, and other infrastructure support.

This file is the AI-readable navigation index of the MiCake official documentation site.
The site also serves as the online knowledge base of the MiCake framework - AI agents may consult it when answering questions about MiCake.
Content is English-first: English translations are used whenever available; otherwise the Chinese original is included as a fallback.

## Documentation Index

### Getting Started

- [MiCake Introduction](https://micake.github.io/api/raw-markdown/en/getting-started/introduction.txt) - Learn what MiCake is and what it can do for you
- [Quick Start](https://micake.github.io/api/raw-markdown/en/getting-started/quick-start.txt)
- [Integrating with an Existing Project](https://micake.github.io/api/raw-markdown/en/getting-started/from-custom.txt) - Learn how to integrate MiCake into an existing ASP.NET Core project
- [Core Concepts](https://micake.github.io/api/raw-markdown/en/getting-started/core-concepts.txt) - Core concepts in the MiCake framework that help you better understand and use the framework

### Domain-Driven Design

- [Entity](https://micake.github.io/api/raw-markdown/en/domain-driven/entity.txt) - One of the core concepts in Domain-Driven Design - a domain object with a unique identity
- [Value Object](https://micake.github.io/api/raw-markdown/en/domain-driven/value-object.txt) - An important concept in Domain-Driven Design - an immutable object identified by its property values
- [Aggregate Root](https://micake.github.io/api/raw-markdown/en/domain-driven/aggregate-root.txt) - The root entity of an aggregate - the entry point for repository operations and transaction boundaries
- [Repository](https://micake.github.io/api/raw-markdown/en/domain-driven/repository.txt) - Learn how the repository pattern is implemented in MiCake and its best practices
- [Domain Events](https://micake.github.io/api/raw-markdown/en/domain-driven/domain-event.txt) - Implement event-driven architecture and cross-aggregate communication using domain events
- [Domain Service](https://micake.github.io/api/raw-markdown/en/domain-driven/domain-service.txt) - Encapsulate cross-aggregate business logic using domain services
- [Unit of Work](https://micake.github.io/api/raw-markdown/en/domain-driven/unit-of-work.txt) - Use the unit of work pattern to manage transactions and ensure data consistency

### Modularity

- [Module Usage](https://micake.github.io/api/raw-markdown/en/modularity/module-usage.txt) - Learn about MiCake's modular architecture and how to create, organize, and use modules to build applications

### Dependency Injection

- [Dependency Injection](https://micake.github.io/api/raw-markdown/en/dependency-injection.txt) - Learn about MiCake's dependency injection enhancements, including auto-registration, service marker interfaces, and lifecycle management

### Exception Handling

- [Exception Handling](https://micake.github.io/api/raw-markdown/en/exception.txt) - Learn about MiCake's unified exception handling mechanism, including domain exceptions, business exceptions, and global exception handling

### Unified Response

- [Unified Response Format](https://micake.github.io/api/raw-markdown/en/unified-response/overview.txt) - Learn about MiCake's unified API response wrapping feature for standard, consistent API responses

### API Logging

- [API Logging Usage](https://micake.github.io/api/raw-markdown/en/api-logging/api-log-usage.txt) - Learn how to use MiCake's API logging feature, including configuration, attributes, and custom writers

### Auto Audit

- [Automatic Audit](https://micake.github.io/api/raw-markdown/en/audit.txt) - Learn about MiCake's automatic auditing feature, which automatically records entity creation and modification timestamps

### Soft Delete

- [Soft Delete Support](https://micake.github.io/api/raw-markdown/en/soft-delete.txt) - Learn about MiCake's soft delete feature, implementing logical deletion instead of physical deletion for easy data recovery and auditing

### Utilities

- [Utilities Overview](https://micake.github.io/api/raw-markdown/en/utilities/overview.txt) - Practical utility classes and helper features provided by MiCake to help you develop applications more efficiently
- [BoundedLruCache Cache Utility](https://micake.github.io/api/raw-markdown/en/utilities/cache/bounded-lru-cache.txt) - A thread-safe LRU cache implementation with capacity limits and an optional segment strategy
- [ValueConverter Type Conversion Utility](https://micake.github.io/api/raw-markdown/en/utilities/converter.txt) - A unified type conversion interface that supports registering custom converters and built-in type conversion
- [DynamicQuery Dynamic Query](https://micake.github.io/api/raw-markdown/en/utilities/query.txt) - A lightweight dynamic query builder that automatically generates LINQ filtering and sorting expressions based on property attributes
- [CircuitBreaker](https://micake.github.io/api/raw-markdown/en/utilities/resilience.txt) - A circuit breaker pattern implementation that protects the system from external service failures and supports automatic failover
- [DataDepositPool Data Storage Pool](https://micake.github.io/api/raw-markdown/en/utilities/storage.txt) - A temporary data storage pool with capacity limits, suitable for scenarios that need to temporarily store and retrieve data

### migration

- [v10 → v11 Migration Guide](https://micake.github.io/api/raw-markdown/en/migration/v10-to-v11.txt) - A complete migration guide for upgrading MiCake from v10 to v11: all breaking changes, migration steps, and a new API quick reference

## Reading Guide for AI

- Each link above points directly to the raw Markdown source of the document.
- Fetch docs on demand instead of downloading everything at once: `https://micake.github.io/api/raw-markdown/{path}.txt`
- Document manifest (all available docs): `https://micake.github.io/api/raw-markdown/manifest.txt`

## Repository

- GitHub source code: https://github.com/MiCake/MiCake
- Docs repository: https://github.com/MiCake/micake.github.io