ai-mms：实践指南

面对实际交付，我看ai-mms的重点不在星标，而在这项能力：高等教育信息技术学院的特许经营课程注册 LMS 和 TMS — 来自单个代码库的每个合作伙伴网站一个商店 (SG/MY/GH)。把它放到部署与运行环境流程中，最容易暴露的是权限、依赖和环境差异会放大维护成本，不能只看演示是否顺利。短测时我会在非生产环境复现一次安装与运行，并保留依赖锁定、权限边界、日志、回滚和资源消耗的结果，方便团队复盘。整体来看，它适合愿意维护环境并重视故障恢复的工程团队拿来做对照测试，最终决定仍应回到真实结果和维护状态。

截图

管理指南

从管理员运行 LMS 的分步、屏幕截图驱动指南 面板 — 参见 docs/admin-guide/：

• 管理指南索引 — 登录、管理商店
• 更改课程费用
• 更改货币兑换率

关于

高等教育课程 LMS 是一个完整的生产级课程注册和学习管理平台，基于 OpenMage 1.x (Magento 1 LTS) 构建，并为高等教育信息技术学院定制。每件产品都是一个课程（讲师指导的培训、研讨会、认证）——没有实物库存或运输。店面是课程注册门户，管理面板被重新命名为教师和操作人员的培训管理系统。

该系统以特许经营模式运行：

• 课件由新加坡高等教育课程提供和支持。 加盟商可以插入现成的 WSQ / IBF / SkillsFuture-aligned 课程目录 - 他们不必从头开始创作内容。
• 每个特许经营合作伙伴都托管自己的服务器。 相同的代码库（此存储库）部署到每个合作伙伴自己的服务器+数据库 - 每个网站一个商店，完全独立（自己的域、货币、语言、定价、资金挂钩）。没有共享的多商店安装，没有共享的目录，没有跨站点重定向。
• 实时合作伙伴网站： tertiarycourses.com.sg · tertiarycourses.com.my · tertiarycourses.com.gh。

Become a franchise partner

想要在您的国家/地区运营一所由 AI- 提供支持的未来技术培训学院 - 使用现成的 WSQ / IBF / SkillsFuture-aligned 目录并在您自己的服务器上设置此 LMS 吗？ 申请成为特许经营合作伙伴 — 在网站上填写申请表，我们的团队将与您联系。

主要特点

