3-6. Типизированные черновики статических ресурсов #13

Open
opened 2026-10-04 20:48:08 +00:00 by bsodfather · 0 comments
Owner

Результат задачи

Добавить создание и редактирование статических ресурсов с проверкой типа и содержимого.

Что необходимо сделать и проверить

  • Текстовые и двоичные данные, URI и MIME-тип проверяются и ограничиваются.
  • черновик отделён от опубликованной версии.
  • полномочия, конкурентное редактирование и безопасное отображение ошибок проверены.
  • интерфейс и API согласованы, секреты не попадают в содержимое и диагностику.

Зависимости

3-1 — #8.

Приёмка

Требования: FR-15, FR-16. Это задача разработки. Проверить её результат и все обязательные критерии: применимые модульные, интеграционные, отрицательные и сквозные проверки, сборку и предусмотренные проверки проекта. Зафиксировать фактические результаты и оставшиеся ограничения. Будущие приёмочные испытания других задач не выполняются попутно.

Полный обязательный контракт задачи и подробные критерии. Описание выше поясняет работу; ссылка сохраняет полный объём требований, включая ограничения и отрицательные сценарии. Сокращённое описание не заменяет и не ослабляет исходные критерии.

Утверждённое изменение контракта — 2026-10-11

Владелец согласовал ровно две целевые MCP revisions: 2026-07-28 и 2025-11-25, Resource-first порядок 3.1 → 3.6 → 3.7 → 3.8, узкие method services и перенос production experimental configuration до первой реальной extension. Этот раздел и полный актуальный контракт ниже заменяют противоречащие им старые формулировки, включая историческое вложение. Остальные требования и доказательства не ослаблены. Это изменение планирования, НЕ выполненная разработка или PASS. Требования ≥3 representative real clients, NFR-P4, FR-54, immutable RC и отдельная release qualification сохраняются. Runtime пока остаётся pre-change; будущая реализация обслуживает только две целевые revisions и безопасно отклоняет остальные без implicit fallback.

Полный актуальный scoped contract

Story 3.6: Сохранять typed static Resource Drafts

Depends on: Story 3.1 (обновлено владельцем 2026-10-11: Resource-вертикаль стартует после минимальной protocol/auth foundation 3.1; прежняя зависимость от Tools-модернизации 3.5 снята, при этом 3.2–3.5 сохраняют собственные зависимости и остаются обязательной работой Epic 3)

Work type: implementation

Deliverable: Сохранять typed static Resource Drafts.

Completion: outcome этой story и все её AC проверены; будущая qualification не выполняется попутно.

As an администратор,
I want безопасно сохранять text, JSON и binary Resource Drafts,
So that content имеет typed contract, bounded artifact и безопасный preview.

Requirements: FR-15, FR-16

Acceptance Criteria:

Given Resource domain model
When добавляется persistence и API contract
Then Resource является отдельным typed aggregate с собственными ID/version/lifecycle, CapabilityKind::Resource, sensitivity и immutable Published Version
And не хранится как untyped Operation subtype или универсальный JSON blob.

Given новый Resource Draft
When администратор выбирает static text, JSON или binary kind
Then задаются URI, name, description, MIME type, sensitivity и bounded content
And URI и name валидируются как стабильные capability identifiers.

Given static content
When оно сохраняется
Then bytes размещаются в content-addressed artifact store, а Resource Version хранит exact digest и metadata
And filesystem path, raw upload filename или mutable external reference не входит в published contract.

Given JSON Resource
When Draft сохраняется или preview-ится
Then content валидируется как JSON и возвращается без изменения data semantics
And malformed либо oversized JSON отклоняется до publication.

Given text Resource
When content принимается
Then он сохраняет валидный UTF-8 в пределах configured size
And invalid encoding или unsafe truncation отклоняются с stable finding.

Given binary Resource
When он preview-ится или читается через MCP
Then MIME, byte size и negotiated binary representation соблюдаются version adapter
And content не декодируется как text и не помещается целиком в logs/errors.

Given Resource с active либо browser-renderable content type, включая HTML или SVG
When Admin UI показывает preview/download
Then untrusted bytes не исполняются в origin Crank: используется inert text/metadata, sandboxed isolated preview либо attachment download по explicit allowlist
And response применяет safe Content-Type, nosniff, CSP/sandbox и filename sanitization без content sniffing.

Given static Resource Draft suite
When выполняются domain, artifact и API tests
Then покрыты text/JSON/binary validation, MIME/size, active-content preview, malformed encoding и artifact integrity
And just verify проходит.

