hrbox-public/api
5
0
Fork 0
Code Issues Pull Requests 6 Actions Packages Projects Releases Wiki Activity

H-3821: задокументировал /admin/employment в v2 swagger #37

Merged
denis merged 2 commits from feature/H-3821 into master 2026-05-28 13:45:36 +00:00
Conversation 2 Commits 2 Files Changed 1
+397
denis commented 2026-05-28 13:28:55 +00:00 (Migrated from git.hrenot.com)
Copy Link
Copy Source

Новый admin read-only API трудоустройств. Основной кейс —
маппинг (origin_id, origin_organization_id) → user_id для
интеграторов (web-zaim, sokolove и др.).

  • Тег admin-employment (Methods for admin read-only access...).
  • GET /admin/employment: index с полным набором фильтров
    EmploymentSearch (origin_id[], origin_organization_id, user_id[],
    department_id, chief_id, is_main, status_id, reg_status_id,
    employment_date/fired_date/created_at range, name/position ilike,
    user_list_key, chief_only*, multipleEmployment).
  • GET /admin/employment/view?id=: одна запись.
  • Доступ: user-edit (тот же perm что в legacy /api/employment v1).
  • Схемы AdminEmployment, AdminEmploymentList, AdminEmploymentUserShort,
    AdminEmploymentChiefUserShort, AdminEmploymentDepartmentShort.
  • В описании метода — главный кейс маппинга origin → user_id,
    совместительства, поведение uvol'нённых, батч origin_id[].

Источники: контроллер app\controllers\api\v2\admin\EmploymentController,
testrix tests/v2/admin/test_admin_employment.py +
hrbox/models/v2/AdminEmploymentModel.py (pydantic).
Проверено живьём на denis.hrbox.io: totalCount=9393, все поля
схемы совпадают с реальным ответом.

Co-Authored-By: Claude Opus 4.7 (1M context) noreply@anthropic.com

Новый admin read-only API трудоустройств. Основной кейс — маппинг (origin_id, origin_organization_id) → user_id для интеграторов (web-zaim, sokolove и др.). - Тег admin-employment (Methods for admin read-only access...). - GET /admin/employment: index с полным набором фильтров EmploymentSearch (origin_id[], origin_organization_id, user_id[], department_id, chief_id, is_main, status_id, reg_status_id, employment_date/fired_date/created_at range, name/position ilike, user_list_key, chief_only*, multipleEmployment). - GET /admin/employment/view?id=<uuid>: одна запись. - Доступ: user-edit (тот же perm что в legacy /api/employment v1). - Схемы AdminEmployment, AdminEmploymentList, AdminEmploymentUserShort, AdminEmploymentChiefUserShort, AdminEmploymentDepartmentShort. - В описании метода — главный кейс маппинга origin → user_id, совместительства, поведение uvol'нённых, батч origin_id[]. Источники: контроллер app\controllers\api\v2\admin\EmploymentController, testrix tests/v2/admin/test_admin_employment.py + hrbox/models/v2/AdminEmploymentModel.py (pydantic). Проверено живьём на denis.hrbox.io: totalCount=9393, все поля схемы совпадают с реальным ответом. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
denis commented 2026-05-28 13:35:46 +00:00 (Migrated from git.hrenot.com)
Copy Link
Copy Source

added 1 commit

  • 0ce01297 - H-3821: переписал описание /admin/employment в нейтральный документационный стиль

Compare with previous version

added 1 commit <ul><li>0ce01297 - H-3821: переписал описание /admin/employment в нейтральный документационный стиль</li></ul> [Compare with previous version](/hrbox-public/api/-/merge_requests/37/diffs?diff_id=33529&start_sha=6ad75bdd1ebe5221d6aff9febf403da8c35c8e9e)
denis commented 2026-05-28 13:45:36 +00:00 (Migrated from git.hrenot.com)
Copy Link
Copy Source

mentioned in commit d1caea1cfa

mentioned in commit d1caea1cfa73ac36469d8a860834ae81aa7ee4fc
denis (Migrated from git.hrenot.com) merged commit d1caea1cfa into master 2026-05-28 13:45:36 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
denis gnome627 (Дмитрий Сащенко) kirill ruslan yuriy
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: hrbox-public/api#37