Initial commit

2026-03-25 21:01:31 +03:00
commit a46a860f4e
111 changed files with 21805 additions and 0 deletions
--- a/domain/TOiR.domain.dsl
+++ b/domain/TOiR.domain.dsl
@@ -0,0 +1,236 @@
+/*
+  КИС ТОиР — демонстрационная схема доменной модели
+  Сущности: Equipment (Оборудование), EquipmentType (Вид оборудования), RepairOrder (Заявка на ремонт)
+*/
+
+enum EquipmentStatus {
+  value Active {
+    label "В эксплуатации";
+  }
+  value Repair {
+    label "В ремонте";
+  }
+  value Reserve {
+    label "В резерве";
+  }
+  value WriteOff {
+    label "Списано";
+  }
+}
+
+enum RepairKind {
+  value TO {
+    label "Техническое обслуживание";
+  }
+  value TR {
+    label "Текущий ремонт";
+  }
+  value TRE {
+    label "Текущий расширенный ремонт";
+  }
+  value KR {
+    label "Капитальный ремонт";
+  }
+  value AR {
+    label "Аварийный ремонт";
+  }
+  value MP {
+    label "Метрологическая поверка";
+  }
+}
+
+enum RepairOrderStatus {
+  value Draft {
+    label "Черновик";
+  }
+  value Approved {
+    label "Утверждена";
+  }
+  value InWork {
+    label "В работе";
+  }
+  value Done {
+    label "Выполнена";
+  }
+  value Cancelled {
+    label "Отменена";
+  }
+}
+
+entity EquipmentType {
+  description "Вид (марка) оборудования — нормативный справочник НСИ";
+
+  attribute code {
+    key primary;
+    description "Код вида оборудования";
+    type string;
+    is required;
+    is unique;
+  }
+
+  attribute name {
+    description "Наименование вида";
+    type string;
+    is required;
+  }
+
+  attribute manufacturer {
+    description "Производитель";
+    type string;
+  }
+
+  attribute maintenanceIntervalHours {
+    description "Периодичность ТО, моточасов";
+    type integer;
+  }
+
+  attribute overhaulIntervalHours {
+    description "Периодичность КР, моточасов";
+    type integer;
+  }
+}
+
+entity Equipment {
+  description "Единица оборудования — объект ремонта и технического обслуживания";
+
+  attribute id {
+    type uuid;
+    key primary;
+  }
+
+  attribute inventoryNumber {
+    description "Инвентарный номер";
+    type string;
+    is required;
+    is unique;
+  }
+
+  attribute serialNumber {
+    description "Заводской (серийный) номер";
+    type string;
+  }
+
+  attribute name {
+    description "Наименование единицы оборудования";
+    type string;
+    is required;
+  }
+
+  attribute equipmentTypeCode {
+    type string;
+    key foreign {
+      relates EquipmentType.code;
+    }
+    is required;
+  }
+
+  attribute status {
+    description "Текущий статус";
+    type EquipmentStatus;
+    default Active;
+    is required;
+  }
+
+  attribute location {
+    description "Место эксплуатации / скважина / куст";
+    type string;
+  }
+
+  attribute commissionedAt {
+    description "Дата ввода в эксплуатацию";
+    type date;
+  }
+
+  attribute totalEngineHours {
+    description "Общая наработка, моточасов";
+    type decimal;
+  }
+
+  attribute engineHoursSinceLastRepair {
+    description "Наработка с последнего ремонта, моточасов";
+    type decimal;
+  }
+
+  attribute lastRepairAt {
+    description "Дата последнего ремонта";
+    type date;
+  }
+
+  attribute notes {
+    description "Примечания";
+    type text;
+  }
+}
+
+entity RepairOrder {
+  description "Заявка на ремонт — формируется по ППР или по факту обнаруженного дефекта";
+
+  attribute id {
+    type uuid;
+    key primary;
+  }
+
+  attribute number {
+    description "Номер заявки";
+    type string;
+    is required;
+    is unique;
+  }
+
+  attribute equipmentId {
+    type uuid;
+    key foreign {
+      relates Equipment.id;
+    }
+    is required;
+  }
+
+  attribute repairKind {
+    description "Вид ремонта";
+    type RepairKind;
+    is required;
+  }
+
+  attribute status {
+    type RepairOrderStatus;
+    default Draft;
+    is required;
+  }
+
+  attribute plannedAt {
+    description "Плановая дата начала";
+    type date;
+    is required;
+  }
+
+  attribute startedAt {
+    description "Фактическая дата начала";
+    type date;
+  }
+
+  attribute completedAt {
+    description "Фактическая дата завершения";
+    type date;
+  }
+
+  attribute contractor {
+    description "Подрядная организация (если внешний ремонт)";
+    type string;
+  }
+
+  attribute engineHoursAtRepair {
+    description "Наработка на момент ремонта, моточасов";
+    type decimal;
+  }
+
+  attribute description {
+    description "Описание работ / дефекта";
+    type text;
+  }
+
+  attribute notes {
+    description "Примечания";
+    type text;
+  }
+}
+
--- a/domain/dsl-spec.md
+++ b/domain/dsl-spec.md
@@ -0,0 +1,217 @@
+# DSL Language Specification
+
+This document describes the single DSL (Domain Specific Language) used to specify fullstack CRUD applications. The only required DSL input is `domain/*.dsl`.
+
+`domain-summary.json` is a derived artifact generated from this DSL to stabilize LLM-first generation and feed the lightweight validation gate. It must never replace the DSL as the source of truth. The active prompt corpus that consumes this contract lives in `prompts/`.
+
+---
+
+# DSL Responsibility
+
+The domain DSL defines only:
+
+- domain model
+- relations
+- enums
+
+The domain DSL is the single source of truth for:
+
+- entities
+- attributes
+- primary keys
+- foreign keys
+- enums
+
+The following layers are always derived from the domain DSL and must not be authored as standalone authoritative DSL inputs:
+
+- DTO
+- API
+- UI
+
+Optional extension mechanism:
+
+```text
+overrides/
+  api-overrides.dsl
+  ui-overrides.dsl
+```
+
+Override rules:
+
+- Overrides are optional.
+- The generator must work without them.
+- Overrides may refine derived API or UI behavior, but they must not duplicate or redefine entities, attributes, primary keys, foreign keys, relations, or enums.
+
+---
+
+# DSL Grammar Concepts
+
+## entity
+
+An **entity** is a domain object that becomes a database table and a first-class resource in the backend and frontend.
+
+```
+entity Equipment {
+  attribute id { type uuid; key primary; }
+  attribute name { type string; is required; }
+}
+```
+
+- **Domain:** Defines the canonical model; one entity = one Prisma model, one NestJS module, one React Admin resource.
+- **Naming:** PascalCase (e.g. `Equipment`, `EquipmentType`, `RepairOrder`).
+
+---
+
+## attribute
+
+An **attribute** is a field of an entity. It has a type and optional modifiers.
+
+```
+attribute name {
+  description "Наименование";
+  type string;
+  is required;
+  is unique;
+}
+```
+
+**Modifiers:**
+
+- `type` — required; one of: `string`, `uuid`, `integer`, `decimal`, `date`, `text`, or an enum name.
+- `key primary` — this attribute is the primary key.
+- `key foreign { relates Entity.field }` — foreign key to another entity's field.
+- `is required` — non-nullable.
+- `is unique` — unique constraint.
+- `default Value` — default value (for enums or literals).
+- `description "..."` — human-readable description.
+
+---
+
+## enum
+
+An **enum** defines a fixed set of values. Used for attributes that can only take one of these values.
+
+```
+enum EquipmentStatus {
+  value Active { label "В эксплуатации"; }
+  value Repair { label "В ремонте"; }
+}
+```
+
+- **value** — identifier used in data and code.
+- **label** — optional display label for UI.
+
+---
+
+## primary key
+
+Exactly one attribute per entity must be marked as primary key.
+
+```
+attribute id {
+  type uuid;
+  key primary;
+}
+```
+
+Or for a natural key:
+
+```
+attribute code {
+  type string;
+  key primary;
+  is required;
+  is unique;
+}
+```
+
+---
+
+## foreign key
+
+A **foreign key** links to another entity's primary key. The attribute type must match the referenced primary key type.
+
+```
+attribute equipmentTypeCode {
+  type string;
+  key foreign {
+    relates EquipmentType.code;
+  }
+  is required;
+}
+```
+
+- `relates Entity.attribute` — references `Entity`'s `attribute` (must be primary key).
+- FK type must equal referenced PK type (e.g. `string` → `EquipmentType.code`, `uuid` → `Equipment.id`).
+
+---
+
+## required
+
+- **is required** — attribute is non-nullable in the domain model and drives requiredness in derived DTO/API/UI artifacts.
+- Absence of `is required` means the attribute is optional (nullable).
+
+---
+
+## default
+
+- **default Value** — applied when no value is provided (e.g. enum defaults like `default Active`).
+- Value must exist in the enum when the attribute type is an enum.
+
+---
+
+# DSL → System Component Mapping
+
+## DSL → Prisma
+
+| DSL Concept  | Prisma Result               |
+| ------------ | --------------------------- |
+| entity       | model                       |
+| attribute    | field                       |
+| enum         | enum                        |
+| key primary  | @id or @id @default(uuid()) |
+| key foreign  | relation + references       |
+| type string  | String                      |
+| type uuid    | String @id @default(uuid()) |
+| type integer | Int                         |
+| type decimal | Decimal                     |
+| type date    | DateTime                    |
+| type text    | String                      |
+
+---
+
+## DSL → NestJS
+
+| DSL Concept    | NestJS Result                         |
+| -------------- | ------------------------------------- |
+| entity         | One module (e.g. equipment.module.ts) |
+| entity         | Controller with CRUD endpoints        |
+| entity         | Service with Prisma CRUD              |
+| entity + attribute metadata | create-{entity}.dto.ts     |
+| entity + attribute metadata | update-{entity}.dto.ts     |
+| entity + attribute metadata | Response DTO / API shape   |
+
+API paths are derived from entity name: PascalCase → kebab-case, pluralized (e.g. `Equipment` → `/equipment`, `RepairOrder` → `/repair-orders`).
+
+---
+
+## DSL → React Admin
+
+| DSL Concept           | React Admin Result                  |
+| --------------------- | ----------------------------------- |
+| entity                | Resource (name = kebab-case plural) |
+| attribute             | Form field / column                 |
+| type string           | TextInput, TextField                |
+| type integer/decimal  | NumberInput, NumberField            |
+| type date             | DateInput, DateField                |
+| enum                  | SelectInput with choices            |
+| foreign key           | ReferenceInput, ReferenceField      |
+
+---
+
+# Derived Layer Mapping
+
+- **Create DTO** — derived from domain attributes and must not include generated primary keys (for example no `id` for uuid PKs).
+- **Update DTO** — derived from the same domain attributes with all fields optional for partial updates.
+- **API response shape** — derived from domain attributes and must expose React Admin-compatible identifiers when needed.
+- **UI field mapping** — derived from attribute types, descriptions, enums, and foreign keys without a separate UI DSL.