Layered Structure & Boundaries

Strict isolation of logic and UI through layers to ensure predictable development and zero side effects.

01Layer Constraints

Module Constraints

Maximum of 3 files in the root of the model. Mandatory index.ts and types.ts for all segments.

index.ts

types.ts

Subfolder Structure

config

schema

types

api

converters

Naming Convention

^[a-z0-9-]+\.(config|types|schema|converters|service)\.ts$

Import Governance

Valid Import

import-governance.ts

import { useAuthStore } from "@/entities/session"; // OK: feature -> entity
import { Button } from "@/shared/ui";         // OK: feature -> shared

Forbidden Violation

import-governance.ts

import { logoutFeature } from "@/features/auth"; // ERROR: entity -> feature (LAYER VIOLATION)

02Semantic Converters

Transformation layer ensuring the UI receives precise, ready-to-render data structures.

RAW DTO

LOCAL ENTITY

Entity Mapping

DTO Alignment

03Deterministic Tree Structure

Entity Slice

src/entities/invoice/

structure-tree.txt

├── api/             # API services (RTK Query)
├── types/           # Data structures
│   ├── index.ts
│   ├── invoice.interface.ts
│   └── invoice.types.ts
├── constants/       # Lists, mappings, defaults
├── converters/      # Data transformations
├── handlers/        # Business logic & validation
├── mock/            # Test data
├── ui/              # (Optional) Cards, list items
└── index.ts         # Public API

Widget Slice

src/widgets/accommodation-edit/

structure-tree.txt

├── model/           # Widget logic & state
│   ├── config/      # Form/column configs
│   ├── schema/      # Validation schemas (Zod)
│   ├── types/       # Local types
│   └── index.ts
├── ui/              # Internal display components
│   ├── general-info/
│   └── rooms/
├── accommodation-edit.tsx # Main component
└── index.ts         # Public API