refactor: enhance history and notification permission checks with UI request handling

Author: Siziy Ivan

docs/Catalog.md

@@ -505,7 +505,7 @@ interface CatalogItem extends Item {
   description?: string;
 }
 
-// Группа продуктов
+// Product group
 class ProductGroup extends AbstractGroup<CatalogItem> {
   readonly type = 'group';
   readonly name = 'Product Group';
@@ -634,7 +634,7 @@ class ProductGroup extends AbstractGroup<CatalogItem> {
   }
 }
 
-// Продукт
+// Product
 class ProductItem extends AbstractItem<CatalogItem> {
   readonly type = 'product';
   readonly name = 'Product';
@@ -772,7 +772,7 @@ class ProductItem extends AbstractItem<CatalogItem> {
   }
 }
 
-// Каталог продуктов
+// Product catalog
 export class ProductCatalog extends AbstractCatalog {
   readonly name = 'Product Catalog';
   readonly slug = 'products';
@@ -791,12 +791,12 @@ export class ProductCatalog extends AbstractCatalog {
 ### Регистрация каталога
 
 ```typescript
-// В файле инициализации Adminizer
+// In the Adminizer bootstrap file
 import { ProductCatalog } from './lib/catalog/ProductCatalog';
 
 const adminizer = new Adminizer(/* config */);
 
-// Регистрация каталога
+// Catalog registration
 adminizer.catalogHandler.add(new ProductCatalog(adminizer));
 ```
 

docs/CommentTranslation.md

@@ -0,0 +1,21 @@
+# Comment Translation to English
+
+## Scope
+
+Project comments were translated from Russian to English across:
+
+- Backend source files in `src/`
+- Frontend source files in `src/assets/js/`
+- Test files in `test/`
+- Fixture and module helper files in `fixture/` and `modules/`
+- Code snippets in documentation where inline code comments were still in Russian
+
+## Validation
+
+To verify that no Russian comments remain, run:
+
+```bash
+rg -n --pcre2 --hidden --glob '!.git' --glob '!node_modules' --glob '!dist' '(//[^\n]*[А-Яа-яЁё])|(\/\*[^\n]*[А-Яа-яЁё][^\n]*\*\/)|(^\s*\*[^\n]*[А-Яа-яЁё])'
+```
+
+Expected result: no matches.

docs/configuration.md

@@ -415,7 +415,7 @@ This configuration loads all sail models as they are. Just place  in `config\adm
 
 ```javascript
 // @ts-check
-// import { AdminizerConfig } from "adminizer"; // Тип импортируем через комментарий
+// import { AdminizerConfig } from "adminizer"; // Import the type via JSDoc comment
 
 /** @type {import("adminizer").AdminizerConfig} */
 const config = {
@@ -752,4 +752,4 @@ displayModifier: function (data) {
     // for edit view    
     return data.label + data.date
 }
-```
+```

eslint.config.mjs

@@ -33,7 +33,7 @@ export default [
 
         rules: {
             "no-console": "warn",
-            // Отключаем все правила, кроме @typescript-eslint/no-explicit-any
+            // Disable all rules except @typescript-eslint/no-explicit-any
             "no-unused-vars": "off",
             "no-undef": "off",
             "no-warning-comments": ["error", {

fixture/cors-api/api.ts

@@ -6,10 +6,10 @@ export function corsApi(adminizer: Adminizer) {
     const routePrefix = adminizer.config.routePrefix || '';
     const frontendJwtSecret = process.env.FRONTEND_JWT_SECRET || 'frontend-secret';
 
-    // Эндпоинт для получения CSRF токена
+    // Endpoint for receiving a CSRF token
     adminizer.app.get(`${routePrefix}/api/csrf-token`, (req: any, res: any) => {
-        // Inertia middleware уже установила токен в cookies
-        // Мы просто возвращаем его в ответе для удобства
+        // Inertia middleware has already set the token in cookies
+        // We're just returning it in the response for convenience.
         const csrfToken = req.cookies['XSRF-TOKEN'];
         res.json({
             csrfToken,
@@ -62,7 +62,7 @@ export function corsApi(adminizer: Adminizer) {
                 httpOnly: true,
                 sameSite: 'lax',
                 path: '/',
-                maxAge: 60 * 60 * 24 * 7 * 2, // 2 недели
+                maxAge: 60 * 60 * 24 * 7 * 2, // 2 weeks
             }));
 
             res.json({

fixture/helpers/notifications.ts

@@ -6,7 +6,7 @@ export interface SendNotificationsOptions {
     delayMs?: number;
     userId?: number;
     onlyGeneral?: boolean;
-    generalRatio?: number; // Вероятность general уведомлений (0-1)
+    generalRatio?: number; // Probability of general notifications (0-1)
 }
 
 export async function sendNotificationsWithDelay(
@@ -16,15 +16,15 @@ export async function sendNotificationsWithDelay(
     const {
         count = 10,
         delayMs = 2000,
-        generalRatio = 0.7 // 70% general, 30% system по умолчанию
+        generalRatio = 0.7 // 70% general, 30% system default
     } = options;
 
     const systemChannels = ['created', 'updated', 'deleted', 'system'] as const;
     const entities = ['user', 'product', 'order', 'category', 'payment'] as const;
     const actions = ['create', 'update', 'delete', 'approve', 'reject'] as const;
 
     const generateRandomNotification = (): Omit<INotification, 'id' | 'createdAt' | 'icon'> => {
-        // Определяем тип уведомления с учетом вероятности
+        // Determining the type of notification based on probability
         const isGeneral = options.onlyGeneral ? true : faker.number.float({ min: 0, max: 1 }) < generalRatio;
 
         if (!isGeneral) {
@@ -56,9 +56,9 @@ export async function sendNotificationsWithDelay(
         } else {
             // General notification
             const userIdOption = options.userId ?? faker.helpers.arrayElement([
-                undefined, // для всех пользователей
-                1,         // пользователь с ID 1
-                2          // пользователь с ID 2
+                undefined, // for all users
+                1,         // user with ID 1
+                2          // user with ID 2
             ]);
 
             const hasUserId = userIdOption !== undefined;
@@ -82,7 +82,7 @@ export async function sendNotificationsWithDelay(
                 channel: '',
             };
 
-            // Добавляем userId только если он указан
+            // Add userId only if it is specified
             if (hasUserId) {
                 return {
                     ...notification,

fixture/helpers/seedDatabase.ts

@@ -96,7 +96,7 @@ export async function seedDatabase(
         : await userModel.create(userData).fetch();
 
 
-      // Привязка к группам (упрощённая логика)
+      // Linking to groups (simplified logic)
       const groupName = u.isAdministrator ? 'Admins' : 'Users';
 
       const group = isSequelize
@@ -120,7 +120,7 @@ export async function seedDatabase(
   const allUsers: UserAP[] = isSequelize
     ? await userModel.findAll()
     : await userModel.find();
-    
+
     if (exampleCount === 0) {
       const fakeExamples = Array.from({ length: count }, () => {
         const randomUser = faker.helpers.arrayElement(allUsers);
@@ -155,7 +155,7 @@ export async function seedDatabase(
       await exampleModel.createEach(fakeExamples).fetch();
     }
   }
- 
+
     // ------------------ Tests ------------------ //
     const testCount = isSequelize
     ? await testModel.count()

fixture/index.ts

@@ -237,7 +237,7 @@ async function ormSharedFixtureLift(adminizer: Adminizer) {
         adminizer.catalogHandler.add(new TestCatalog(adminizer, 'testcatalog'))
 
         /** Test notifications */
-        //setTimeout(() => sendNotificationsWithDelay(adminizer, {count: 150, onlyGeneral: false, generalRatio: 0.5, delayMs: 300}), 5000); // Начальная задержка 10 секунд
+        //setTimeout(() => sendNotificationsWithDelay(adminizer, {count: 150, onlyGeneral: false, generalRatio: 0.5, delayMs: 300}), 5000); // Initial delay 10 seconds
 
     } catch (e) {
         console.log(e)

fixture/models/sequelize/Example.ts

@@ -108,7 +108,7 @@ import {UserAP} from "../../../src";
     static associate(sequelize: Sequelize) {
       const UserAPModel = sequelize.model('UserAP') as ModelStatic<Model<UserAP>>;
 
-      // 1-to-1: ownerId → один UserAP
+      // 1-to-1: ownerId -> one UserAP
       this.belongsTo(UserAPModel, {
         foreignKey: 'ownerId',
         as: 'owner',

fixture/models/sequelize/Test.ts

@@ -63,19 +63,19 @@ export class Test extends Model<
     declare owner?: UserAP;
 
     // ——————————————————————————————————————————————
-    // Many-to-many с UserAP через `test_useraps`
+    // Many-to-many with UserAP via `test_useraps`
     // ——————————————————————————————————————————————
     declare userAPs?: UserAP[];
 
     static associate(sequelize: Sequelize) {
         const UserAPModel = sequelize.model('UserAP') as ModelStatic<Model<UserAP>>;
-        // 1-to-1: ownerId → один UserAP
+        // 1-to-1: ownerId -> one UserAP
         this.belongsTo(UserAPModel, {
             foreignKey: 'ownerId',
             as: 'owner',
         });
 
-        // M-to-N: через таблицу test_useraps
+        // M-to-N: via the test_useraps table
         this.belongsToMany(UserAPModel, {
             through: 'test_useraps',
             foreignKey: 'testId',