QLTS · UC-QLTS-03

UC-QLTS-03 — Nhập/import hồ sơ thí sinh

Nhập/import hồ sơ thí sinh. `TDSTS` là bảng rất rộng (226 cột); API chỉ expose field MVP, các field tenant-specific nằm trong schema.

Nguồn: docs/modules/qlts/use-cases/UC-QLTS-03.md · Sample data (fake VN)

S1 · Danh sách hồ sơ

Danh sách hồ sơ

Verify filtering by admission context and candidate identity before create/import.

cycleIdroundIdkeywordfullNameidentityNocandidateCode

cycleId	roundId	keyword	fullName	identityNo	candidateCode
Nguyễn Thị Mai	079203001234	CNTT	HS-2025-100	Đã nộp	HS-2025-100
Trần Văn Hùng	001203004567	KT	HS-2025-101	Đã nộp	HS-2025-101
Lê Thuý An	079204008901	NN	HS-2025-102	Đã nộp	HS-2025-102
Phạm Minh Tuấn	001204002345	QTKD	HS-2025-103	Đã nộp	HS-2025-103
Hoàng Gia Bảo	079205006789	CNTT	HS-2025-104	Đã nộp	HS-2025-104
Võ Ngọc Diệp	001205001122	KT	HS-2025-105	Đã nộp	HS-2025-105

API: `GET /applications`. · DB:

`TDSTS.IDDSTS`, `IDKyTS`, `IDDVPC`, `MADSTS`, `TenDayDu`, `HoLotSV`, `TenSV`, `SoCMND`, `NHHK`, `IDNGTS`, `IDKHOITS`, `SBD`, `MaSV`; linked wish rows in `TDSTSN

S2 · Nhập hồ sơ thủ công

Nhập hồ sơ thủ công

Create one application and confirm the transaction writes candidate + wishes + subject scores according to legacy behavior.

cycleIdfullNameroundIdidentityNogenderbirthDatemajorIdblockIdDiem1Diem2Diem3

API: `POST /applications` with `cycleId`, `roundId`, `fullName`, `identityNo`, `wishes[]`. · DB:

Candidate row: `TDSTS.IDDSTS`, `IDKyTS`, `IDPTXT`, `TenDayDu`, `HoLotSV`, `TenSV`, `Phai`, `NgaySinhC`, `SoCMND`, `DC_DT1LLSV`, `DC_EML1LLSV`, `IDNGTS`, `IDKHOI

S3 · Import hồ sơ

Import hồ sơ

Validate/import multiple candidates and verify grouped rows with the smallest `UUTIENNV` become the main candidate record.

cycleIdrows[]wishOrdermajorIdblockId

API: `POST /applications/import`. · DB:

Bulk candidate rows in `TDSTS` as above; wish rows in `TDSTSNV.IDDSTSNV`, `IDKyTS`, `IDDSTS`, `IDDOTNVTS`, `NGUYENVONG`, `IDNGTS`, `IDKHOITS`, `MAHOSVNV`, `DIEM

S4 · Nguyện vọng hồ sơ

Nguyện vọng hồ sơ

Replace/list wishes for an existing application and confirm later UC-05 can calculate scores from those rows.

applicationIdwishes[]wishOrdermajorIdblockIdwishScore

API: `GET /applications/{applicationId}/wishes`; `PUT /applications/{applicationId}/wishes`. · DB:

`TDSTSNV.IDDSTSNV`, `IDDSTS`, `IDKyTS`, `IDDOTNVTS`, `NGUYENVONG`, `IDNGTS`, `IDKHOITS`, `MAHOSVNV`, `DIEMTCNV`, `DIEMCONGXT`, `DIEMUTKVDT`, `UUTIENNV`, `IsDat`

S5 · Hồ sơ upload / tài khoản TS

Hồ sơ upload / tài khoản TS

Verify document metadata and candidate portal account are attached to the same candidate id.

documentIddocumentDetailIdfileNamenote isOriginal

documentId	documentDetailId	fileName	note	isOriginal
Nguyễn Thị Mai	079203001234	CNTT	HS-2025-100	Đã nộp
Trần Văn Hùng	001203004567	KT	HS-2025-101	Đã nộp
Lê Thuý An	079204008901	NN	HS-2025-102	Đã nộp
Phạm Minh Tuấn	001204002345	QTKD	HS-2025-103	Đã nộp
Hoàng Gia Bảo	079205006789	CNTT	HS-2025-104	Đã nộp
Võ Ngọc Diệp	001205001122	KT	HS-2025-105	Đã nộp

API:

Document/account data is included in application/care flows; no separate upload endpoint is listed in `openapi.yaml` MVP.

· DB:

`THOSOTS.IDHOSOTS`, `IDKyTS`, `IDDSTS`, `IDHS`, `NgayNopHS`, `SoHoSo`, `GhiChu`, `AnhHoSo`, `IsBanGoc`, `IDDVPC`; `THOSOTSCT.IDHOSOTSCT`, `IDDSTS`, `IDHS`, `Fil