msarak

مسارك（Masarak）是一个面向也门高中生的阿拉伯语RTL Web平台，旨在帮助他们有条理地探索自身兴趣，并理解可用的学术与职业选择。该平台结合了专业指南与基于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、带Cookies和CSRF的Laravel Session认证、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，健康检查位于/up。 已在干净环境中从GitHub执行实际Clean Clone测试，并通过所有阶段：仓库结构、环境检查、数据库设置、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生成代码，并在AI_Log.md中记录有影响的AI使用。 项目状态：目前已完成理念与范围确认、基础文档准备、仓库创建与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管理凭据。