# repos/yaogal — 主产品与 Web 前端

GitLab `yaogal` namespace，公司主产品线：站点、镜像与容器基础设施。

## 子项目

### docker-images — 容器镜像与生产编排（核心）
- `casdoor/`：**生产 compose** + `init/init.sh` 幂等 bootstrap（登录 admin →
  建 org `yaogal` → 建 application → 可选 seed plans → 写 `.client-id`）；
  `init/seed/plan-{free,pro}.json` 示例套餐。已部署生产，见 [](../60)
- `billing-service/`：计费服务镜像
- `keycloak/`：**legacy**，随 P2 迁移完成后删除

### account-site — 用户账户 SPA（已 deactivate，不再部署）
- React 19 + TypeScript + Vite；OIDC（Casdoor，PKCE + TOTP + 三方绑定），
  subscriptions 页已对接 Casdoor Plan/Subscription API
- 决策：Casdoor 自带 admin UI 已够用，**不再部署**；仓库保留作代码参考。
  其 `scripts/inject-config.mjs`（构建前注入 `CASDOOR_ORIGIN` 与 `.client-id`，
  检测到 `/realms/` 直接失败）是 SPA 接 Casdoor 的参考实现

### devpage-yaogal / compage-yaogal — 静态站点生成器
- Node.js + marked + gray-matter；分别对应开发状态页与公司项目展示页；
  `devpage-template` / `compage-template` 为可复用模板
- 经 `site-deploy` 管线发布

### openharmony-app — 移动端（billing）
- 实为 HarmonyOS NEXT 5.0.0(12) ArkTS 应用（命名有歧义），详见 [](../30)
- 认证硬编码 Keycloak 且跑不通，**待迁移 Casdoor + PKCE**（P2）