app-data-modellisted
Install: claude install-skill Nioris/project-forge
# App Data Model — заложить структуру данных С НУЛЯ
## Зачем
Приложения часто начинаются с "просто запишем в localStorage", потом данные растут и нужны:
- Migrations между версиями ("раньше было `tasks`, теперь `items` с `type:'task'`")
- Sync с сервером (если cloud feature добавляется)
- Search и фильтрация (плоский localStorage медленный для 10K+ записей)
- Backup / export
- Concurrent edits (если будут collaboration features)
Retrofit data model = переписывать всё что её использует. Заложить правильно сразу = неделя сэкономлена.
Это **architectural skill** ([[decisions/010-architectural-vs-tactical-skills]]).
## Когда вызывать
- **New apps**: после `$start` Step 6.5 (i18n) и до Step 7 (first feature)
- **Existing apps**: если localStorage используется напрямую, но данных уже >100 записей или нужны новые features (search, sync)
- **Migration trigger**: schema changed → нужно пройти через migration logic
## Pipeline
### Шаг 1 — Read context
```
wiki/_map.md # type, category, target platforms
wiki/architecture/metrics.md # сколько данных ожидается, sessions/day
wiki/research/{Project}-references.md # что у конкурентов в plan tier vs free
```
### Шаг 2 — Define entities
В зависимости от category — список основных entities:
| Category | Typical entities |
|---|---|
| productivity | Task, Project, List, Tag, Reminder |
| tools / reference | Lookup record, Bookmark, History entry |
| business | User, Org, Item (depends), Permission, AuditLog |
| saas | Acco