# cube

Fam 的小 app 平台。

## 是什么

`cube` 是一个跑在 **`famzheng.me` 节点**（hostname `famzheng.com`，单节点 k3s + traefik + gitea，公网 IP `178.104.186.206`）上的小 app 平台，专门收纳 Fam 自己写的一堆小工具/玩具 web app。底层硬件、k3s、Gitea、act_runner 等基础设施详见 `~/.claude/memory/infra.md`。

主要任务：把目前散落在 `oci.euphon.net`（Oracle Cloud ARM VM）上**值得留下**的 Fam 个人小 app 迁过来。oci 主机本身不退役，留给 Hera 同学继续用。

## 当前状态

- 仓库刚初始化（2026-05-04），还没有任何部署清单 / 脚本。
- 迁移名单和注意事项见 [`doc/todo.md`](doc/todo.md)。

## 迁移名单（截至 2026-05-04）

- `portfolio`（host systemd `portfolio.service`，uvicorn `:8890`，**不在 k3s 里**）
- `repo-vis`
- `simpleasm`
- `guitar`
- `pyroblem`（详情待补）

## 迁移注意事项

- **域名**：oci 上 ingress 都挂在 `*.oci.euphon.net` 等域名下。迁过来后切到 `*.famzheng.me`（cube 所在节点的主域），DNS 已是 wildcard A 记录，无需新加。
- **portfolio 特殊**：host systemd 跑的，不在 k3s 里。迁移时要么沿用 systemd（直接放本机 `/home/fam` 下跑），要么打 docker image 进 k3s。

## 相关

- 宿主节点：`famzheng.me` / hostname `famzheng.com` —— 详见 `~/.claude/memory/infra.md`
- 迁移源：`oci.euphon.net`（ARM Ubuntu 22.04 + k3s）