msarak

مسارك (Masarak) — арабская веб-платформа с направлением RTL, ориентированная на учащихся старших классов в Йемене и призванная помочь им исследовать свои склонности и системно понимать доступные академические и профессиональные варианты. Платформа объединяет каталог специальностей и исследовательский опыт на основе модели RIASEC, после чего выводит интерпретирующий результат и рекомендации, связанные со специальностями. В документации прямо указано, что платформа является инструментом ориентации и исследования, а не диагностическим психологическим тестом и не заменой решения самого учащегося, его семьи и консультантов. Проблема, которую решает проект, — сложность выбора университетской специальности у старшеклассников из-за ограниченного знания о специальностях, неясности склонностей, опоры на впечатления или мнения других, трудности сравнения вариантов и нехватки контента, ориентированного на местный контекст. Целевые пользователи делятся на две категории: учащийся, который хочет исследовать специальности, узнать свои склонности и получить рекомендации и интерпретацию, и незарегистрированный посетитель, который хочет ознакомиться с платформой, просмотреть и сравнить специальности до создания учётной записи. Целевой объём MVP включает: статический каталог академических специальностей внутри проекта, просмотр и сравнение информации о специальностях, создание учётной записи, вход и выход, сохранение прогресса учащегося, исследовательскую оценку из 18 ситуаций × 4 вариантов, сохранение ответов во время оценки, вычисление показателей RIASEC на сервере, интерпретацию результата в ориентирующем, не диагностическом языке, несколько рекомендаций, связанных со специальностями, сохранение предыдущих результатов, адаптивный арабский интерфейс RTL, автоматические тесты и проверки сборки перед слиянием. Вне текущего объёма MVP: панель администратора, административная статистика, CRUD для управления специальностями изнутри системы, отдельное публичное API, отдельное мобильное приложение, психологическая диагностика или сертифицированное психометрическое измерение, а также принятие обязательного решения за учащегося. В документации отмечается, что наличие функции в объёме не обязательно означает её текущую реализацию, а статус реализации отслеживается через Issues, Pull Requests и ветку main. Утверждённые технологии: Laravel 12 с PHP 8.2+, база данных MySQL 8.4.x, Eloquent ORM, шаблоны Blade, Tailwind CSS, JavaScript/Fetch, аутентификация Laravel Session с Cookies и CSRF, инструмент сборки Vite, Node.js 24.x, Composer 2.x и npm, тесты PHPUnit/Laravel Tests. Ключевые технические решения — Laravel Monolith, Blade + Tailwind, JavaScript/Fetch, MySQL 8.4.x, аутентификация на сессиях, routes/web.php, статический каталог специальностей и обработка RIASEC на сервере. В проекте прямо указано, что в MVP не используются React, Vue, SPA, Laravel Breeze, Sanctum, JWT, API Tokens, SQLite или MariaDB. Данные о специальностях хранятся в статическом файле внутри проекта: resources/data/specializations.json; в текущем MVP нет таблиц базы данных для специальностей, нет панели CRUD и нет панели управления контентом. Репозиторий содержит документацию по управлению проектом и отслеживанию работы, включая Mini-SRS/Requirements, Project Brief, Team Roles, AI Usage Log, Deliverables Checklist, Technical Decisions, System Architecture, System Workflows, Use Cases, а также файлы AI_Log.md, DELIVERABLES_CHECKLIST.md и папку docs. Рабочий процесс основан на GitHub Issues, ветках, Commits, Pull Requests, Code Review и GitHub Projects, с маршрутом: Issue → Branch → Implementation → Commit → Push → Pull Request → Review → Squash Merge → удаление ветки. Единственная постоянная ветка — main, и разработка напрямую в ней не ведётся. Для запуска требуются Git 2.x, PHP 8.2+, Composer 2.x, Node.js 24.x, npm и MySQL 8.4.x, с готовыми скриптами для Windows: check-environment.bat, setup-database.bat, setup-project.bat, verify-project.bat и start-project.bat. Также есть путь ручного запуска через composer install, npm ci, php artisan config:clear, migrate, test и npm run build, затем php artisan serve и npm run dev. Приложение работает на http://127.0.0.1:8000 с Health Check на /up. Был проведён фактический тест Clean Clone из GitHub в чистой среде, и он прошёл все этапы: структура репозитория, проверка среды, настройка базы данных, установка Composer и npm, инициализация Laravel, миграции, тесты Laravel, сборка Vite, подключение к MySQL, полная проверка и проверка безопасности Git. Указанная тестовая среда: Laravel 12.69.1, PHP 8.2.12, Composer 2.9.5, Node.js 24.13.1, npm 11.8.0, MySQL 8.4.11 и Git 2.50.1. Правила проекта включают запрет прямого Push в main, запрет загрузки .env, паролей, токенов или секретов, отслеживание composer.lock и package-lock.json, запрет использования composer update или npm update при обычной настройке, запрет добавления функции вне объёма без Issue и чёткого решения, а также требование понимать любой код, сгенерированный ИИ, перед использованием и документировать значимое использование в AI_Log.md. Статус проекта: на данный момент завершены утверждение идеи и объёма, подготовка основной документации, создание репозитория и настройка защиты main, шаблоны Issues и Pull Requests, Labels, GitHub Project со статусами Backlog → Ready → In Progress → In Review → Done, пять Milestones, 15 Issue, GitHub Actions для автоматической проверки, скрипты среды, настройки и проверки, а также пройден Clean Clone. В процессе выполнения: Batch 3 — Assessment Journey, Batch 4 — Results & Security, Batch 5 — Finalization & Release, закрытие оставшихся Issues и финальная проверка. Безопасность: репозиторий не содержит локальных учётных данных, .env существует только локально и запрещён к загрузке, Laravel использует сессии, cookies, защиту CSRF и хеширование паролей, а административные данные root не используются для повседневной работы приложения.