Skip to content

feat: стандарты разработки + OpenAPI из Zod#161

Merged
NovakPAai merged 9 commits intomainfrom
claude/jack-standards-openapi-rbac
May 10, 2026
Merged

feat: стандарты разработки + OpenAPI из Zod#161
NovakPAai merged 9 commits intomainfrom
claude/jack-standards-openapi-rbac

Conversation

@NovakPAai
Copy link
Copy Markdown
Owner

Summary

  • Claude commands (.claude/commands/): audit-schemas, design-doc, preflight, new-api — Claude вызывает их сам по правилам в CLAUDE.md
  • Dev patterns (docs/claude-patterns/): feature-development (полный цикл BDD→SDD→API→UI→3 ревью), dev-conventions (TypeScript, Prisma, API, BDD/SDD правила)
  • CLAUDE.md: обязательные правила поведения — impact analysis перед любым изменением, spec-first для нетривиальных задач, 3 ревью (code + security + UX/UI), preflight перед push
  • OpenAPI: @asteasolutions/zod-to-openapi + Scalar UI — GET /api/openapi.json и GET /api/docs покрывают все 40+ эндпоинтов; новые эндпоинты через /new-api регистрируются автоматически

Test plan

  • make dev — запустить бэкенд
  • GET http://localhost:3101/api/openapi.json → валидный OpenAPI 3.1 JSON
  • GET http://localhost:3101/api/docs → Scalar UI с документацией всех эндпоинтов
  • cd backend && npx tsc --noEmit → 0 ошибок
  • cd backend && npm run lint → 0 ошибок

@NovakPAai NovakPAai merged commit 57892b0 into main May 10, 2026
14 of 16 checks passed
@NovakPAai NovakPAai deleted the claude/jack-standards-openapi-rbac branch May 10, 2026 18:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants