motovaultpro/AI_README.md

MotoVaultPro - AI-First Modified Feature Capsule Architecture

AI Quick Start (50 tokens)

Vehicle management platform using Modified Feature Capsules. Each feature in backend/src/features/[name]/ is 100% self-contained with API, domain, data, migrations, external integrations, tests, and docs. Single directory load gives complete context. No shared business logic, only pure utilities in shared-minimal/.

Navigation

• Feature work: Load entire backend/src/features/[feature]/
• Cross-feature: Load each feature's index.ts and README.md
• System tools: backend/src/_system/ for migrations and schema
• AI metadata: .ai/ directory

Feature Capsule Structure

features/[name]/
├── README.md          # Feature overview & API
├── index.ts           # Public exports only
├── api/               # HTTP layer
├── domain/            # Business logic
├── data/              # Database layer
├── migrations/        # Feature's schema
├── external/          # Feature's external APIs
├── events/            # Event handlers
├── tests/             # All tests
└── docs/              # Documentation

Primary Entry Points

• Backend: backend/src/index.ts → backend/src/app.ts
• Frontend: frontend/src/main.tsx → frontend/src/App.tsx
• Features: backend/src/features/[name]/index.ts