ADR-008: Phạm Vi Discovery GĐ1 — CSV + SQL DDL + Khai Báo Thủ Công¶
Trạng thái¶
Accepted
Ngày¶
2026-04-08
Người quyết định¶
Tech Lead, Product Owner
Architecture Drivers¶
D6 (Tốc độ đưa ra sản phẩm), D7 (Khả năng mở rộng)
Bối cảnh¶
TSD v1.3 định nghĩa 4 phương thức Discovery: LDOP API, PostgreSQL Direct, SQL Dump, Excel/CSV. Tuy nhiên LDOP có thể chưa triển khai tại nhiều Sở trong GĐ1, và PostgreSQL Direct yêu cầu truy cập mạng cùng thỏa thuận bảo mật. Tài liệu BA đã xác nhận phạm vi GĐ1: CSV, SQL DDL và khai báo thủ công.
Quyết Định¶
GĐ1 Discovery hỗ trợ 3 phương thức:
- Upload CSV — parse header lấy tên field
- Upload SQL DDL — parse CREATE TABLE lấy tên field + kiểu dữ liệu
- Khai báo thủ công — Manager nhập tên field, kiểu dữ liệu, mô tả
LDOP API và PostgreSQL Direct chuyển sang backlog GĐ2 (INT-BACKLOG-001, INT-BACKLOG-002).
Thiết kế mở rộng: Mọi phương thức Discovery đều output qua interface chung DiscoveryNormalizer, tạo ra ExtractedField records chuẩn hóa. Thêm phương thức mới ở GĐ2 chỉ cần implement interface normalizer.
Hệ Quả¶
Tích cực¶
- Giảm phạm vi GĐ1 — phát hành nhanh hơn
- Không phụ thuộc vào hạ tầng LDOP sẵn sàng
- Không có complexity bảo mật của kết nối DB trực tiếp
- Kiến trúc hỗ trợ thêm phương thức sau qua normalizer interface
Tiêu cực¶
- Sở cần nỗ lực thủ công (export và cung cấp file)
Liên Quan¶
- Integration Catalog — Quyết định #7
- TSD v1.3 Section 3.2 (Discovery 4 phương thức)