[kilfor.ru](https://kilfor.ru/) là trang web hoạt động và hệ thống nội bộ của trung tâm thương mại Kilfor.

Dự án chạy trên nền tảng MODX. Phiên bản hệ thống này đã được sử dụng tại cơ sở từ năm 2016; nền tảng của nó được phát triển từ trước đó, vào năm 2009, dành cho trung tâm thương mại tại địa chỉ 21 Novy Arbat.

Bên trong dự án vận hành trang web công khai, trang cá nhân và logic ứng dụng liên quan đến yêu cầu cấp thẻ ra vào, xe ra vào, dịch vụ tiện ích công cộng và các quy trình nội bộ khác của trung tâm thương mại.

MODX vẫn đóng vai trò là backend của hệ thống hiện hành. Phần công khai của dự án được phát triển riêng biệt trên frontend mới.

Tình trạng chung, lịch sử và sự phát triển của dự án được ghi lại trong [ý tưởng chính](https://fi1osof.ru/concepts/kilfor-modernizatsiya-legacy-modx-proekta).

Kilfor.ru là một trang web hoạt động và là hệ thống nội bộ của trung tâm thương mại Kilfor. Phần công khai chạy trên MODX, trong khi backend duy trì logic ứng dụng của tài khoản cá nhân, thẻ ra vào, xe ra vào, dịch vụ tiện ích công cộng (gkh) và các quy trình nội bộ khác. Ý tưởng cốt lõi của dự án: https://fi1osof.ru/concepts/kilfor-modernizatsiya-legacy-modx-proekta

Kilfor.ru

Lỗi hiện tại&#x20;

```text
Fatal error: Uncaught DOMPDF_Exception: No block-level parent found. 
```

Sửa lỗi xuất file PDF

## Bối cảnh

Các phiên người dùng Kilfor hiện tại được lưu trữ và quản lý bởi MODX. Frontend mới dựa trên haih-agent đã tự thực hiện một phần logic ứng dụng, do đó nó định kỳ cần thông tin chi tiết về người dùng hiện tại đã được xác thực.

MODX có PHP API nội bộ để làm việc với người dùng hiện tại bên trong MODX runtime, nhưng không có sẵn HTTP endpoint bên ngoài tiêu chuẩn ở cấp độ `current user` cho ngữ cảnh frontend. modSociety có endpoint riêng để lấy thông tin người dùng, tuy nhiên frontend mới không được phụ thuộc vào thành phần legacy này.

## Mục tiêu

Triển khai một tầng hạ tầng trong haih-agent có khả năng xác định người dùng được ủy quyền trong một ngữ cảnh frontend cụ thể (`web` hoặc ngữ cảnh khác) dựa trên cookie session MODX hiện có, và cung cấp dữ liệu người dùng đã chuẩn hóa cho mã ứng dụng của frontend mới.

## Cần nghiên cứu và triển khai

- Tìm hiểu định dạng lưu trữ session frontend thực tế trong phiên bản MODX đang sử dụng và trên Kilfor.
- Xác định cách lấy người dùng cho một context key cụ thể từ session ID và dữ liệu `modx_session`.
- Phân tích cú pháp serialization của PHP một cách chính xác mà không phụ thuộc vào các mẹo dùng biểu thức chính quy (regex hack).
- Lấy dữ liệu người dùng cần thiết từ `modUser`, `modUserProfile` và các mối quan hệ dự án.
- Biến phần cài đặt riêng cho MODX thành một adapter/provider độc lập để mã ứng dụng làm việc với trừu tượng hóa `currentUser` thay vì phải biết cấu trúc session của MODX.
- Không mã cứng (hardcode) `web` vào trình phân tích cú pháp tầng thấp: context key phải được thiết lập qua cấu hình hoặc bởi tầng xác thực gọi đến.
- Xử lý việc hết hạn/không hợp lệ của session và việc thiếu quyền xác thực trong ngữ cảnh được yêu cầu.
- Không chuyển đổi toàn bộ MODX ACL/security runtime nếu không có nhu cầu cụ thể; ở giai đoạn đầu, nhiệm vụ là xác định đáng tin cậy người dùng và dữ liệu của họ.
- Dự trù khả năng sử dụng các kho lưu trữ/trình xử lý session khác trong tương lai, tránh gắn kết chặt chẽ toàn bộ mã xác thực với các truy vấn SQL vào `modx_session`.
- Phủ kiểm thử parser và việc nhận diện người dùng bằng các fixture/integration test sử dụng dữ liệu mẫu session frontend MODX thực tế.

## Kết quả mong đợi

Người dùng hiện tại đã được chuẩn hóa cho ngữ cảnh frontend được chỉ định, được lấy trực tiếp từ session MODX hiện có, sẽ có sẵn trong GraphQL/request context của haih-agent. Điều này loại bỏ yêu cầu phải gọi riêng một request tới legacy endpoint modSociety hoặc khởi động lại (bootstrap) MODX cho mỗi request của frontend mới.

Hướng dẫn frontend mới của Kilfor nhận diện người dùng hiện tại trực tiếp thông qua session MODX hiện có mà không phụ thuộc vào legacy HTTP endpoint.

Nhiệm vụ

Tích hợp các phiên (session) frontend của MODX vào ngữ cảnh xác thực của haih-agent

Sửa lỗi xuất file PDF