Project Naming and Folder Conventions

This document defines the naming conventions for the clinical system project. All code-level identifiers and documentation follow the English language to ensure professional standards and maintainability.

1. Directory Structure

The project follows a modular architecture. Each module contains its logic separated into layers:

• src/[module-name]/domain/: Contains domain entities and custom error classes.
• src/[module-name]/application/: Contains the Service classes that orchestrate use cases.
• src/[module-name]/infrastructure/: Contains repository implementations, controllers/routes and DTO schemas.
• src/[module-name]/views/: Contains Nunjucks templates for the module.

2. Naming Conventions

File Naming

All files must use kebab-case and include a suffix corresponding to their role in the architecture.

• Modules: src/appointments/, src/patients/
• Services: [name].service.js (e.g., appointment.service.js)
• Repositories: [name].repository.js (e.g., appointment.repository.js)
• Controllers: [name].controller.js (e.g., appointment.controller.js)
• Errors: [name].error.js (e.g., appointment-not-found.error.js)
• Templates: [action].njk (e.g., create-appointment.njk)

Class Naming