概述

文学院技术技能开发应用。基于Laravel 12构建，并集成Filament管理面板。

![Open in GitHub Codespaces]([***]

Docker开发指南

Docker安装

必须安装并配置好Docker环境。

环境文件配置

请将example.env文件复制并重命名为**.env**：

cp docker/example.env docker/.env

如有需要可修改配置值，默认值适用于本地开发环境。

同时请将docker-compose.override.yml.dev文件复制并重命名为docker-compose.override.yml：

cp docker-compose.override.yml.dev docker-compose.override.yml

如有需要可修改配置值，默认值适用于本地开发环境。

编辑hosts文件

编辑系统hosts文件，将training.lan指向Docker主机IP。

安装与配置

构建并启动项目所有容器：

docker compose up（添加-d参数可后台运行并隐藏日志输出）

数据库初始化

首次运行应用需初始化数据库数据：

docker exec train-app php artisan db:seed

如需清空数据库并重新初始化：

docker exec train-app php artisan migrate:fresh --seed

资源文件编译

容器构建时会自动编译资源文件，如需手动重新编译：

docker exec train-app npm run dev

如需实时监控文件变化并自动编译：

docker exec train-app npm run watch

访问入口

主应用

访问链接：[***]

管理面板

访问链接：[***]

登录凭据：*** / password

Telescope调试工具

访问链接：[***]

phpMyAdmin数据库管理

访问链接：[***]

登录信息：

• 服务器：train-mysql
• 用户名：user
• 密码：password

MailHog邮件测试

访问链接：[***]

JSON格式查看邮件：[***]

PHP代码规范检查

CI流程会自动检查PHP代码规范，本地可提前执行检查：

docker exec train-app ./vendor/bin/pint --test

自动修复代码规范问题：

docker exec train-app ./vendor/bin/pint

测试

单元/功能测试

运行完整测试套件：

docker exec -it train-app php artisan test

浏览器测试

运行完整浏览器测试套件：

docker exec -it train-app php artisan dusk --env=testing

运行特定测试类：

docker exec -it train-app php artisan dusk tests/Browser/MyTest.php --env=testing

查看浏览器测试实时画面：访问[***]"Sessions"，找到对应测试会话并点击摄像头图标，使用密码"secret"登录VNC查看。

Docker部署指南

环境文件配置

复制并重命名以下环境文件：

cp docker/example.env docker/.env
cp site/.env.example site/.env

需修改配置值，默认值不适用于生产环境。

若需启用Shibboleth认证，需在site/.env中取消注释并设置SHIB_HOSTNAME和SHIB_CONTACT变量，否则仅支持Filament认证。

同时请将docker-compose.override.yml.prod文件复制并重命名为docker-compose.override.yml：

cp docker-compose.override.yml.prod docker-compose.override.yml

如有需要可修改配置值，默认值适用于生产环境。

安装与配置

构建并启动生产环境容器：

docker compose up -d

反向代理配置

需配置反向代理，将访问域名映射到容器的8686端口。

Docker镜像信息

GitHub Actions工作流根据以下事件生成镜像标签：

• 推送到development分支：生成dev-latest、stage-latest、stage-<commit哈希>-<时间戳>（不可变标签）
• 推送到master分支：生成latest标签
• 推送Git标签：生成vX.Y.Z标签（不可变标签）

每周定时任务：

• 生成更新的测试环境镜像：stage-<commit哈希>-<时间戳>（不可变标签）
• 生成更新的生产候选镜像：vX.Y.Z-<commit哈希>-<时间戳>（不可变标签）

所有不可变标签均提交至k8s仓库。

错误跟踪

[***]

Helm图表

项目Helm图表位于k8s仓库的training目录下。