# Доступ, организации, группы и внешние аккаунты

## Назначение

Домен описывает организацию-владельца, клиентские организации, организации внешних исполнителей, пользователей, глобальные и организационные группы, членство, наследование прав, проектные и репозиторные разрешения, внешние аккаунты как субъекты политики, allowlist, SSO/OIDC-вход и аудит решений доступа.

## Что входит

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

## Что не входит

- зеркало `Issue`, `PR/MR`, комментариев, webhook, лимиты и операции провайдера — это зона `provider-hub`;
- проекты, репозитории, `services.yaml`, релизные политики и источники проектной документации — это зона `project-catalog`;
- роли агентов, процессы, этапы и шаблоны промптов — это зона `agent-manager`;
- доставка уведомлений и запросов решений человеку — это зона `interaction-hub`;
- значения секретов — это зона хранилища секретов и общего resolver-клиента, а домен хранит только ссылку, метаданные и решение доступа.

## Документы

- Требования: `product/requirements.md`.
- Дизайн: `architecture/design.md`.
- Модель данных: `architecture/data_model.md`.
- API-контракт: `architecture/api_contract.md`.
- План поставки реализации: `delivery/wave7_access_and_accounts.md`.

## Реализация

- Сервис-владелец: `services/internal/access-manager`.
- gRPC-контракт: `proto/kodex/access_accounts/v1/access_manager.proto`.
- HTTP-контракт: через gateway-спецификации после появления соответствующего gateway-среза.
- AsyncAPI: `specs/asyncapi/access-manager.v1.yaml`.
- Миграции: `services/internal/access-manager/cmd/cli/migrations`.
- Статус контрактов и бэклог реализации: `delivery/wave7_access_and_accounts.md`.

## Карта Issue

- Доменная карта: `docs/delivery/issue-map/domains/access-and-accounts.md`.
- Волновая карта: `docs/delivery/issue-map/waves/wave-007-access-and-accounts.md`.
