Files
beaver_project/README.md
steven_li 7e9d1dcacb docs(authz-service): 更新 README 文档完善服务描述和文件结构
- 更新 authz-service 描述,明确已包含 Dockerfile、启动脚本和空白种子数据
- 在目录结构图中添加 Dockerfile 文件路径
- 在文档末尾添加 authz-service 的 README 路径到文档列表
- 从后续建议列表中移除已完成的 Dockerfile 和启动脚本相关条目
- 将 authz-service 的部署脚本更新为控制面接入和部署编排
2026-03-13 16:49:06 +08:00

109 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# nano_project
按当前部署模型整理后的顶层目录:
- `app-instance/`
- 单用户实例容器。
- 一个容器里同时包含前端和后端。
- `backend/` 来自 `nanobot-backend`
- `frontend/` 来自 `nanobot-fronted`
- 已包含统一 Dockerfile、启动脚本和实例管理脚本。
- `authz-service/`
- 鉴权服务容器。
- `src/` 来自 `Authz-service`
- 已包含 Dockerfile、启动脚本和空白种子数据。
- `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/
│ └── Dockerfile
└── 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`
- `/home/ivan/xuan/nano_project/authz-service/README.md`
## 后续建议
下一步可以在这三个目录下分别补:
- `.env` 模板
- portal 到部署机的创建实例调用
- portal 登录后的统一账号查找和跳转联调
- authz-service 的控制面接入和部署编排