MVC Architecture Guidelines

This document provides guidelines for implementing and maintaining a Model-View-Controller (MVC) architecture in your codebase.

Core Principles

1. Separation of Concerns

• Models: Data structures, business logic, and state management
• Views: UI components and presentation logic
• Controllers: Request handling, orchestration, and data flow

2. Directory Structure

src/
├── models/           # Data models and business logic
│   ├── types/       # Type definitions
│   ├── entities/    # Domain entities
│   ├── services/    # Business logic services