diff --git a/AGENTS.md b/AGENTS.md index ef2690a..eb79f9e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -30,6 +30,7 @@ | `lpt-be` | Java Spring Boot 后端,提供 REST API、认证、数据库访问 | | `lpt-fe` | Vue 3 + TypeScript 前端 | | `lpt-ai` | TypeScript + Fastify 独立 AI 服务 | +| `lpt-android` | Android 客户端(Kotlin + Compose),学习会话 + 系统级悬浮窗 | | `lpt-infra` | Kubernetes / Traefik 部署与基础设施清单 | | `lpt-docs` | 概念与设计文档项目,只维护系统概念和设计思路 | @@ -42,12 +43,13 @@ | `lpt-be` | `ssh://git@git.cat-shark.xyz:2222/cat-shark/lpt-be.git` | `master` | | `lpt-fe` | `ssh://git@git.cat-shark.xyz:2222/cat-shark/lpt-fe.git` | `master` | | `lpt-ai` | `ssh://git@git.cat-shark.xyz:2222/cat-shark/lpt-ai.git` | `master` | +| `lpt-android` | `ssh://git@git.cat-shark.xyz:2222/cat-shark/lpt-android.git` | `master` | | `lpt-infra` | `ssh://git@git.cat-shark.xyz:2222/cat-shark/lpt-infra.git` | `master` | | `lpt-docs` | `ssh://git@git.cat-shark.xyz:2222/cat-shark/lpt-docs.git` | `main` | > 「默认拉取分支」只用于首次克隆初始化,下面 `git clone -b` 用的就是这一列。clone 完成后不要假定工作分支:动手前先 `git branch --show-current` 看仓库实际所在分支。 > -> **分支 ↔ 环境对应**:`lpt-be` / `lpt-fe` / `lpt-ai` 均为「`master` → prod、`dev` → dev」,部署流水线第一步会校验两者匹配,跨环境出包(例如用 `dev` 发 prod)会被直接拒绝;`lpt-ai` 的 `main` 是历史分支(停在 prod 冻结点),不再用于发版。`lpt-infra` 单分支(`master`),靠 `dev/` 与 `prod/` 目录区分清单。`lpt-docs` 不参与部署。 +> **分支 ↔ 环境对应**:`lpt-be` / `lpt-fe` / `lpt-ai` 均为「`master` → prod、`dev` → dev」,部署流水线第一步会校验两者匹配,跨环境出包(例如用 `dev` 发 prod)会被直接拒绝;`lpt-ai` 的 `main` 是历史分支(停在 prod 冻结点),不再用于发版。`lpt-infra` 单分支(`master`),靠 `dev/` 与 `prod/` 目录区分清单。`lpt-android` 单分支(`master`),不参与部署,客户端直连后端 dev 环境。`lpt-docs` 不参与部署。 ## 首次初始化 @@ -63,6 +65,7 @@ git clone -b main ssh://git@git.cat-shark.xyz:2222/cat-shark/lpt-meta.git lpt-me git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/lpt-be.git lpt-be git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/lpt-fe.git lpt-fe git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/lpt-ai.git lpt-ai +git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/lpt-android.git lpt-android git clone -b master ssh://git@git.cat-shark.xyz:2222/cat-shark/lpt-infra.git lpt-infra git clone -b main ssh://git@git.cat-shark.xyz:2222/cat-shark/lpt-docs.git lpt-docs ``` @@ -74,9 +77,11 @@ clone 完成后,进入或修改某个子项目前,先读取该子项目根 ```text 浏览器 → lpt-fe (5158) ──/api──→ lpt-be (5157) ──HTTP──→ lpt-ai (5199) │ +Android → lpt-android ──/api──────────┤ └── MySQL ``` +lpt-android 通过 REST 直连后端,认证走 Sa-Token 请求头 `satoken`,只使用学习会话相关端点。 lpt-infra 提供 dev/prod 的 Kubernetes 清单和 Traefik 路由。 ## 图表