# MBC CQRS Serverless Framework > Production-ready CQRS and Event Sourcing framework for building serverless applications on AWS with NestJS, DynamoDB, and other AWS services. This file contains links to documentation sections following the llmstxt.org standard. ## Getting Started - [CLI](https://mbc-cqrs-serverless.mbc-net.com/docs/cli): MBC CQRS Serverless CLI tool for scaffolding projects, generating modules, and managing your serverless application. - [Introduction](https://mbc-cqrs-serverless.mbc-net.com/docs/getting-started): Introduction to MBC CQRS Serverless framework - a production-ready CQRS and Event Sourcing framework for AWS serverless applications. - [Installation](https://mbc-cqrs-serverless.mbc-net.com/docs/installation): Install and set up MBC CQRS Serverless framework with system requirements, CLI scaffolding, and local development environment. - [Project structure](https://mbc-cqrs-serverless.mbc-net.com/docs/project-structure): Overview of the MBC CQRS Serverless project file and folder structure generated by the CLI scaffolding tool. ## Tutorials - [Build a Todo App](https://mbc-cqrs-serverless.mbc-net.com/docs/build-todo-app): Build a complete Todo application step by step, learning CQRS patterns along the way. - [Quickstart Tutorial](https://mbc-cqrs-serverless.mbc-net.com/docs/quickstart-tutorial): Build your first MBC CQRS Serverless application in 15 minutes. ## Core Concepts - [CQRS Pattern Flow](https://mbc-cqrs-serverless.mbc-net.com/docs/architecture/cqrs-flow): How commands and queries flow through the CQRS pattern including command publishing, DynamoDB Streams, data synchronization, and query separation. - [Event Sourcing Pattern](https://mbc-cqrs-serverless.mbc-net.com/docs/architecture/event-sourcing): Event Sourcing in MBC CQRS Serverless - how events are stored in DynamoDB command/history tables for audit trails and time-travel debugging. - [System Architecture Overview](https://mbc-cqrs-serverless.mbc-net.com/docs/architecture/system-overview): Overview of the MBC CQRS Serverless framework architecture including NestJS, DynamoDB, AWS Lambda, and CQRS/Event Sourcing patterns. - [Architecture](https://mbc-cqrs-serverless.mbc-net.com/docs/architecture): Comprehensive overview of MBC CQRS Serverless framework architecture including system overview, CQRS pattern flow, Event Sourcing, Step Functions, and CDK infrastructure. - [Entity Definition Patterns](https://mbc-cqrs-serverless.mbc-net.com/docs/entity-patterns): Learn how to define entities, DTOs, and attributes for your domain. - [Key Design Patterns](https://mbc-cqrs-serverless.mbc-net.com/docs/key-patterns): Learn about partition key (PK) and sort key (SK) design patterns for DynamoDB. ## Backend Development - [Backend Development Guide](https://mbc-cqrs-serverless.mbc-net.com/docs/backend-development): Comprehensive guide for backend development with MBC CQRS Serverless framework. Learn module structure, service patterns, and best practices. - [Building your application](https://mbc-cqrs-serverless.mbc-net.com/docs/build-your-application): Build scalable serverless applications with MBC CQRS Serverless framework using NestJS, DynamoDB, and AWS services. - [Controllers](https://mbc-cqrs-serverless.mbc-net.com/docs/controllers): Learn how to create NestJS controllers with MBC CQRS Serverless decorators for routing, authentication, and tenant context. - [Data Sync Handler Examples](https://mbc-cqrs-serverless.mbc-net.com/docs/data-sync-handler-examples): Practical examples of implementing Data Sync Handlers for various use cases. - [Event Handling Patterns](https://mbc-cqrs-serverless.mbc-net.com/docs/event-handling-patterns): Learn patterns for handling events from S3, Step Functions, SQS, and DynamoDB streams in MBC CQRS Serverless. - [Import/Export Patterns](https://mbc-cqrs-serverless.mbc-net.com/docs/import-export-patterns): Learn patterns for importing and exporting data in CSV and Excel formats with batch processing and validation. - [Modules](https://mbc-cqrs-serverless.mbc-net.com/docs/modules): Learn how to create and configure modules in MBC CQRS Serverless. - [Multi-Tenant Patterns](https://mbc-cqrs-serverless.mbc-net.com/docs/multi-tenant-patterns): Learn how to implement multi-tenant data isolation and cross-tenant operations in MBC CQRS Serverless. - [Service Implementation Patterns](https://mbc-cqrs-serverless.mbc-net.com/docs/service-patterns): Learn how to implement service layer with CRUD operations using CommandService and DataService. ## Modules - [API Reference](https://mbc-cqrs-serverless.mbc-net.com/docs/api-reference): Comprehensive API reference for MBC CQRS Serverless framework modules. - [CommandService](https://mbc-cqrs-serverless.mbc-net.com/docs/command-service): Learn how to use CommandModule and CommandService for publishing and managing commands. - [DataService](https://mbc-cqrs-serverless.mbc-net.com/docs/data-service): Learn how to use DataService for querying data from DynamoDB tables. - [Directory](https://mbc-cqrs-serverless.mbc-net.com/docs/directory): Directory management module with S3 integration for file and folder management in multi-tenant serverless applications. - [EmailService](https://mbc-cqrs-serverless.mbc-net.com/docs/email-service): Send emails using AWS SES with the EmailService module, including attachments and inline templates with dynamic data. - [Master](https://mbc-cqrs-serverless.mbc-net.com/docs/master): Learn about the Master Service for managing master data and settings in a multi-tenant environment. - [Notification](https://mbc-cqrs-serverless.mbc-net.com/docs/notification-module): Learn about real-time notifications and email services in MBC CQRS Serverless. - [Sequence](https://mbc-cqrs-serverless.mbc-net.com/docs/sequence): Generate auto-incrementing sequence numbers for business IDs with customizable formats and rotation cycles using the SequencesModule. - [Serialization Helpers](https://mbc-cqrs-serverless.mbc-net.com/docs/serialization): Learn how to use serialization helpers for data structure conversion - [Task](https://mbc-cqrs-serverless.mbc-net.com/docs/tasks): Learn how to create and manage long-running background tasks with AWS Step Functions, task tokens, and the TasksModule. - [Tenant](https://mbc-cqrs-serverless.mbc-net.com/docs/tenant): Learn how to use TenantModule for multi-tenant management in MBC CQRS Serverless. - [UI Setting](https://mbc-cqrs-serverless.mbc-net.com/docs/ui-setting): Learn how to manage UI settings and data configurations with the UI Setting module. - [Versioning Rules](https://mbc-cqrs-serverless.mbc-net.com/docs/version-rules): Understand the optimistic locking strategy using version numbers for concurrent command processing and conflict resolution in MBC CQRS Serverless. ## Infrastructure - [CDK Infrastructure](https://mbc-cqrs-serverless.mbc-net.com/docs/architecture/cdk-infrastructure): Learn about AWS CDK infrastructure provisioning and system architecture in the MBC CQRS Serverless framework. - [Step Functions](https://mbc-cqrs-serverless.mbc-net.com/docs/architecture/step-functions): Learn how to implement AWS Step Functions for workflow orchestration in the MBC CQRS Serverless framework. - [DynamoDB](https://mbc-cqrs-serverless.mbc-net.com/docs/dynamodb): Learn about DynamoDB table design and management in MBC CQRS Serverless. - [Prisma](https://mbc-cqrs-serverless.mbc-net.com/docs/prisma): Integrate Prisma ORM with MBC CQRS Serverless for RDS database access and data synchronization from DynamoDB. ## Frontend Development - [API Integration Patterns](https://mbc-cqrs-serverless.mbc-net.com/docs/api-integration-patterns): Learn how to integrate with backend APIs using generated OpenAPI SDKs for type-safe API calls. - [Form Handling Patterns](https://mbc-cqrs-serverless.mbc-net.com/docs/form-handling-patterns): Learn how to handle forms effectively using React Hook Form with Zod validation. - [Frontend Project Structure](https://mbc-cqrs-serverless.mbc-net.com/docs/frontend-project-structure): Learn how to structure your Next.js frontend project for MBC CQRS Serverless applications. - [Master Web](https://mbc-cqrs-serverless.mbc-net.com/docs/master-web): Learn about the Master Web package for building master data management UI components. - [State Management Patterns](https://mbc-cqrs-serverless.mbc-net.com/docs/state-management-patterns): Learn how to manage state effectively in your frontend applications using Context API, axios, and Apollo Client. - [Survey Web](https://mbc-cqrs-serverless.mbc-net.com/docs/survey-web): Learn about the Survey Web package for building survey and questionnaire UI components. ## Security - [Authentication](https://mbc-cqrs-serverless.mbc-net.com/docs/authentication): Learn how to use and customize authentication and authorization. - [Security Best Practices](https://mbc-cqrs-serverless.mbc-net.com/docs/security-best-practices): Security best practices for building secure applications with MBC CQRS Serverless. ## Deployment & Operations - [CI/CD with CodePipeline](https://mbc-cqrs-serverless.mbc-net.com/docs/codepipeline-cicd): Set up continuous integration and deployment with AWS CodePipeline. - [Deployment Guide](https://mbc-cqrs-serverless.mbc-net.com/docs/deployment-guide): Learn how to deploy your MBC CQRS Serverless application to AWS. - [Monitoring and Logging](https://mbc-cqrs-serverless.mbc-net.com/docs/monitoring-logging): Set up monitoring and logging for your MBC CQRS Serverless application. ## Configuration - [Absolute Imports and Module Path Aliases](https://mbc-cqrs-serverless.mbc-net.com/docs/absolute_imports_and_module_path_aliases): Configure module path aliases that allow you to remap certain import paths. - [Configuring](https://mbc-cqrs-serverless.mbc-net.com/docs/configuring): Configuration guide for MBC CQRS Serverless framework including TypeScript, ESLint, and project settings. - [Environment Variables](https://mbc-cqrs-serverless.mbc-net.com/docs/environment-variables): Learn how to add and validate your environment variables in your application. ## Testing - [End-to-end Tests](https://mbc-cqrs-serverless.mbc-net.com/docs/e2e-test): Learn how to write and run end-to-end tests for MBC CQRS Serverless applications using Jest and LocalStack. - [Testing](https://mbc-cqrs-serverless.mbc-net.com/docs/testing): Comprehensive testing guide for MBC CQRS Serverless applications, covering unit testing, integration testing, and E2E testing strategies. - [Unit Tests](https://mbc-cqrs-serverless.mbc-net.com/docs/unit-test): Learn how to write unit tests for MBC CQRS Serverless services, handlers, and commands using Jest and mocking patterns. ## Troubleshooting - [Common Issues](https://mbc-cqrs-serverless.mbc-net.com/docs/common-issues): Solutions to common issues encountered when using MBC CQRS Serverless. - [Debugging Guide](https://mbc-cqrs-serverless.mbc-net.com/docs/debugging-guide): Learn debugging techniques for MBC CQRS Serverless applications. ## Examples - [E-commerce Example](https://mbc-cqrs-serverless.mbc-net.com/docs/ecommerce-example): Complete E-commerce implementation example with order management, inventory, and multi-tenant support. - [Examples](https://mbc-cqrs-serverless.mbc-net.com/docs/recipes): Practical examples and implementation guides for common use cases in MBC CQRS Serverless framework. - [SaaS Application Example](https://mbc-cqrs-serverless.mbc-net.com/docs/saas-example): Multi-tenant SaaS application example with subscription management, usage tracking, and billing integration. - [Survey Template](https://mbc-cqrs-serverless.mbc-net.com/docs/survey-template): Survey template management module for building dynamic multi-tenant surveys and questionnaires in MBC CQRS Serverless. ## AI Integration - [AI Integration](https://mbc-cqrs-serverless.mbc-net.com/docs/ai-integration): Integrate AI development tools with MBC CQRS Serverless using llms.txt, MCP server, and AI-optimized documentation. - [AI Prompts Library](https://mbc-cqrs-serverless.mbc-net.com/docs/ai-prompts): Optimized prompts for AI-assisted development with MBC CQRS Serverless. - [MCP Server](https://mbc-cqrs-serverless.mbc-net.com/docs/mcp-server): MCP Server for AI tool integration with MBC CQRS Serverless. ## Reference - [Anti-Patterns Guide](https://mbc-cqrs-serverless.mbc-net.com/docs/anti-patterns): Common anti-patterns to avoid when developing with MBC CQRS Serverless framework. - [Error Catalog](https://mbc-cqrs-serverless.mbc-net.com/docs/error-catalog): Comprehensive error catalog with causes, solutions, and recovery strategies for MBC CQRS Serverless. - [Glossary](https://mbc-cqrs-serverless.mbc-net.com/docs/glossary): Comprehensive glossary of terms used in MBC CQRS Serverless framework. - [Helper Functions](https://mbc-cqrs-serverless.mbc-net.com/docs/helpers): Reference guide for helper functions available in MBC CQRS Serverless. - [Interfaces](https://mbc-cqrs-serverless.mbc-net.com/docs/interfaces): Complete reference of TypeScript interfaces used in MBC CQRS Serverless framework. ## Changelog - [Changelog](https://mbc-cqrs-serverless.mbc-net.com/docs/changelog): Track all notable changes, new features, and bug fixes in MBC CQRS Serverless releases. ## Other - [API Integration Guide](https://mbc-cqrs-serverless.mbc-net.com/docs/api-integration-guide): Learn how to integrate with external APIs and receive webhooks in MBC CQRS Serverless applications. - [Data Migration Patterns](https://mbc-cqrs-serverless.mbc-net.com/docs/data-migration-patterns): Learn data migration strategies for cross-tenant operations, schema evolution, and bulk data processing in MBC CQRS Serverless. - [Database Selection Guide](https://mbc-cqrs-serverless.mbc-net.com/docs/database-selection-guide): Learn how to choose between DynamoDB and RDS for different query scenarios in MBC CQRS Serverless. - [Import](https://mbc-cqrs-serverless.mbc-net.com/docs/import): Learn how to use ImportModule for bulk data import with CSV and ZIP file support in MBC CQRS Serverless. - [Migration Guide: v1.1.0](https://mbc-cqrs-serverless.mbc-net.com/docs/migration/v1.1.0): Migration guide for upgrading to MBC CQRS Serverless v1.1.0, including TENANT_COMMON breaking change and tenant code normalization. - [Migration Guide: v1.2.0](https://mbc-cqrs-serverless.mbc-net.com/docs/migration/v1.2.0): Migration guide for upgrading to MBC CQRS Serverless v1.2.0, including publishSync null return behavior. - [Migration Guide: v1.3.0](https://mbc-cqrs-serverless.mbc-net.com/docs/migration/v1.3.0): Migration guide for upgrading to MBC CQRS Serverless v1.3.0, including nodemailer v8 upgrade and AppSyncService.sendMessage return type change. - [Migration Guide: v1.3.1](https://mbc-cqrs-serverless.mbc-net.com/docs/migration/v1.3.1): Migration guide for upgrading to MBC CQRS Serverless v1.3.1, including group-based role authorization. - [Queue Module](https://mbc-cqrs-serverless.mbc-net.com/docs/queue): Learn about the QueueModule, SnsService, and SqsService for messaging in MBC CQRS Serverless. - [Version Conflict Guide](https://mbc-cqrs-serverless.mbc-net.com/docs/version-conflict-guide): Learn how to handle version conflicts and implement concurrency control strategies - [Web Packages Changelog](https://mbc-cqrs-serverless.mbc-net.com/docs/web-changelog): Track all notable changes, new features, and bug fixes in MBC CQRS Serverless Web packages.