gouki
46dbbd9fbf
- 项目概述与技术栈速览 - 目录结构导航（app/static/scripts/agent/deploy/tests） - 关键约束（移动端优先、凭据中心化、适配器注册、部署链路） - 常用命令入口（测试、部署、本地运行） - 专项规则索引（.qoder/rules/）
51 lines
1.9 KiB
Markdown
51 lines
1.9 KiB
Markdown
# vps-manager
|
||
|
||
VPS 数字资产统一管理面板：多云 VPS / 域名 / AI 账号 / 凭据的登记、监控、续费提醒与同步。
|
||
|
||
## 技术栈
|
||
|
||
FastAPI + SQLModel + SQLite 分库（assets.db / metrics.db）+ Vue 3 + Tailwind CSS + Fernet 加密。
|
||
|
||
## 目录导航
|
||
|
||
| 目录 | 职责 |
|
||
|------|------|
|
||
| `app/` | FastAPI 后端：routers（API 路由）、services（业务逻辑）、models（SQLModel 模型）、adapters（云厂商 SDK 适配层）、core（配置/加密/鉴权） |
|
||
| `static/` | Vue 3 SPA 前端：js/（视图/状态/模态框）、css/、templates/ |
|
||
| `scripts/` | 运维脚本：AI 余额同步、SSL 证书巡检、续费提醒 |
|
||
| `agent/` | VPS 采集 Agent：资源监控、安全状态、上报中心 |
|
||
| `deploy/` | 部署编排：systemd 单元、update.sh 自动更新、backup.sh 备份 |
|
||
| `tests/` | pytest 测试套件（22 个文件） |
|
||
| `static/js/__tests__/` | vitest 前端测试（4 个文件） |
|
||
|
||
## 关键约束
|
||
|
||
- **移动端优先**：底部 Tab 导航，无横向溢出；桌面端侧边栏
|
||
- **凭据中心化**：`credentials` 表是唯一事实源，账号通过 `credential_id` 关联
|
||
- **适配器注册**：`app/adapters/registry.py` 的 `@register` 是唯一事实源；新增 AI 适配器须同步 `app/core/seed.py`
|
||
- **部署链路**：Gitea push → cc1 `update.sh` 自动拉取 → 健康闸门 → 失败回滚
|
||
- **Service Worker**：HTML `network-first`，静态资源 `stale-while-revalidate` + `?v={mtime}`
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
# 本地运行
|
||
./run.sh
|
||
|
||
# Python 测试
|
||
.venv/bin/python -m pytest tests/ -x -q
|
||
|
||
# JS 测试
|
||
npx vitest run
|
||
|
||
# 部署
|
||
./deploy/deploy.sh
|
||
```
|
||
|
||
## 专项规则
|
||
|
||
- 编码规范与架构细节 → `.qoder/rules/coding-standards.md`
|
||
- 部署验收流程 → `.qoder/rules/deploy-verification.md`
|
||
- JS 测试闸门 → `.qoder/rules/js-test-gate.md`
|
||
- Python 测试规则 → `.qoder/rules/vps-manager-pytest.md`
|