Appearance
Quản lý Nhà nước & ATTP Oversight (QLNN)
Phân hệ Quản lý Nhà nước (QLNN) cung cấp cho UBND Thành phố/Tỉnh, các Sở chuyên ngành (Sở Công Thương, Sở Nông nghiệp & PTNT, Sở Y tế, Sở Khoa học & Công nghệ) và UBND Quận/Huyện/Phường/Xã bộ công cụ giám sát toàn diện hoạt động truy xuất nguồn gốc, thanh kiểm tra liên ngành, xử lý vi phạm và cảnh báo sớm trên toàn địa bàn.
1. Sơ đồ Kiến trúc Government Oversight (QLNN)
Rendering diagram...
2. Hierarchical RBAC Scope qua unit_path
Kiến trúc phân quyền theo địa bàn của phân hệ QLNN nằm tại apps/backend/src/modules/auth/jwt.strategy.ts và apps/backend/src/modules/users/users.service.ts:
- Mỗi đơn vị hành chính (
DVHCVN— Thành phố → Phường/Xã) hoặc cơ quan nhà nước (CO_QUAN_NN— Sở → Chi cục → Đội) được lưu trong bảnglookup_itemsvới materialized pathunit_path(ví dụ:/1/101/10105/). - Khi một cán bộ QLNN đăng nhập,
JwtStrategy.validate()tổng hợp các bản ghiRoleAssignmentcủa cán bộ đó để build objectscopetrongJwtPayload:unit_ids: Tập hợp ID đơn vị hành chính mà cán bộ quản lý (bao gồm cả đơn vị cấp dưới nếuinclude_children = true, được expand tự động bằng prefix queryunit_path LIKE '/1/101/%').industry_codes: Phạm vi ngành hàng được phân công phụ trách (ví dụ Sở NN&PTNT phụ trách Nông-Lâm-Thủy sản, Sở Công Thương phụ trách Công nghiệp-Thương mại).company_ids: Danh sách doanh nghiệp cụ thể (nếu giới hạn theo chuyên đề).
3. Phân tích Chi tiết Các Module Quản lý Nhà nước
3.1. Executive Command Center & Dashboards (dashboard-tong, cross-enterprise-dashboard)
Module (apps/backend/src/modules/*) | Endpoint chính (/api/v1/*) | Chức năng & Query Architecture |
|---|---|---|
dashboard-tong | /dashboard-tong/* | Executive Dashboard phục vụ lãnh đạo Sở/Thành phố. Sử dụng OLAP Cube SQL (enterprise-chain.query.ts, enterprise-open-issues.query.ts, enterprise-sql.util.ts) để aggregate chỉ số KPI đa chiều theo thời gian thực và so sánh YoY (sameMomentLastYear theo timezone Asia/Ho_Chi_Minh):- Tỷ lệ doanh nghiệp kích hoạt truy xuất nguồn gốc theo địa bàn/ngành. - Sản lượng batches, tem SGTIN phát hành, tỷ lệ nhập nguyên liệu có nguồn gốc. - Tình hình ATTP bếp ăn học đường và danh sách vấn đề tồn đọng ( open-issues). |
cross-enterprise-dashboard | /cross-enterprise-dashboard | Bản đồ luồng hàng hóa liên thông giữa các doanh nghiệp sản xuất → nhà phân phối → siêu thị/chợ/trường học, phát hiện điểm đứt gãy chuỗi cung ứng. |
oversight-cafeterias | /oversight-cafeterias | Portal giám sát chuyên biệt cho Sở Y tế / Sở GD&ĐT / UBND Phường Xã theo dõi toàn bộ các bếp ăn trường học trên địa bàn: tỷ lệ công khai thực đơn hàng ngày, điểm tuân thủ dinh dưỡng, cảnh báo tài chính suất ăn và số lượng phản ánh từ phụ huynh. |
trading-venues | /trading-venues | Quản lý mạng lưới Chợ đầu mối, Chợ dân sinh, Siêu thị, Trung tâm thương mại và Cửa hàng tiện lợi trên địa bàn. |
3.2. Inspection & Remediation Workflow (oversight-*)
Module (apps/backend/src/modules/*) | Endpoint chính (/api/v1/*) | Chức năng & Business Rules |
|---|---|---|
personnel & form-templates | /personnel, /form-templates | Quản lý danh sách đoàn/cán bộ thanh tra (Personnel: mã cán bộ, đơn vị, địa bàn phụ trách, điểm hiệu suất, số vụ việc đang xử lý) và dynamic inspection checklist (FormTemplate). |
oversight-plans | /oversight-plans | Lập và phê duyệt kế hoạch kiểm tra định kỳ hoặc đột xuất theo chuyên đề (ví dụ: Kiểm tra ATTP dịp Tết, Kiểm tra bếp ăn học đường đầu năm học), phân công đoàn kiểm tra và danh sách cơ sở mục tiêu. |
oversight-inspections | /oversight-inspections | Ghi nhận biên bản kiểm tra tại hiện trường theo bộ tiêu chí chuẩn (FormTemplate), đính kèm ảnh chụp thực địa, mẫu xét nghiệm và kết luận (PASSED, WARNING, FAILED). |
oversight-violations & oversight-remediations | /oversight-violations, /oversight-remediations | Khi biên bản kiểm tra có kết luận vi phạm, hệ thống khởi tạo hồ sơ vi phạm (OversightViolation: mức độ, quyết định xử phạt, thời hạn khắc phục) và yêu cầu doanh nghiệp/trường học nộp báo cáo minh chứng khắc phục (OversightRemediation) để cán bộ hậu kiểm nghiệm thu. |
3.3. Alert Rule Engine & Threshold Monitoring (alerts, oversight-alerts, monitoring)
- Alert Rule Engine (
src/modules/alerts/rule-engine/&core/alert-id.service.ts): Sinh mã cảnh báo chuẩn hóa qua PostgreSQL sequence (alert_id_seq), đánh giá sự kiện theo ngưỡng (ThresholdEventsService) và phân loại mức độ nghiêm trọng (CRITICAL,HIGH,MEDIUM,LOW). - Automated Oversight Alerts (
oversight-alerts): Khi doanh nghiệp có giấy chứng nhận ATTP/VietGAP sắp hết hạn hoặc quá hạn, khi một lô hàng bị recall khẩn cấp (recall), hoặc khi một bếp ăn học đường nhận nhiều phản ánh sự cố từ phụ huynh trong ngày, hệ thống tự động đẩy cảnh báo vào dashboard của cán bộ QLNN phụ trách đúng địa bàn đó.