### Результат задачи Добавить создание и редактирование статических ресурсов с проверкой типа и содержимого. ### Что необходимо сделать и проверить - Текстовые и двоичные данные, URI и MIME-тип проверяются и ограничиваются. - черновик отделён от опубликованной версии. - полномочия, конкурентное редактирование и безопасное отображение ошибок проверены. - интерфейс и API согласованы, секреты не попадают в содержимое и диагностику. ### Зависимости [3-1 — #8](https://git.itexp.me/bsodfather/crank/issues/8). ### Приёмка Требования: FR-15, FR-16. Это задача разработки. Проверить её результат и все обязательные критерии: применимые модульные, интеграционные, отрицательные и сквозные проверки, сборку и предусмотренные проверки проекта. Зафиксировать фактические результаты и оставшиеся ограничения. Будущие приёмочные испытания других задач не выполняются попутно. [Полный обязательный контракт задачи и подробные критерии](https://git.itexp.me/attachments/c1fe4516-5f6c-41ab-a697-c7a0faac0527). Описание выше поясняет работу; ссылка сохраняет полный объём требований, включая ограничения и отрицательные сценарии. Сокращённое описание не заменяет и не ослабляет исходные критерии. <!-- crank-plan:story-3-6 --> ### Утверждённое изменение контракта — 2026-10-11 Владелец согласовал ровно две целевые MCP revisions: `2026-07-28` и `2025-11-25`, Resource-first порядок `3.1 → 3.6 → 3.7 → 3.8`, узкие method services и перенос production experimental configuration до первой реальной extension. Этот раздел и полный актуальный контракт ниже заменяют противоречащие им старые формулировки, включая историческое вложение. Остальные требования и доказательства не ослаблены. Это изменение планирования, НЕ выполненная разработка или PASS. Требования ≥3 representative real clients, NFR-P4, FR-54, immutable RC и отдельная release qualification сохраняются. Runtime пока остаётся pre-change; будущая реализация обслуживает только две целевые revisions и безопасно отклоняет остальные без implicit fallback. ### Полный актуальный scoped contract ### Story 3.6: Сохранять typed static Resource Drafts **Depends on:** Story 3.1 (обновлено владельцем 2026-10-11: Resource-вертикаль стартует после минимальной protocol/auth foundation 3.1; прежняя зависимость от Tools-модернизации 3.5 снята, при этом 3.2–3.5 сохраняют собственные зависимости и остаются обязательной работой Epic 3) **Work type:** implementation **Deliverable:** Сохранять typed static Resource Drafts. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an администратор, I want безопасно сохранять text, JSON и binary Resource Drafts, So that content имеет typed contract, bounded artifact и безопасный preview. **Requirements:** FR-15, FR-16 **Acceptance Criteria:** **Given** Resource domain model **When** добавляется persistence и API contract **Then** Resource является отдельным typed aggregate с собственными ID/version/lifecycle, `CapabilityKind::Resource`, sensitivity и immutable Published Version **And** не хранится как untyped Operation subtype или универсальный JSON blob. **Given** новый Resource Draft **When** администратор выбирает static text, JSON или binary kind **Then** задаются URI, name, description, MIME type, sensitivity и bounded content **And** URI и name валидируются как стабильные capability identifiers. **Given** static content **When** оно сохраняется **Then** bytes размещаются в content-addressed artifact store, а Resource Version хранит exact digest и metadata **And** filesystem path, raw upload filename или mutable external reference не входит в published contract. **Given** JSON Resource **When** Draft сохраняется или preview-ится **Then** content валидируется как JSON и возвращается без изменения data semantics **And** malformed либо oversized JSON отклоняется до publication. **Given** text Resource **When** content принимается **Then** он сохраняет валидный UTF-8 в пределах configured size **And** invalid encoding или unsafe truncation отклоняются с stable finding. **Given** binary Resource **When** он preview-ится или читается через MCP **Then** MIME, byte size и negotiated binary representation соблюдаются version adapter **And** content не декодируется как text и не помещается целиком в logs/errors. **Given** Resource с active либо browser-renderable content type, включая HTML или SVG **When** Admin UI показывает preview/download **Then** untrusted bytes не исполняются в origin Crank: используется inert text/metadata, sandboxed isolated preview либо attachment download по explicit allowlist **And** response применяет safe `Content-Type`, `nosniff`, CSP/sandbox и filename sanitization без content sniffing. **Given** static Resource Draft suite **When** выполняются domain, artifact и API tests **Then** покрыты text/JSON/binary validation, MIME/size, active-content preview, malformed encoding и artifact integrity **And** `just verify` проходит. <!-- crank-approved:epic3-resource-first-20261011 -->
bsodfather added this to the Этап 3. Инструменты, ресурсы и шаблоны запросов MCP milestone 2026-10-04 20:48:08 +00:00
bsodfather added the
Priority
Medium
3
Kind/Feature
labels 2026-10-04 20:48:08 +00:00
bsodfather added this to the Crank project 2026-10-04 20:53:17 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Reference: bsodfather/crank#13