# 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 的部署脚本和配置注入