INTERNAL DEV ONLY SRS ENV-F07: Digital Product Passport (DPP) (WBS 2.30.1)
⬅️ Quay lại Bảng Phân việc Spore WBS 📊 Google Sheets WBS

TÀI LIỆU ĐẶC TẢ YÊU CẦU PHẦN MỀM (SRS) ​

HỆ THỐNG: NỀN TẢNG TRUY XUẤT NGUỒN GỐC GOTRACE ​

ENV-F07 – Digital Product Passport (EU ESPR) ​

Thông tin Chi tiết
Phiên bản 1.0
Ngày tạo 14/04/2026
Tác giả GoTrace Team

Lịch sử thay đổi ​

Ngày Người cập nhật Mô tả
14/04/2026 GoTrace Team Khởi tạo SRS v1.0

1. Tổng quan tài liệu ​

1.1. Mục đích tài liệu ​

DPP theo EU ESPR 2024/1781: Identification + Composition + Durability + Environmental + Circularity + Supply Chain + Quality + Safety. Truy cập qua QR (TXNG-F16).

1.2. Thông tin chức năng ​

Thuộc tính Giá trị
Mã chức năng ENV-F07
Tên chức năng Digital Product Passport (EU ESPR)
Menu ENV > DPP & IoT > Digital Product Passport
Ưu tiên Bắt buộc
Giai đoạn v2.0
Pháp lý EU ESPR 2024/1781, Luật CLSPHH 2025
Liên thông Xem BA: docs/ba/L-Module-ENV.md

1.3. Tác nhân tham gia (Actors) ​

Actor Vai trò Quyền hạn
ENTERPRISE_ADMIN Quản trị DN Full CRUD
ENV_OFFICER Cán bộ MT Full CRUD
ENV_INSPECTOR Thanh tra MT Read-only
SYSTEM Hệ thống IoT collect, ESG calculate, cảnh báo
PUBLIC Công khai Xem DPP qua QR (F07)

1.4. Tham chiếu UI/UX ​

Tài liệu Link
Design System CLAUDE.md Section UI/UX

2. Luồng nghiệp vụ (Business Flow) ​

2.1. Luồng tổng quan ​

Xem BA: docs/ba/L-Module-ENV.md Section L.2.

2.2. Diễn giải luồng ​

Xem BA chi tiết. ​

3. Phân loại / Trạng thái ​

Xem BA: docs/ba/L-Module-ENV.md. ​

4. Danh sách màn hình ​

Mã Tên Mô tả Vai trò
SCR-EF07-01 Danh sách Bảng dữ liệu, lọc, pagination ENV_OFFICER
SCR-EF07-02 Thêm/Sửa Form nhập liệu ENV_OFFICER
SCR-EF07-03 Chi tiết Xem đầy đủ Tất cả

5. Mô tả chi tiết trường dữ liệu ​

Xem BA: docs/ba/L-Module-ENV.md Section L.2. ​

6. Danh sách Use Case ​

Xem BRD: docs/brd/BRD_ENV-F07_Digital_Product_Passport.md ​

7. Mô tả chi tiết Use Case ​

Xem BA chi tiết. ​

8. Thiết kế Database Schema ​

8.1. Bảng chính: env_product_passports ​

Cột Kiểu Nullable Default Constraint
id UUID NOT NULL gen_random_uuid() PK
enterprise_id UUID NOT NULL FK enterprises(id)
facility_id UUID NOT NULL FK → TXNG facilities
status VARCHAR(20) NOT NULL CHECK IN (...)
created_by UUID NULL FK users(id)
updated_by UUID NULL FK users(id)
created_at TIMESTAMPTZ NOT NULL NOW()
updated_at TIMESTAMPTZ NOT NULL NOW()
deleted_at TIMESTAMPTZ NULL Soft delete

8.2-8.4. Indexes & Migration ​

Xem file migration riêng. ​

9. Thiết kế API ​

9.1. Danh sách endpoint ​

# Method Endpoint Mô tả Roles
1 GET /api/v1/env/env-product-passports/list Danh sách ENV_OFFICER
2 GET /api/v1/env/env-product-passports/:id Chi tiết All
3 POST /api/v1/env/env-product-passports Tạo ENV_OFFICER
4 PUT /api/v1/env/env-product-passports/:id Cập nhật ENV_OFFICER
5 DELETE /api/v1/env/env-product-passports/:id Soft delete ENTERPRISE_ADMIN
6 GET /api/v1/env/env-product-passports/analysis Thống kê ENV_OFFICER

10. Test Cases cho QA ​

Mã Tên Kết quả Ưu tiên
TC-E07-01 CRUD cơ bản Thành công Cao
TC-E07-02 Validation Lỗi khi thiếu field Cao
TC-E07-03 Phân quyền ENV_INSPECTOR chỉ read Cao

11. Acceptance Criteria ​

Mã Tiêu chí Điều kiện
AC-EF07-01 CRUD hoạt động Validation + phân quyền
AC-EF07-02 Multi-tenant enterprise_id isolation

12. Chuyển đổi trạng thái ​

Xem BA: docs/ba/L-Module-ENV.md. ​

13. Notification List ​

Mã Sự kiện Người nhận Kênh
N-EF07-01 Tạo mới ENV_OFFICER In-app
N-EF07-02 Vượt ngưỡng QCVN ENV_OFFICER, ENV_INSPECTOR In-app, Email, SMS
N-EF07-03 Hết hạn GP MT ENTERPRISE_ADMIN In-app, Email

14. Error / Warning Message Handling ​

Mã Loại Mô tả Điều kiện
E-EF07-001 Error Dữ liệu không hợp lệ Validation fail
E-EF07-002 Error Vượt ngưỡng QCVN Sensor data > threshold
W-EF07-001 Warning GP MT sắp hết hạn ≤30 ngày

15. Ma trận truy xuất ​

Xem BRD: docs/brd/BRD_ENV-F07_Digital_Product_Passport.md ​

16. Quy tắc nghiệp vụ ​

Xem BA: docs/ba/L-Module-ENV.md Section L.2. ​

17. Ràng buộc & Giả định ​

# Ràng buộc
1 Multi-tenant: enterprise_id
2 Soft delete: deleted_at
3 Facility link: FK → TXNG-F01

18. Phụ lục ​