RSHB/arm-ka-docs
9
0
Fork 0
Code Issues 12 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs(dev): инструкция для фронтенд-разработчика — аутентификация и авторизация arm-core #29

Merged
aep merged 1 commits from feat/28-frontend-auth-guide into main 2026-10-06 12:55:18 +03:00
Conversation 0 Commits 1 Files Changed 2 +243
aep commented 2026-10-06 12:54:15 +03:00
Owner
Copy Link

Закрывает #28.

Новый документ dev/frontend-auth-guide.md — что нужно разработчику фронта, чтобы писать клиент к arm-core:

  • модель: JWT без сессий на сервере, права как данные (роли не проверяются), порядок проверок право (403) → видимость (404) → статус/блокировка (409);
  • два режима получения токена: dev (POST /dev/token) и прод (SSO РАИСА, параметры — OQ-54), таблица отличий;
  • GET /me: схема, когда дёргать, семантика 200/401/403 (два вида 403 и как их различать);
  • сводка «область → право» по всем маршрутам, общие ответы и реакция клиента на них;
  • каталог 16 прав и 7 ролей, правила привязки UI к правам;
  • policy-слой (филиал, редактируемость версии), который фронт не дублирует;
  • эталонный клиент web/src/{api,auth} по файлам, окружение фронта;
  • чек-лист, проверка руками через curl, открытые вопросы для фронта.

Ссылка добавлена в dev/README.md. Источник — код arm-core на main (06.10.2026), спека authn-authz, 05-domain-rules.md §10.

Bounded-задача (только документация): без OpenSpec change и плана.

Rulings I made: нет — документ описывает существующее поведение, решений без обсуждения не принималось.

🤖 Generated with Claude Code

https://claude.ai/code/session_012vJkmBGKKqMoEMzvsXG3y2

Закрывает #28. Новый документ `dev/frontend-auth-guide.md` — что нужно разработчику фронта, чтобы писать клиент к `arm-core`: - модель: JWT без сессий на сервере, права как данные (роли не проверяются), порядок проверок право (403) → видимость (404) → статус/блокировка (409); - два режима получения токена: dev (`POST /dev/token`) и прод (SSO РАИСА, параметры — OQ-54), таблица отличий; - `GET /me`: схема, когда дёргать, семантика 200/401/403 (два вида 403 и как их различать); - сводка «область → право» по всем маршрутам, общие ответы и реакция клиента на них; - каталог 16 прав и 7 ролей, правила привязки UI к правам; - policy-слой (филиал, редактируемость версии), который фронт не дублирует; - эталонный клиент `web/src/{api,auth}` по файлам, окружение фронта; - чек-лист, проверка руками через curl, открытые вопросы для фронта. Ссылка добавлена в `dev/README.md`. Источник — код `arm-core` на `main` (06.10.2026), спека `authn-authz`, `05-domain-rules.md` §10. Bounded-задача (только документация): без OpenSpec change и плана. **Rulings I made:** нет — документ описывает существующее поведение, решений без обсуждения не принималось. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_012vJkmBGKKqMoEMzvsXG3y2
aep added 1 commit 2026-10-06 12:54:16 +03:00 
Модель (JWT без сессий, права как данные, порядок проверок право → видимость → статус), режимы dev/прод,
POST /dev/token и GET /me с семантикой 401/403/404, сводка прав по маршрутам, каталог прав и ролей,
policy-слой, эталонный клиент web/src/{api,auth}, чек-лист, проверка руками, открытые вопросы (OQ-54).
Ссылка добавлена в dev/README.md.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vJkmBGKKqMoEMzvsXG3y2
aep merged commit a92044d3d7 into main 2026-10-06 12:55:18 +03:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
PotapovaA Raykov-MS SalminMP Veronika Yashin1994 aep grog maxim tsygankoviva
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: RSHB/arm-ka-docs#29
No description provided.
Delete Branch "feat/28-frontend-auth-guide"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?