手风琴中自动提取）、Magento 标签重用、点攒、社交分享、R2 英雄图像。代理团队撰写 2 个 posts/week：研究代理（Claude 网络搜索）侦察最新的 AI 主题，作家代理制作一篇深入的帖子，其中包含品牌的、以主题为主题的自动生成的英雄（13 个关键字选择的主题，包括 Microsoft Copilot 系列，因此一系列帖子呈现为一组），经理通过电子邮件或管理时间线批准，批准的帖子于周二发布和周五上午 9 点，然后自动分享到 LinkedIn + Meta 社交平台。管理员从博客管道面板对下一个课程进行排队。 | | **课程目录APIs** | SG 目录的经过密钥验证的只读 JSON 源 -/courses/api_wsq（TGS- 课程）和 /courses/api_nonwsq（C- 课程），保留为单独的端点，因此两个资金轨道永远不会混合。添加 ?fields=full以获取详细描述、适用性、先决条件和评估。在/courses/api_courses?sku=和/courses/api_schedule上实时查询每门课程和时间表。每个端点都记录在管理 **API 摘要** 面板中。 | | **AI- 概览就绪架构** | 课程页面会发出丰富的课程 JSON-LD — SKU 为courseCode、聚合评论评分，以及 **真正即将上课的日期** 作为从课程日期选项解析的 CourseInstance` 条目 — 加上 BreadcrumbList；该博客发出 BlogPosting / FAQPage / CollectionPage。仅结构化数据，零视觉变化。 | | Ultimo店面 | 高级响应式主题+自定义深色管理主题。 |

技术堆栈

可以通过请求更改并再次审核重新打开已安排的未发送的新闻通讯传单。 管道在从反馈重新生成之前验证 MailerLite 取消， 释放已取消的发送槽，并需要新的经理批准。已经 发送或毁坏的传单不能重新打开；现有社会职位不变。 运行孤立回归检查 docker exec ai-mms-web-1 php /var/www/html/scripts/local-dev/test-flyer-scheduled-changes.php. 凭证 → AI 提供者 选择 Claude（现有 OAuth/API 配置）或 OpenAI OAuth 在全球范围内用于电子邮件回复草稿、博客 research/writing、时事通讯 聊天、传单修订、SEO 和宣传册副本。 OpenAI 通过 gpt-5.6-sol 使用 官方 @openai/codex-sdk (0.149.0)。可选的、显式启用的后备用途 @anthropic-ai/claude-agent-sdk (0.3.268) 和经过测试的 克劳德 OAuth 与 claude-opus-5 连接。先尝试OpenAI；失败了 通过 Claude 使用相同的 prompt/images/research 模式重试一次。 回退使用记录在 var/log/ai-provider.log 中；两次失败都保留了内容。 Claude OAuth — Opus 5 备份卡测试并加密替换令牌 无需更改主要提供商。它还提供管理的克劳德 当 Claude 被选为主时的连接。导入法典 ChatGPT OAuth auth.json; 测试并保存提供程序之前验证模型访问 激活。只有 admin/training-provider 角色可以更改全局连接。 OAuth 代币在数据库中加密，永不显示，并具体化 仅在私人临时会话中（无 shell、插件或应用程序工具）。参考 图像和博客研究网络搜索被保留。将 auth.json 排除在 Git 之外， 电子邮件和聊天。更改提供商不会批准或发送待处理的内容。 设备登录参见OpenAI认证。

两个 OAuth-compatible SDKs 都通过 scripts/ai/bridge.mjs 运行，并固定， Docker 中经过锁定文件验证的依赖项和 Node 22。 Codex SDK 使用 校验和固定的 Codex 运行时； Claude Agent SDK 使用其匹配的捆绑运行时。 这些是官方代理SDKs，而不是REST API-key客户端。 SDK 环境 被隔离，除了明确要求的研究搜索之外，工具访问被禁用， 和 credentials/prompts 不包含在错误输出中。运行 SDK 边界测试 npm ci --prefix scripts/ai 之后为 node --test scripts/ai/bridge.test.mjs。

克劳德模式传单生成路线订阅 OAuth 通过安装 克劳德客户； API 密钥使用消息 API。组织级访问拒绝保留修订 无需通过电子邮件发送拒绝副本并显示可操作的管理错误。认证 路由检查：docker exec ai-mms-web-1 php /var/www/html/scripts/local-dev/test-flyer-claude-auth.php。 提供商检查：docker exec ai-mms-web-1 php /var/www/html/scripts/local-dev/test-ai-provider.php。

建筑

        FRANCHISE PARTNERS — same codebase, each on its own server + DB
            com.sg           com.my           com.gh
        (one store per site · independent · no cross-site redirects)
                                       │
                                       ▼
┌──────────────────────────────────────────────────────────────────────────┐
│  STOREFRONT  (Ultimo theme · course-registration portal)                   │
│  Browse courses → register (cart/checkout) → pay → confirmation email       │
└──────────────────────────────────────────────────────────────────────────┘
                                       │  order = registration
                                       ▼
┌──────────────────────────────────────────────────────────────────────────┐
│  BACKEND  (cron, every 1 min — out-of-band, frontend untouched)            │
│  ClassFormation → CourseRunEnrolmentService                                 │
│        │                                   │                                │
│        ▼                                   ▼                                │
│  course_runs  (class instance,        course_run_enrolments (roster,        │
│   class_id = C000042 …)                idempotent INSERT IGNORE)            │
└──────────────────────────────────────────────────────────────────────────┘
                                       │
                                       ▼
┌──────────────────────────────────────────────────────────────────────────┐
│  ADMIN  (Training Management System · dark theme · six-role ACL)            │
│  Classes · Rosters · Trainers · Attendance · Certificates · Pro Formas      │
└──────────────────────────────────────────────────────────────────────────┘

特许经营数据模型 - 六个公理： 产品 = 课程 · 班级标识 = (course_code, title, start_date) · 班级存储 = 一行 course_runs （class_id 与 C000042 类似 - 每个站点的统一序列） · 订单 = 注册 · 花名册 = course_run_enrolments · 用户 = 六角色联盟具有统一账户。

项目结构

ai-mms/
├── app/
│   ├── code/
│   │   ├── core/Mage/      # OpenMage LTS core
│   │   ├── local/MMD/      # Custom franchise modules (see below)
│   │   └── community/      # Stripe, HitPay
│   ├── design/             # Storefront + admin templates (.phtml)
│   └── etc/                # local.xml, modules/
├── skin/                   # Ultimo theme + dark admin theme (CSS/JS)
├── lib/                    # Varien / Zend / Magento libraries
├── migrations/             # Numbered *.sql applied by apply.php on deploy
├── scripts/                # local-dev fixups + maintenance scripts
├── docker/                 # entrypoint.sh, php.ini, Apache config
├── docker-compose.yml      # Local dev stack (web + MySQL)
└── Dockerfile              # Production image

自定义模块 ( app/code/local/MMD/ )

开始使用

先决条件

• Docker Desktop 安装并运行
• 放置在项目根目录中的基础数据库转储 (courses_mysql2.sql)

安装（推荐：Docker Compose）

# 1. Clone
git clone https://github.com/alfredang/ai-mms.git
cd ai-mms

# 2. Configure environment
cp .env.example .env                       # set MySQL passwords + API keys
cp app/etc/local.xml.example app/etc/local.xml   # match DB credentials to .env

# 3. Build and start the stack
docker compose up -d --build

# 4. Import the base database
docker exec -i ai-mms-db_mysql-1 
  mysql -u root -p"$MYSQL_ROOT_PASSWORD" "$MYSQL_DATABASE" < courses_mysql2.sql

# 5. Apply migrations (schema + data) via the real runner
docker exec ai-mms-web-1 php /var/www/html/migrations/apply.php

# 6. Apply local-dev fixups (localhost URLs, disable admin captcha, enable products)
for f in scripts/local-dev/*.sql; do
  docker exec -i ai-mms-db_mysql-1 mysql -u root -p"$MYSQL_ROOT_PASSWORD" "$MYSQL_DATABASE" < "$f"
done

# 7. Install Composer dependencies + clear cache
docker exec ai-mms-web-1 bash -c 'cd /var/www/html && composer install --no-dev --optimize-autoloader'
docker exec ai-mms-web-1 bash -c 'rm -rf /var/www/html/var/cache/* /var/www/html/var/full_page_cache/*'

访问

码头服务

部署

每个特许经营合作伙伴的服务器都会在每次推送到 main 时通过其 自己的 Coolify 实例 自动部署（每个都通过 Coolify 的 GitHub 应用程序 git 源连接）：

1. Coolify 从推送的提交中重建镜像。
2. docker/entrypoint.sh 清除 Magento 运行时缓存，然后运行 migrations/apply.php（当 DB 出现时使用 retry/backoff）。
3. 如果迁移失败，容器将以非零值退出，因此 Coolify 会保留之前的容器——流量永远不会针对过时的模式提供服务。
4. 构建时间戳写入/version.txt；公共迁移状态位于 /media/migrations-status.json。

用户上传的媒体（目录 product/category 画廊）由 Cloudflare R2 提供；主题烘焙的资源在图像内传送。

贡献者注意： 在验证本地主机无错误之前，切勿使用 git push — 每次推送时都会重新部署生产。 Lint 更改了 PHP，确认重写实例化，命中受影响的路由，并在推送之前通过 migrations/apply.php（不是 mysql 客户端）试运行新迁移。

开发者

高等教育信息科技学院私人有限公司有限公司 tertiarycourses.com.sg · ✉ 询问@tertiaryinfotech.com · ☎ +65 6100 0613