Guides for developers working on the FIVUCSAS platform.
START HERE: CLAUDE.md - Main developer guide with:
- Project overview and current status
- Architecture principles (SOLID, Clean Architecture, DRY, KISS, YAGNI)
- Repository structure
- Development workflow for each component
- Common development tasks
- Key design patterns used
- Critical conventions
- Troubleshooting guides
| File | Description |
|---|---|
| CLAUDE.md | Main developer guide - START HERE |
| KOTLIN_MULTIPLATFORM_GUIDE.md | Mobile/desktop app development |
| IMPLEMENTATION_GUIDE.md | Complete implementation details |
| TECHNOLOGY_DECISIONS.md | Technology stack decisions |
| UX_DESIGN_GUIDE.md | UX design guidelines |
| PRECOMMIT_HOOKS.md | Pre-commit hook setup |
This codebase strictly follows:
- Hexagonal Architecture (Ports and Adapters)
- SOLID Principles (Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, Dependency Inversion)
- Clean Architecture with clear separation of concerns
- MVVM Pattern for presentation layer
- Repository Pattern for data access
- DRY (Don't Repeat Yourself)
- KISS (Keep It Simple, Stupid)
- YAGNI (You Aren't Gonna Need It)
All new code MUST adhere to these principles.
- Architecture - System architecture
- Testing - Testing guides
- API - API documentation