[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

Thực hiện kiểm toán [kilfor.ru](https://kilfor.ru/) đang hoạt động:

- cấu trúc tài nguyên và các trang công khai;
- các template, chunk, snippet và phần phụ thuộc frontend;
- dữ liệu được sử dụng và phương thức lấy dữ liệu;
- các biểu mẫu và điểm tương tác công khai với backend;
- đăng nhập và chuyển hướng vào tài khoản cá nhân;
- URL hiện tại, chuyển hướng (redirect), metadata và các trang được lập chỉ mục;
- hình ảnh, tài liệu và các tài liệu công khai khác;
- dữ liệu lỗi thời và dấu vết của chủ sở hữu/tên gọi cũ;
- các tích hợp bên ngoài và bộ đếm.

Kết quả cần thiết dưới dạng bản đồ thực tế của lớp công khai trước khi tạo frontend mới. Không viết lại logic nghiệp vụ nội bộ của MODX trong phạm vi nhiệm vụ này.

Ghi nhận trạng thái hiện tại của phần công khai trên trang web và các phụ thuộc vào MODX.

Thực hiện kiểm toán kỹ thuật và nội dung cho kilfor.ru hiện tại

Xác định những dữ liệu và hành động nào mà frontend công cộng mới nên nhận từ MODX hiện có, đồng thời triển khai lớp tích hợp cần thiết.

Không chuyển đổi logic nghiệp vụ nội bộ sang frontend và không viết lại backend nếu không có nhu cầu riêng.

Đặc biệt chú ý đảm bảo rằng tài khoản cá nhân, thẻ ra vào, xe ra vào, dịch vụ công cộng và các quy trình nội bộ khác hiện có vẫn tiếp tục hoạt động mà không có thay đổi đối với người dùng.

Xác định và triển khai lớp tương tác an toàn giữa frontend mới với dữ liệu và các chức năng của MODX.

Tổ chức tích hợp frontend mới với backend MODX hiện có

Сейчас заявки на посетителей и заявки на внос/вынос - это разные сущности (на то были отдельные бизнес-требования со стороны заказчика, а так же отдельные права можно/нельзя). И исторически для работы с разными типами заявок были разные страницы и формы. Бизнес-логику и архитектору мы конечно же менять не будем, но вот интерфейсы можно и нужно унифицировать. Форму на создания делаем универсальную, просто добавляем переключатель Материальная или Просто на посетителя (просто чтобы корректней проверять заполненность формы, чтобы не получилось, что пользователь создал просто на посетителя, забыв указать что хочет занести или вынести, а фотма ему не подсветила). И на вывод можно использовать один интерфейс с использованием union-объекты в GraphQL.

Унифицировать интерфейсы заявок

## Контекст

Сессии пользователей Kilfor сейчас хранятся и обслуживаются MODX. Новый frontend на haih-agent уже реализует часть прикладной логики самостоятельно, поэтому ему периодически нужна детальная информация о текущем авторизованном пользователе.

В MODX есть внутренний PHP API для работы с текущим пользователем внутри MODX runtime, но штатного внешнего HTTP endpoint уровня `current user` для frontend-контекста из коробки нет. В modSociety существует собственный endpoint для получения пользователя, однако новый frontend не должен зависеть от этого legacy-компонента.

## Цель

Реализовать в haih-agent инфраструктурный слой, который умеет по существующей MODX session cookie определить пользователя, авторизованного в заданном frontend-контексте (`web` или другом), и предоставить нормализованные данные пользователя прикладному коду нового frontend.

## Что исследовать и реализовать

- Разобраться с фактическим форматом хранения frontend-сессий в используемой версии MODX и на Kilfor.
- Определить, как из session id и данных `modx_session` получить пользователя для конкретного context key.
- Корректно разбирать PHP session serialization, не привязываясь к regex-хаку.
- Получать необходимые данные пользователя из `modUser`, `modUserProfile` и проектных связей.
- Сделать MODX-specific реализацию отдельным адаптером/провайдером, чтобы прикладной код работал с абстракцией `currentUser`, а не знал структуру MODX session.
- Не зашивать `web` в низкоуровневый parser: context key должен задаваться конфигурацией или вызывающим auth-слоем.
- Учесть истечение/инвалидность сессии и отсутствие авторизации в запрашиваемом контексте.
- Не переносить целиком MODX ACL/security runtime без отдельной необходимости; на первом этапе задача — достоверно определить пользователя и его данные.
- Предусмотреть возможность другого session storage/handler в будущем, не связывая весь auth-код напрямую с SQL к `modx_session`.
- Покрыть parser и определение пользователя fixture/integration-тестами на реальных примерах MODX frontend-сессий.

## Ожидаемый результат

В GraphQL/request context haih-agent доступен нормализованный текущий пользователь для указанного frontend-контекста, полученный напрямую из существующей MODX-сессии. Для этого не требуется отдельный запрос к legacy endpoint modSociety или bootstrap MODX на каждый запрос нового frontend.

Научить новый frontend Kilfor определять текущего пользователя напрямую по существующей MODX-сессии без зависимости от legacy HTTP endpoint.

Nhiệm vụ

Интегрировать MODX frontend-сессии в auth-контекст haih-agent

Унифицировать интерфейсы заявок

Tổ chức tích hợp frontend mới với backend MODX hiện có

Thực hiện kiểm toán kỹ thuật và nội dung cho kilfor.ru hiện tại