fst-action-journals
Журналы действий Otgruzka: appendAudit, hrJournal, itemHistories, warehouse.auditLog. Use when adding mutations, renaming (people, brigades, items, meals), or auditing whether an action is logged. Bef
SKILL.mddocs/agent-system/archive/skills/_agents-duplicate-fst-action-journals/SKILL.md
GitHubЖурналы действий Otgruzka
Правило: .cursor/rules/fst-action-journals.mdc<br>
Карта дыр: .cursor/context/JOURNALS_AUDIT.md
Когда читать
- Новая кнопка Сохранить / Провести / Удалить / Переименовать
- Смена ФИО, названия бригады, номенклатуры, комплекса, роли
- Раздел «Журналы» не показывает действие
- Перед фразой «всё пишется в журнал»
Куда писать
| Действие | API |
|---|---|
| Табель, HR карточка, доступ, финансы, обеды, справочники | appendAudit(store, { action, detail, oldValue?, newValue?, ...actorAuditFields(getActor) }) |
| Склад док / движение / погрузка | appendWarehouseAudit |
| Переименование позиции склада | appendItemHistory (itemHistories) |
| ФИО / бригада / ЗП / должность сотрудника | appendEmployeeJournal через applyEmployeeMovementJournal |
| Закупка статусы | statusHistory на заказе (collect уже читает) |
Лента UI: collectJournalEntries + classifyAuditEntry. Роли видят не все категории (journals/access.ts).
Чеклист новой мутации
-
appendAuditили доменный журнал в том жеsetStore - actor
by/byName - rename:
old → newвdetail - новый
actionвAuditEntry+ label + classify - если сущность долгоживущая (сотрудник, item) — ещё
hrJournal/itemHistories - i18n не обязателен для
AUDIT_ACTION_LABEL(сейчас RU в коде); HR-виды —hr/labels.tsRU+KA
Кольца (не вечные)
auditLog 2000, warehouse.auditLog 300, hrJournal 200. История ФИО живёт на карточке (hrJournal), не только в кольце.
Не делать
Полный rewrite логгера, отдельная БД аудита, логирование каждого клика UI.