# Database — Oracle Database 23 Free + Flyway

Nguồn chạy thật của schema HRIS. Tài liệu thiết kế nằm ở [docs/System_Design](../docs/System_Design)
(`00_Init_Oracle_Schema.sql` là bản thiết kế, tương ứng migration V1).

## Khởi động môi trường dev

```bash
cd database
cp .env.example .env                     # đặt mật khẩu riêng; .env không được commit
docker compose up -d oracle              # Oracle 23 Free — cổng chỉ mở trên 127.0.0.1:1521
docker compose run --rm flyway migrate   # V1..Vn + dev seed
docker compose run --rm flyway info      # trạng thái migration
```

Reset toàn bộ dữ liệu dev: `docker compose down -v` rồi chạy lại hai lệnh trên.

## Cấu trúc

| Đường dẫn | Nội dung |
|---|---|
| `migrations/V1__init_schema.sql` | 4 schema (`HR_CORE`, `HR_ATS`, `HR_PAY`, `HR_WF`), 42 bảng, 5 package, trigger bất biến, role `HR_CORE_APP` |
| `migrations/V2__app_users.sql` | Role + user ứng dụng cho từng service, logon trigger đặt `CURRENT_SCHEMA` |
| `migrations/V3__workflow_resolve_as_of.sql` | `WORKFLOW_TEMPLATE.ResolveAsOf` / `BusinessDatePath` (05 §5.4) |
| `migrations/V4__superseded_by_change_set.sql` | `SupersededByChangeSetId` trên 7 bảng phiên bản (dòng bị quyết định nào thay thế — cần cho đảo quyết định); thêm `REVERSE_CHANGE_SET` vào `CK_CI_OP` |
| `seed/dev/afterMigrate__dev_seed.sql` | Dữ liệu mẫu dev — idempotent, chỉ nạp khi `FLYWAY_LOCATIONS` gồm `seed/dev` |
| `tests/` | Test kịch bản chạy trên DB (xem `tests/README.md`) |
| `docker-compose.yml`, `.env.example` | Hạ tầng dev |

## Quy tắc migration
- **Không sửa migration đã áp** (Flyway kiểm checksum). Mọi thay đổi = file `V{n+1}__mo_ta.sql` mới.
- Oracle **không có DDL giao dịch**: migration hỏng giữa chừng để lại trạng thái dở. Ở dev thì `down -v`; ở môi trường
  dùng chung thì viết migration bù rồi `flyway repair`. Mỗi migration nên nhỏ và chỉ làm một việc.
- Không dùng `CREATE ... IF NOT EXISTS`: parser Oracle của Flyway 11 hiểu nhầm `IF` là mở khối PL/SQL.
- Khối PL/SQL / package / trigger kết thúc bằng dòng `/`.
- Lịch sử migration nằm trong schema `HR_MIGRATION`, tách khỏi schema nghiệp vụ.

## Kết nối từ ứng dụng

| Service | User | Role | Schema mặc định (logon trigger) |
|---|---|---|---|
| CoreHR | `HRIS_COREHR` | `HR_CORE_APP` | `HR_CORE` |
| Recruitment | `HRIS_RECRUITMENT` | `HR_ATS_APP` | `HR_ATS` |
| Payroll | `HRIS_PAYROLL` | `HR_PAY_APP` | `HR_PAY` |
| Workflow | `HRIS_WORKFLOW` | `HR_WF_APP` | `HR_WF` |

Connection string (.NET, `Oracle.ManagedDataAccess.Core`):
`User Id=HRIS_COREHR;Password=<COREHR_PASSWORD>;Data Source=//localhost:1521/FREEPDB1`

Quyền được giới hạn theo thiết kế: bảng phiên bản chỉ `INSERT` + `UPDATE (SupersededAt)`, không `DELETE`; mỗi user
chỉ thấy schema của service mình. Đã kiểm bằng `HRIS_COREHR`: `UPDATE ASSIGNMENT SET Fte` → ORA-41900,
`DELETE FROM ORG_EDGE` → ORA-41900, đọc `HR_WF.WORKFLOW_TEMPLATE` → ORA-00942.

## Dữ liệu dev seed

```
Tập đoàn (GRP)                   CEO-01    Nguyễn Thu Hà
├─ Khối Công nghệ (TECH)         CTO-01    Trần Minh Dũng
│  └─ Phòng App (APP)            APP-HEAD  Phạm Văn Chi
│     └─ Nhóm Web (WEB)          WEB-TL    Hoàng Bảo Ngọc
│          DEV-POOL (FTE 3.0)    Võ An 1.0 · Đặng Bình 1.0 · Bùi Cường 0.5
├─ Khối Sản phẩm (PROD)          CPO-01    — ghế trống (thử leo thang DOA)
└─ Phòng Nhân sự (HR)            CHRO-01   Lê Thị Lan · HRBP-01 Đỗ Yến · CB-01 Ngô Minh
FIN-01 (GRP)                     Lý Quang
```
Tenant `DEV`, 2 pháp nhân, 7 cấp bậc, 8 chức danh, change set `CS-INIT` (đã qua `PKG_INTEGRITY`), 5 workflow template
(LEAVE, ADVANCE, ORG_CHANGE, PERSONNEL_ACTION, OFFER), ma trận hạn mức, 4 kỳ lương (07 PAID, 08 LOCKED, 09–10 OPEN),
lương cơ bản cho 11 người.
