Giao diện
Dữ liệu cá nhân & quyền riêng tư
Trang sinh tự động
Đo trên source và trên schema sau khi chạy 820 migration, tại commit ad83b0aea.
Số điện thoại là một kiểu dữ liệu riêng
Số điện thoại không lưu bằng text mà bằng domain type public.phone_e164 có ràng buộc riêng. Nhờ vậy mọi chỗ lưu số điện thoại đều tra ra được bằng một truy vấn — tài liệu này liệt kê theo kiểu, không đoán theo tên cột, nên không sót và không nhận nhầm.
9 cột dùng kiểu này, ở 8 bảng:
| Bảng | Cột | Mô tả |
|---|---|---|
accounts | phone_e164 | E.164 login phone. NULL only for an email-only PiPoint account (PPI-P3-01, E-01); then email_normalized is set. Changes only inside a SECURITY DEFINER function (trigger accounts_identity_change_guard). |
addresses | recipient_phone | |
credential_challenges | phone_e164 | |
orders | ship_recipient_phone | |
password_credentials | phone_e164 | |
shipments | ship_recipient_phone | |
shipments | driver_phone | G2I-P3-03 (O8). Driver phone (operations contact, E.164). Staff read it in full; the buyer read selects it masked only. |
sign_in_throttles | phone_e164 | |
staff_credentials | phone_e164 |
Số được chuẩn hoá về E.164 để lưu và để định danh; khi hiển thị có thể đổi sang dạng nội địa.
Che dữ liệu
- Số điện thoại chỉ hiện đầy đủ với người có quyền đọc PII. Mặc định bị che ngay trong hàm database, không phải che ở tầng hiển thị — nên một lỗi ở tầng trên không làm lộ dữ liệu.
- Tìm kiếm khách hàng chỉ khớp vào số điện thoại khi người tìm có quyền đọc PII; tên và mã thì luôn khớp.
- Audit mask PII trước khi insert — dữ liệu chưa che không bao giờ được ghi.
- Mật khẩu, OTP, token, chữ ký và secret MFA không bao giờ xuất hiện trong lỗi, log hay audit; chúng cũng không được quét hay chuẩn hoá.
Email không phải là định danh
Email có thể là thông tin liên hệ trong hồ sơ, nhưng không bao giờ là định danh đăng nhập, không phải kênh khôi phục và không phải kênh nhận OTP. Định danh là số điện thoại.
Đồng ý, yêu cầu riêng tư, lưu giữ
Đồng ý
Mỗi mục đích có phiên bản; người dùng đồng ý với một phiên bản cụ thể, nên đổi điều khoản không im lặng kế thừa đồng ý cũ.
| Bảng | Cột | Policy | Mô tả |
|---|---|---|---|
consent_purpose_versions | 7 | 1 | P1-14. Versioned consent purpose texts (Legal/PO config, none seeded: GAP-60). One PUBLISHED per purpose. |
consent_records | 11 | 1 | P1-14. Append-only consent grant/withdraw history per account and purpose (NFR-PRI-002, NFR-CPL-004). |
Yêu cầu xuất và xoá dữ liệu
Yêu cầu đi qua duyệt; gói xuất có hạn và bị xoá sau khi hết hạn.
| Bảng | Cột | Policy | Mô tả |
|---|---|---|---|
privacy_exports | 17 | 1 | P1-14. Export package of one approved EXPORT request: private object + expiry; OWN download only. |
privacy_purge_records | 9 | 0 | P1-14. Append-only evidence of every erasure/purge decision per category (outcome, count, policy row). |
privacy_request_events | 10 | 0 | P1-14. Append-only history of every privacy_requests version (who/what/why), written by trigger only. |
privacy_requests | 17 | 2 | P1-14. Data export / deletion requests of a subject; one open request per kind; review by another person. |
Legal hold
Khi có legal hold, dữ liệu không được xoá kể cả khi có yêu cầu xoá hợp lệ.
| Bảng | Cột | Policy | Mô tả |
|---|---|---|---|
legal_hold_events | 7 | 0 | P1-14. Append-only set/release history of legal holds (actor, reason), written by trigger only. |
legal_holds | 16 | 1 | P1-14. Legal holds on a subject (account or order owner). ACTIVE blocks erasure and purge. Never deleted. |
Chính sách lưu giữ
| Bảng | Cột | Policy | Mô tả |
|---|---|---|---|
retention_policies | 10 | 0 | P1-14. PD-08 s31 retention schedule as config rows (PROPOSAL until Legal/Finance approve). SYSTEM_ONLY. |
Chi tiết nghiệp vụ: Module Audit & Quyền riêng tư.