第一次提交

README.md

@@ -0,0 +1,107 @@
+# nano_project
+
+按当前部署模型整理后的顶层目录：
+
+- `app-instance/`
+  - 单用户实例容器。
+  - 一个容器里同时包含前端和后端。
+  - `backend/` 来自 `nanobot-backend`
+  - `frontend/` 来自 `nanobot-fronted`
+  - 已包含统一 Dockerfile、启动脚本和实例管理脚本。
+- `authz-service/`
+  - 鉴权服务容器。
+  - `src/` 来自 `Authz-service`
+  - `runtime/` 预留给后续启动脚本、数据目录映射说明。
+- `auth-portal/`
+  - 登录 / 注册 / 跳转入口容器。
+  - `src/` 来自 `nanobot-auth-portal`
+  - `runtime/` 预留给后续启动脚本和环境配置。
+- `deploy-control/`
+  - 部署机接口容器。
+  - 负责创建实例、解析实例路由、刷新反向代理。
+- `router-proxy/`
+  - 专属 URL 到实例容器的反向代理容器。
+  - 按 Host 路由到对应 `app-instance`。
+
+## 说明
+
+这里的代码目录现在是实际副本，不再依赖符号链接。
+
+原始来源是：
+
+- `/home/ivan/xuan/nano_project/app-instance/backend` 来自 `/home/ivan/xuan/steven_project/nanobot-backend`
+- `/home/ivan/xuan/nano_project/app-instance/frontend` 来自 `/home/ivan/xuan/steven_project/nanobot-fronted`
+- `/home/ivan/xuan/nano_project/authz-service/src` 来自 `/home/ivan/xuan/steven_project/Authz-service`
+- `/home/ivan/xuan/nano_project/auth-portal/src` 来自 `/home/ivan/xuan/steven_project/nanobot-auth-portal`
+
+之后你在 `nano_project` 里继续改代码，不会再联动改到原仓库。
+
+## 本次复制排除项
+
+为避免把本地依赖和构建垃圾一起带过来，这次复制排除了这些内容：
+
+- `.git/`
+- `.venv/`
+- `node_modules/`
+- `.next/`
+- `.next-dev/`
+- `.pytest_cache/`
+- `.ruff_cache/`
+- `__pycache__/`
+- `dist/`
+- `build/`
+- `*.pyc`
+- `tsconfig.tsbuildinfo`
+- `.env`
+- `.env.local`
+
+## 当前结构
+
+```text
+/home/ivan/xuan/nano_project
+├── README.md
+├── app-instance
+│   ├── backend/
+│   ├── frontend/
+│   └── runtime/
+├── deploy-control
+│   ├── Dockerfile
+│   └── server.py
+├── router-proxy
+│   ├── runtime/
+│   ├── nginx.conf
+│   └── render-routes.py
+├── authz-service
+│   ├── src/
+│   └── runtime/
+└── auth-portal
+    ├── src/
+    └── runtime/
+```
+
+## app-instance 当前可用能力
+
+`/home/ivan/xuan/nano_project/app-instance` 现在已经具备：
+
+- 统一镜像构建：`Dockerfile`
+- 容器内启动前端、后端、Nginx：`entrypoint.sh`
+- 创建实例并写配置、起容器、登记注册表：`create-instance.sh`
+- 查看实例：`list-instances.sh`
+- 删除实例并可选清理数据：`remove-instance.sh`
+- 实例注册表与端口分配：`instance-registry.py`
+
+更具体的使用说明见：
+
+- `/home/ivan/xuan/nano_project/app-instance/README.md`
+- `/home/ivan/xuan/nano_project/deploy-control/README.md`
+- `/home/ivan/xuan/nano_project/router-proxy/README.md`
+
+## 后续建议
+
+下一步可以在这三个目录下分别补：
+
+- `.env` 模板
+- portal 到部署机的创建实例调用
+- authz-service / auth-portal 的 Dockerfile 和启动脚本
+- portal 登录后的统一账号查找和跳转联调
+- authz-service 的部署脚本和配置注入