code-ai-installer 3.0.0 → 4.0.1-a

package/domains/development/.agents/skills/data-model/SKILL.md

@@ -1,284 +1,290 @@
----
-name: data-model
-description: Модель данных и стратегия хранения — нормализация/денормализация, индексы, транзакции, кэш, (опц.) event sourcing/eventual consistency — с trade-offs и привязкой к UX flows.
----
-
-# Skill: Data Model
-
-Модель данных: от entity definitions до query optimization.
-
-**Разделы:**
-1. [Входы](#1-входы)
-2. [Entity Definition Template](#2-entity-template)
-3. [ER Diagram](#3-er-diagram)
-4. [Data Patterns](#4-data-patterns)
-5. [Index Strategy](#5-indexes)
-6. [Query Pattern Mapping](#6-query-mapping)
-7. [Transactions](#7-transactions)
-8. [Migrations](#8-migrations)
-9. [Пример: полная модель](#9-пример)
-10. [Output Template](#10-output)
-
----
-
-## 1. Входы
-
-| Вход | Откуда | Зачем |
-|------|--------|-------|
-| PRD | PM gate | Acceptance criteria → entities, constraints |
-| UX Spec | UX gate | Screens/flows → query patterns |
-| API Contracts | Architect | Request/Response → fields, types |
-| NFR | System Design | Volume, latency, retention |
-
----
-
-## 2. Entity Definition Template
-
-Для каждой сущности:
-
-```markdown
-### Entity: Product
-
-**Collection:** `products`
-**Lifecycle:** Created by admin, read by public endpoint, deleted manually
-
-| Field | Type | Required | Default | Constraints | Description |
-|-------|------|----------|---------|-------------|-------------|
-| _id | ObjectId | auto | auto | unique | Primary key |
-| ownerId | string | ✅ | — | indexed | Owner/tenant reference |
-| name | string | ✅ | — | 3-100 chars | Product name |
-| price | number | ✅ | — | min: 0 | Product price |
-| category | string | ✅ | "general" | enum: general, premium, sale | Product category |
-| active | boolean | ⬜ | true | — | Is product visible |
-| viewCount | number | ⬜ | 0 | min: 0 | Times viewed |
-| createdAt | Date | auto | now | — | Timestamp |
-| updatedAt | Date | auto | now | — | Timestamp |
-
-**Unique constraints:** (ownerId, name)
-**Indexes:** See Index Strategy
-**Relationships:** belongs to Owner (via ownerId)
-**Storage pattern:** Reference (separate collection)
-**Rationale:** Products have independent lifecycle, unbounded per owner
-```
-
----
-
-## 3. ER Diagram
-
-```mermaid
-erDiagram
-    OWNER ||--|| SETTINGS : "has one"
-    OWNER ||--o{ PRODUCT : "has many"
-
-    OWNER {
-        ObjectId _id PK
-        string ownerId UK
-        string email
-        string name
-        string status
-        Date createdAt
-    }
-
-    SETTINGS {
-        ObjectId _id PK
-        string ownerId UK "FK → Owner"
-        object general
-        object appearance
-        object notifications
-        string theme
-        string templateId
-        object templateSettings
-    }
-
-    PRODUCT {
-        ObjectId _id PK
-        string ownerId "FK → Owner"
-        string name
-        number price
-        string category
-        boolean active
-        number viewCount
-        Date createdAt
-    }
-```
-
----
-
-## 4. Data Patterns
-
-### Embed vs Reference Decision
-
-| Критерий | Embed ✅ | Reference ✅ |
-|---------|---------|-------------|
-| Читаются вместе | Да | Нет |
-| Independent lifecycle | Нет | Да |
-| Bounded size | Да (< 50 items) | Unbounded |
-| Atomic updates child | Нужны | Не критично |
-
-### Decision table (для проекта)
-
-| Parent | Child | Pattern | Rationale |
-|--------|-------|---------|-----------|
-| Owner | Settings | **Embed** (или 1:1 ref) | Всегда читаются вместе, 1 settings per owner |
-| Owner | Products | **Reference** | Independent CRUD, unbounded, own pagination |
-| Settings | general/appearance/notifications | **Embed** | Bounded subdocuments, always read together |
-
-> Каждый выбор embed/reference = потенциальный ADR. Если неочевидно — создай `$adr-log`.
-
-### Caching (если применимо)
-
-| Data | Cache? | Strategy | TTL | Invalidation |
-|------|--------|----------|-----|--------------|
-| Public content | ✅ | HTTP Cache-Control | 60s | PUT settings → purge |
-| Product list | ⬜ | No cache (small, dashboard only) | — | — |
-| Settings (dashboard) | ⬜ | No cache (always fresh) | — | — |
-
----
-
-## 5. Index Strategy
-
-### Index → Query Pattern Mapping
-
-| Index | Fields | Type | Serves Query |
-|-------|--------|------|-------------|
-| `owners_ownerId` | `{ ownerId: 1 }` | unique | Lookup by ownerId |
-| `settings_ownerId` | `{ ownerId: 1 }` | unique | Lookup settings by owner |
-| `products_owner_name` | `{ ownerId: 1, name: 1 }` | unique | Duplicate check on create |
-| `products_owner_active_date` | `{ ownerId: 1, active: 1, createdAt: -1 }` | compound | List active products sorted by date |
-| `products_owner_date` | `{ ownerId: 1, createdAt: -1 }` | compound | List all products sorted |
-
-### Index rules
-
-| Правило | Описание |
-|---------|---------|
-| **ESR** | Equality → Sort → Range (порядок полей в compound) |
-| **Max 5-7** | Каждый index = write overhead |
-| **Verify** | `explain('executionStats')` → IXSCAN, не COLLSCAN |
-| **Partial** | Если index нужен не для всех docs: `partialFilterExpression` |
-
----
-
-## 6. Query Pattern Mapping
-
-Маппинг UX screen → query:
-
-| UX Screen | Action | Query | Index Used |
-|-----------|--------|-------|------------|
-| Dashboard: Products list | Load page | `find({ ownerId }).sort({ createdAt: -1 }).limit(20)` | `products_owner_date` |
-| Dashboard: Products list | Filter active | `find({ ownerId, active: true }).sort({ createdAt: -1 })` | `products_owner_active_date` |
-| Dashboard: Products list | Search by name | `find({ ownerId, name: { $regex } })` | `products_owner_name` (prefix) |
-| Dashboard: Settings | Load | `findOne({ ownerId })` | `settings_ownerId` |
-| Dashboard: Settings | Save | `updateOne({ ownerId }, { $set: ... })` | `settings_ownerId` |
-| Public Content | Load config | `findOne({ ownerId })` + `findOne({ ownerId, active: true }).sort({ createdAt: -1 })` | `settings_ownerId` + `products_owner_active_date` |
-| Webhook: register | Create | `updateOne({ ownerId }, { ... }, { upsert: true })` | `owners_ownerId` |
-
-### Performance notes
-
-| Query | Expected latency | Volume | Notes |
-|-------|-----------------|--------|-------|
-| Public content | < 10ms | Every page view | Add cache header |
-| Products list | < 20ms | Dashboard only | Paginated |
-| Settings load | < 5ms | Dashboard only | Single doc |
-
----
-
-## 7. Transactions
-
-### Когда нужны
-
-| Scenario | Transaction? | Rationale |
-|----------|:---:|-----------|
-| Create product | ⬜ No | Single collection write |
-| Update settings | ⬜ No | Single document update |
-| Process order (if order system) | ✅ Yes | Multi-doc: update order + decrement stock |
-| Register webhook (upsert owner + settings) | ⬜ No | Idempotent upserts, eventual consistency OK |
-
-### Правило
-
-> MongoDB любит моделирование, где транзакции нужны **редко**. Если транзакция нужна часто — пересмотри schema (может стоит embed).
-
----
-
-## 8. Migrations
-
-### Strategy
-
-| Когда | Как |
-|-------|-----|
-| Новое поле (optional) | Добавить в schema + `$setOnInsert` default |
-| Новое поле (required) | Migration script: `updateMany` + backfill |
-| Rename field | Migration script + update code + period with both fields |
-| Remove field | Migration script: `$unset` + remove from schema |
-| Change type | Два шага: add new field → migrate data → remove old |
-
-### Tool
-
-```bash
-npx migrate-mongo create add-templateId-to-settings
-npx migrate-mongo up
-npx migrate-mongo down   # rollback
-npx migrate-mongo status
-```
-
----
-
-## 9. Пример: полная модель
-
-```markdown
-# Data Model: SaaS Admin Panel
-
-## Entities
-1. Owner — registered account/tenant record
-2. Settings — Application configuration (1:1 with Owner)
-3. Product — Content items (1:N with Owner)
-
-## Storage
-- MongoDB 7 (single instance, Docker)
-- Mongoose ODM (strict: 'throw')
-- Timestamps on all collections
-
-## Key decisions
-- Settings embedded approach considered, but separate collection for independent API
-- Products always referenced (unbounded, independent CRUD)
-- See ADR-001 (MongoDB), ADR-003 (embed vs reference)
-```
-
----
-
-## 10. Output Template
-
-```markdown
-# Data Model: <project-name>
-
-**Date:** YYYY-MM-DD
-**Database:** MongoDB 7 + Mongoose
-
-## ER Diagram
-<mermaid diagram>
-
-## Entities
-<for each entity: section 2 template>
-
-## Data Patterns
-<embed vs ref decisions with rationale>
-
-## Indexes
-<section 5 table>
-
-## Query Mapping
-<section 6 table>
-
-## Transactions
-<section 7 table>
-
-## Migration Strategy
-<section 8>
-```
-
----
-
-## См. также
-- `$api-contracts` — API endpoints (schemas match entity fields)
-- `$mongodb-mongoose-best-practices` — implementation patterns
-- `$architecture-doc` — Architecture Document (data model section)
-- `$adr-log` — ADR for embed/reference/DB decisions
+---
+name: data-model
+description: Модель данных и стратегия хранения — нормализация/денормализация, индексы, транзакции, кэш, (опц.) event sourcing/eventual consistency — с trade-offs и привязкой к UX flows.
+type: discretionary
+domain: development
+owners:
+  - architect
+gates:
+  - ARCH
+tech: []
+topic:
+  - architecture
+triggers:
+  - модель данных
+  - схема БД
+  - индексы и транзакции
+  - нормализация
+  - стратегия хранения
+  - кэш и денормализация
+related:
+  - adr-log
+  - adr-log-reference
+  - api-contracts
+  - api-contracts-reference
+  - mongodb-mongoose-best-practices
+  - architecture-doc
+  - architecture-doc-reference
+  - threat-model-baseline
+  - n8n-pinecone-qdrant-supabase
+  - n8n-pinecone-qdrant-supabase-reference
+budget_lines: 300
+schema_version: 1
+---
+
+
+# Skill: Data Model
+
+Модель данных: от entity definitions до query optimization.
+
+**Разделы:**
+1. [Входы](#1-входы)
+2. [Entity Definition Template](#2-entity-template)
+3. [ER Diagram](#3-er-diagram)
+4. [Data Patterns](#4-data-patterns)
+5. [Index Strategy](#5-indexes)
+6. [Query Pattern Mapping](#6-query-mapping)
+7. [Transactions](#7-transactions)
+8. [Migrations](#8-migrations)
+9. [Output Template](#9-output)
+
+---
+
+## 1. Входы
+
+| Вход | Откуда | Зачем |
+|------|--------|-------|
+| PRD | PM gate | Acceptance criteria → entities, constraints |
+| UX Spec | UX gate | Screens/flows → query patterns |
+| API Contracts | Architect | Request/Response → fields, types |
+| NFR | System Design | Volume, latency, retention |
+
+---
+
+## 2. Entity Definition Template
+
+Для каждой сущности:
+
+```markdown
+### Entity: Product
+
+**Collection:** `products`
+**Lifecycle:** Created by admin, read by public endpoint, deleted manually
+
+| Field | Type | Required | Default | Constraints | Description |
+|-------|------|----------|---------|-------------|-------------|
+| _id | ObjectId | auto | auto | unique | Primary key |
+| ownerId | string | ✅ | — | indexed | Owner/tenant reference |
+| name | string | ✅ | — | 3-100 chars | Product name |
+| price | number | ✅ | — | min: 0 | Product price |
+| category | string | ✅ | "general" | enum: general, premium, sale | Product category |
+| active | boolean | ⬜ | true | — | Is product visible |
+| viewCount | number | ⬜ | 0 | min: 0 | Times viewed |
+| createdAt | Date | auto | now | — | Timestamp |
+| updatedAt | Date | auto | now | — | Timestamp |
+
+**Unique constraints:** (ownerId, name)
+**Indexes:** See Index Strategy
+**Relationships:** belongs to Owner (via ownerId)
+**Storage pattern:** Reference (separate collection)
+**Rationale:** Products have independent lifecycle, unbounded per owner
+```
+
+---
+
+## 3. ER Diagram
+
+```mermaid
+erDiagram
+    OWNER ||--|| SETTINGS : "has one"
+    OWNER ||--o{ PRODUCT : "has many"
+
+    OWNER {
+        ObjectId _id PK
+        string ownerId UK
+        string email
+        string name
+        string status
+        Date createdAt
+    }
+
+    SETTINGS {
+        ObjectId _id PK
+        string ownerId UK "FK → Owner"
+        object general
+        object appearance
+        object notifications
+        string theme
+        string templateId
+        object templateSettings
+    }
+
+    PRODUCT {
+        ObjectId _id PK
+        string ownerId "FK → Owner"
+        string name
+        number price
+        string category
+        boolean active
+        number viewCount
+        Date createdAt
+    }
+```
+
+---
+
+## 4. Data Patterns
+
+### Embed vs Reference Decision
+
+| Критерий | Embed ✅ | Reference ✅ |
+|---------|---------|-------------|
+| Читаются вместе | Да | Нет |
+| Independent lifecycle | Нет | Да |
+| Bounded size | Да (< 50 items) | Unbounded |
+| Atomic updates child | Нужны | Не критично |
+
+### Decision table (для проекта)
+
+| Parent | Child | Pattern | Rationale |
+|--------|-------|---------|-----------|
+| Owner | Settings | **Embed** (или 1:1 ref) | Всегда читаются вместе, 1 settings per owner |
+| Owner | Products | **Reference** | Independent CRUD, unbounded, own pagination |
+| Settings | general/appearance/notifications | **Embed** | Bounded subdocuments, always read together |
+
+> Каждый выбор embed/reference = потенциальный ADR. Если неочевидно — создай `$adr-log`.
+
+### Caching (если применимо)
+
+| Data | Cache? | Strategy | TTL | Invalidation |
+|------|--------|----------|-----|--------------|
+| Public content | ✅ | HTTP Cache-Control | 60s | PUT settings → purge |
+| Product list | ⬜ | No cache (small, dashboard only) | — | — |
+| Settings (dashboard) | ⬜ | No cache (always fresh) | — | — |
+
+---
+
+## 5. Index Strategy
+
+### Index → Query Pattern Mapping
+
+| Index | Fields | Type | Serves Query |
+|-------|--------|------|-------------|
+| `owners_ownerId` | `{ ownerId: 1 }` | unique | Lookup by ownerId |
+| `settings_ownerId` | `{ ownerId: 1 }` | unique | Lookup settings by owner |
+| `products_owner_name` | `{ ownerId: 1, name: 1 }` | unique | Duplicate check on create |
+| `products_owner_active_date` | `{ ownerId: 1, active: 1, createdAt: -1 }` | compound | List active products sorted by date |
+| `products_owner_date` | `{ ownerId: 1, createdAt: -1 }` | compound | List all products sorted |
+
+### Index rules
+
+| Правило | Описание |
+|---------|---------|
+| **ESR** | Equality → Sort → Range (порядок полей в compound) |
+| **Max 5-7** | Каждый index = write overhead |
+| **Verify** | `explain('executionStats')` → IXSCAN, не COLLSCAN |
+| **Partial** | Если index нужен не для всех docs: `partialFilterExpression` |
+
+---
+
+## 6. Query Pattern Mapping
+
+Маппинг UX screen → query:
+
+| UX Screen | Action | Query | Index Used |
+|-----------|--------|-------|------------|
+| Dashboard: Products list | Load page | `find({ ownerId }).sort({ createdAt: -1 }).limit(20)` | `products_owner_date` |
+| Dashboard: Products list | Filter active | `find({ ownerId, active: true }).sort({ createdAt: -1 })` | `products_owner_active_date` |
+| Dashboard: Products list | Search by name | `find({ ownerId, name: { $regex } })` | `products_owner_name` (prefix) |
+| Dashboard: Settings | Load | `findOne({ ownerId })` | `settings_ownerId` |
+| Dashboard: Settings | Save | `updateOne({ ownerId }, { $set: ... })` | `settings_ownerId` |
+| Public Content | Load config | `findOne({ ownerId })` + `findOne({ ownerId, active: true }).sort({ createdAt: -1 })` | `settings_ownerId` + `products_owner_active_date` |
+| Webhook: register | Create | `updateOne({ ownerId }, { ... }, { upsert: true })` | `owners_ownerId` |
+
+### Performance notes
+
+| Query | Expected latency | Volume | Notes |
+|-------|-----------------|--------|-------|
+| Public content | < 10ms | Every page view | Add cache header |
+| Products list | < 20ms | Dashboard only | Paginated |
+| Settings load | < 5ms | Dashboard only | Single doc |
+
+---
+
+## 7. Transactions
+
+### Когда нужны
+
+| Scenario | Transaction? | Rationale |
+|----------|:---:|-----------|
+| Create product | ⬜ No | Single collection write |
+| Update settings | ⬜ No | Single document update |
+| Process order (if order system) | ✅ Yes | Multi-doc: update order + decrement stock |
+| Register webhook (upsert owner + settings) | ⬜ No | Idempotent upserts, eventual consistency OK |
+
+### Правило
+
+> MongoDB любит моделирование, где транзакции нужны **редко**. Если транзакция нужна часто — пересмотри schema (может стоит embed).
+
+---
+
+## 8. Migrations
+
+### Strategy
+
+| Когда | Как |
+|-------|-----|
+| Новое поле (optional) | Добавить в schema + `$setOnInsert` default |
+| Новое поле (required) | Migration script: `updateMany` + backfill |
+| Rename field | Migration script + update code + period with both fields |
+| Remove field | Migration script: `$unset` + remove from schema |
+| Change type | Два шага: add new field → migrate data → remove old |
+
+### Tool
+
+```bash
+npx migrate-mongo create add-templateId-to-settings
+npx migrate-mongo up
+npx migrate-mongo down   # rollback
+npx migrate-mongo status
+```
+
+---
+
+## 9. Output Template
+
+```markdown
+# Data Model: <project-name>
+
+**Date:** YYYY-MM-DD
+**Database:** MongoDB 7 + Mongoose
+
+## ER Diagram
+<mermaid diagram>
+
+## Entities
+<for each entity: section 2 template>
+
+## Data Patterns
+<embed vs ref decisions with rationale>
+
+## Indexes
+<section 5 table>
+
+## Query Mapping
+<section 6 table>
+
+## Transactions
+<section 7 table>
+
+## Migration Strategy
+<section 8>
+```
+
+---
+
+## См. также
+- `$api-contracts` — API endpoints (schemas match entity fields)
+- `$mongodb-mongoose-best-practices` — implementation patterns
+- `$architecture-doc` — Architecture Document (data model section)
+- `$adr-log` — ADR for embed/reference/DB decisions

package/domains/development/.agents/skills/data-model/agents/kimi.yaml

@@ -1,14 +1,14 @@
-name: "data-model"
-display_name: "Модель данных"
-description: "Модель данных и стратегия хранения — нормализация/денормализация, индексы, транзакции, кэш, (опц.) event sourcing/eventual consistency — с trade-offs и привязкой к UX flows."
-default_prompt: "Используй $data-model, когда задача относится к навыку \"Модель данных\"."
-triggers:
-  - "data-model"
-  - "data model"
-  - "Модель данных"
-  - "Модель данных и стратегия хранения — нормализация/денормализация, индексы, транзакции, кэш, (опц"
-capabilities:
-  - "data"
-  - "model"
-tools: []
-implicit_invocation: true
+name: "data-model"
+display_name: "Модель данных"
+description: "Модель данных и стратегия хранения — нормализация/денормализация, индексы, транзакции, кэш, (опц.) event sourcing/eventual consistency — с trade-offs и привязкой к UX flows."
+default_prompt: "Используй $data-model, когда задача относится к навыку \"Модель данных\"."
+triggers:
+  - "data-model"
+  - "data model"
+  - "Модель данных"
+  - "Модель данных и стратегия хранения — нормализация/денормализация, индексы, транзакции, кэш, (опц"
+capabilities:
+  - "data"
+  - "model"
+tools: []
+implicit_invocation: true