Initial cube docs: README + oci migration todo

cube 是跑在 famzheng.me 节点上的小 app 平台，用来收纳从 oci
迁过来的 Fam 个人小工具。oci 主机本身留给 Hera，不退役。

- README.md：定位、迁移名单、注意事项
- doc/todo.md：迁移清单（portfolio / repo-vis / simpleasm / guitar / pyroblem）

README.md

@@ -0,0 +1,32 @@
+# 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）

doc/todo.md

@@ -0,0 +1,24 @@
+# cube 迁移清单
+
+把 oci 节点（`oci.euphon.net`，ARM Ubuntu 22.04 + k3s + traefik ingress）上 Fam 自己的小 web app 迁到 cube（跑在 `famzheng.me` 节点上）。整理时间 2026-05-04。
+
+> oci 主机本身不退役 —— 留给 Hera 同学继续用。所以这里只列**要从 oci 迁出**的应用，留在 oci 的其他服务一律不提。
+
+---
+
+## 一、会迁
+
+| 应用 | 当前域名 | 用途 | 备注 |
+|---|---|---|---|
+| `portfolio` | portfolio.oci.euphon.net | 投资组合追踪 | **不在 k3s 里**——host systemd `portfolio.service`，uvicorn `:8890`，python3 直跑 |
+| `repo-vis`  | repo-vis.oci.euphon.net  | git 仓库可视化 | k3s ns `repo-vis` |
+| `simpleasm` | asm.oci.euphon.net       | 汇编教学/玩具  | k3s ns `simpleasm` |
+| `guitar`    | player.oci.euphon.net    | 吉他 player（chord / tabs?） | 2 容器 sidecar |
+| `pyroblem`  | ?                        | ?            | Fam 2026-05-04 补加，详情待补 |
+
+---
+
+## 二、迁移注意事项
+
+- **域名**：oci 上 ingress 都挂在 `*.oci.euphon.net` 等域名下。迁到 cube 后切到 `*.famzheng.me`（节点主域），DNS 已是 wildcard A 记录，无需新加。是否保留旧域名做 redirect 另议。
+- **portfolio 特殊**：host systemd 跑的，不在 k3s 里。迁过来要么沿用 systemd（直接放本机 `/home/fam` 下跑）、要么打 docker image 进 k3s。