refactor: 标准化项目结构 frontend/ + backend/ + SQLite + run.sh

- 目录重构: app/ -> frontend/，与 backend/ 并列
- 数据库: 默认 SQLite（零配置），修复 DSN() bug
- run.sh: 一键启动前后端，支持 start/stop/restart/status
- Makefile: install/dev/build/lint/clean 快捷命令
- vite.config.ts: 配置 dev server 端口 5173 + API 代理到 8080
- config.yaml: SQLite 默认配置，开箱即用
- docs/: 完整开发文档（项目结构/API/数据库/规范/部署）
- 修复: GORM foreign key 关联声明
- 修复: go get gorm.io/driver/sqlite 依赖

docs/PROJECT_SUMMARY.md

@@ -8,7 +8,7 @@ EZOps 是一个专业的 AIOps 智能运维平台，包含完整的前后端代
 
 ```
 /mnt/okcomputer/output/
-├── app/                          # 前端项目 (React + TypeScript + Vite)
+├── frontend/                      # 前端项目 (React + TypeScript + Vite)
 │   ├── src/
 │   │   ├── components/          # 组件目录
 │   │   │   ├── layout/          # 布局组件

docs/README.md

@@ -0,0 +1,23 @@
+# EZOps AIOps 开发文档
+
+本目录包含 EZOps AIOps 智能运维平台的全部开发文档。
+
+## 文档索引
+
+| 文档 | 说明 |
+|------|------|
+| [项目结构](./project-structure.md) | 前后端目录结构说明 |
+| [快速开始](./quick-start.md) | 环境准备、安装、启动 |
+| [API 接口](./api-reference.md) | 后端 API 接口文档 |
+| [数据库设计](./database-schema.md) | 数据模型和表结构 |
+| [开发规范](./development-guide.md) | 代码规范、Git 工作流 |
+| [部署指南](./deployment.md) | 生产环境部署 |
+
+## 设计文档
+
+| 文档 | 说明 |
+|------|------|
+| [ROADMAP](./ROADMAP.md) | 项目路线图 |
+| [PDD 计划](./PDD_PLAN.md) | 产品驱动开发计划 |
+| [项目摘要](./PROJECT_SUMMARY.md) | 项目整体概述 |
+| [后端摘要](./BACKEND_SUMMARY.md) | 后端架构概述 |

docs/api-reference.md

@@ -0,0 +1,261 @@
+# API 接口文档
+
+## 基础信息
+
+| 项目 | 值 |
+|------|---|
+| Base URL | `http://localhost:8080/api/v1` |
+| 认证方式 | JWT Bearer Token |
+| 请求格式 | JSON |
+| 响应格式 | JSON |
+
+## 通用响应结构
+
+```json
+{
+  "code": 200,
+  "message": "success",
+  "data": {}
+}
+```
+
+分页响应：
+
+```json
+{
+  "code": 200,
+  "message": "success",
+  "data": {
+    "list": [],
+    "total": 100
+  }
+}
+```
+
+## 认证
+
+### POST /auth/login
+
+用户登录，获取 JWT Token。
+
+**请求体：**
+```json
+{
+  "username": "admin",
+  "password": "admin123"
+}
+```
+
+**响应：**
+```json
+{
+  "code": 200,
+  "message": "登录成功",
+  "data": {
+    "token": "eyJhbGciOiJIUzI1NiIs...",
+    "expires_in": 86400,
+    "user": {
+      "id": 1,
+      "username": "admin",
+      "real_name": "管理员"
+    }
+  }
+}
+```
+
+### POST /auth/register
+
+用户注册。
+
+### GET /user/profile
+
+获取当前登录用户信息。（需认证）
+
+### PUT /user/profile
+
+更新当前用户信息。（需认证）
+
+### PUT /user/password
+
+修改密码。（需认证）
+
+## 用户管理（管理员）
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/admin/users` | 用户列表 |
+| GET | `/admin/users/:id` | 用户详情 |
+| POST | `/admin/users` | 创建用户 |
+| PUT | `/admin/users/:id` | 更新用户 |
+| DELETE | `/admin/users/:id` | 删除用户 |
+
+## 仪表盘
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/dashboard/stats` | 统计数据 |
+| GET | `/dashboard/recent-alerts` | 最近告警 |
+| GET | `/dashboard/recent-releases` | 最近发布 |
+| GET | `/dashboard/metrics` | 性能指标 |
+
+## 服务器管理
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/servers` | 服务器列表 |
+| GET | `/servers/stats` | 服务器统计 |
+| GET | `/servers/:id` | 服务器详情 |
+| POST | `/servers` | 添加服务器 |
+| PUT | `/servers/:id` | 更新服务器 |
+| DELETE | `/servers/:id` | 删除服务器 |
+| POST | `/servers/batch-delete` | 批量删除 |
+
+## 云平台管理
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/cloud-accounts` | 云账号列表 |
+| POST | `/cloud-accounts` | 添加云账号 |
+| DELETE | `/cloud-accounts/:id` | 删除云账号 |
+| GET | `/domains` | 域名列表 |
+| POST | `/domains` | 添加域名 |
+| DELETE | `/domains/:id` | 删除域名 |
+
+## K8s 集群
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/k8s-clusters` | 集群列表 |
+| GET | `/k8s-clusters/:id` | 集群详情 |
+| POST | `/k8s-clusters` | 添加集群 |
+| PUT | `/k8s-clusters/:id` | 更新集群 |
+| DELETE | `/k8s-clusters/:id` | 删除集群 |
+| GET | `/k8s-clusters/:id/nodes` | 节点列表 |
+| GET | `/k8s-clusters/:id/pods` | Pod 列表 |
+| GET | `/k8s-clusters/:id/deployments` | Deployment 列表 |
+| GET | `/k8s-clusters/:id/services` | Service 列表 |
+| GET | `/k8s-clusters/:id/ingresses` | Ingress 列表 |
+
+## 监控告警
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/alerts` | 告警事件列表 |
+| GET | `/alerts/rules` | 告警规则列表 |
+| POST | `/alerts/rules` | 创建告警规则 |
+| PUT | `/alerts/rules/:id` | 更新规则 |
+| DELETE | `/alerts/rules/:id` | 删除规则 |
+| POST | `/alerts/rules/:id/toggle` | 启用/禁用规则 |
+| POST | `/alerts/:id/ack` | 确认告警 |
+
+## CI/CD 流水线
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/pipelines` | 流水线列表 |
+| POST | `/pipelines` | 创建流水线 |
+| GET | `/pipelines/:id` | 流水线详情 |
+| PUT | `/pipelines/:id` | 更新流水线 |
+| DELETE | `/pipelines/:id` | 删除流水线 |
+| POST | `/pipelines/:id/trigger` | 触发流水线 |
+| GET | `/pipelines/:id/runs` | 执行记录 |
+
+## 应用发布
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/releases` | 发布列表 |
+| POST | `/releases` | 创建发布 |
+| POST | `/releases/:id/approve` | 审批发布 |
+| POST | `/releases/:id/deploy` | 部署发布 |
+| POST | `/releases/:id/rollback` | 回滚发布 |
+
+## 自动化运维
+
+### 定时任务
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/cron-jobs` | 任务列表 |
+| POST | `/cron-jobs` | 创建任务 |
+| GET | `/cron-jobs/:id` | 任务详情 |
+| PUT | `/cron-jobs/:id` | 更新任务 |
+| DELETE | `/cron-jobs/:id` | 删除任务 |
+| POST | `/cron-jobs/:id/toggle` | 启用/禁用 |
+| POST | `/cron-jobs/:id/execute` | 手动执行 |
+
+### 脚本管理
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/scripts` | 脚本列表 |
+| POST | `/scripts` | 创建脚本 |
+| GET | `/scripts/:id` | 脚本详情 |
+| PUT | `/scripts/:id` | 更新脚本 |
+| DELETE | `/scripts/:id` | 删除脚本 |
+| POST | `/scripts/:id/execute` | 执行脚本 |
+
+## 审批流程
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/approvals/templates` | 审批模板列表 |
+| POST | `/approvals/templates` | 创建模板 |
+| GET | `/approvals/templates/:id` | 模板详情 |
+| PUT | `/approvals/templates/:id` | 更新模板 |
+| DELETE | `/approvals/templates/:id` | 删除模板 |
+| GET | `/approvals/processes` | 审批流程列表 |
+| POST | `/approvals/processes` | 发起审批 |
+| GET | `/approvals/processes/:id` | 流程详情 |
+| POST | `/approvals/processes/:id/approve` | 审批通过 |
+| POST | `/approvals/processes/:id/reject` | 审批驳回 |
+
+## 导航管理
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/navigations/groups` | 导航分组列表 |
+| POST | `/navigations/groups` | 创建分组 |
+| PUT | `/navigations/groups/:id` | 更新分组 |
+| DELETE | `/navigations/groups/:id` | 删除分组 |
+| GET | `/navigations/links` | 导航链接列表 |
+| POST | `/navigations/links` | 创建链接 |
+| PUT | `/navigations/links/:id` | 更新链接 |
+| DELETE | `/navigations/links/:id` | 删除链接 |
+| POST | `/navigations/links/:id/favorite` | 收藏/取消收藏 |
+
+## 审计日志
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/audit/logs` | 审计日志列表 |
+| GET | `/audit/logs/:id` | 日志详情 |
+| GET | `/audit/modules` | 审计模块列表 |
+| GET | `/audit/actions` | 审计操作列表 |
+| GET | `/audit/logs/export` | 导出日志 |
+| GET | `/audit/statistics` | 审计统计 |
+| POST | `/audit/logs/clear` | 清空日志 |
+
+## 健康检查
+
+### GET /health
+
+无需认证。
+
+```json
+{
+  "status": "ok"
+}
+```
+
+### GET /version
+
+无需认证。
+
+```json
+{
+  "version": "dev",
+  "build_time": "unknown",
+  "git_commit": "unknown"
+}
+```

docs/database-schema.md

@@ -0,0 +1,210 @@
+# 数据库设计
+
+## 概述
+
+EZOps AIOps 使用 GORM 作为 ORM 框架，支持 SQLite / MySQL / PostgreSQL。
+
+- **默认**: SQLite（零配置，数据文件 `backend/data/aiops.db`）
+- **生产**: 推荐使用 MySQL 或 PostgreSQL
+
+首次启动时，`AutoMigrate` 会自动创建所有表。
+
+## 数据模型
+
+### 用户体系
+
+#### users - 用户表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | uint | 主键 |
+| username | string | 用户名（唯一） |
+| password | string | 密码（bcrypt 加密） |
+| email | string | 邮箱 |
+| phone | string | 手机号 |
+| real_name | string | 真实姓名 |
+| avatar | string | 头像 URL |
+| status | int | 状态（1=正常 0=禁用） |
+| last_login | time | 最后登录时间 |
+| created_at | time | 创建时间 |
+| updated_at | time | 更新时间 |
+
+#### roles - 角色表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | uint | 主键 |
+| name | string | 角色名称 |
+| code | string | 角色代码 |
+| description | string | 角色描述 |
+| sort | int | 排序 |
+
+#### permissions - 权限表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | uint | 主键 |
+| name | string | 权限名称 |
+| code | string | 权限代码 |
+| type | string | 权限类型（menu/btn/api） |
+| path | string | 路由路径 |
+| method | string | HTTP 方法 |
+
+### 服务器管理
+
+#### servers - 服务器表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | uint | 主键 |
+| name | string | 服务器名称 |
+| hostname | string | 主机名 |
+| ip | string | IP 地址 |
+| port | int | SSH 端口 |
+| os | string | 操作系统 |
+| cpu | int | CPU 核数 |
+| memory | int64 | 内存（MB） |
+| disk | int64 | 磁盘（GB） |
+| status | string | 状态（online/offline/maintenance） |
+| tags | string | 标签（JSON） |
+| cloud_id | uint | 关联云账号 |
+| region | string | 地域 |
+
+#### clouds - 云平台表
+#### cloud_accounts - 云账号表
+#### regions - 地域表
+#### domains - 域名表
+
+### K8s 管理
+
+#### k8s_clusters - K8s 集群表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | uint | 主键 |
+| name | string | 集群名称 |
+| version | string | K8s 版本 |
+| api_server | string | API Server 地址 |
+| kubeconfig | string | Kubeconfig 内容 |
+| status | string | 集群状态 |
+
+#### k8s_nodes, k8s_pods, k8s_deployments, k8s_services, k8s_ingresses
+
+### 监控告警
+
+#### alert_rules - 告警规则表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | uint | 主键 |
+| name | string | 规则名称 |
+| description | string | 规则描述 |
+| type | string | 告警类型 |
+| source | string | 数据源 |
+| expression | string | PromQL 表达式 |
+| severity | string | 严重级别（critical/warning/info） |
+| duration | string | 持续时间 |
+| notify_channels | string | 通知渠道（JSON） |
+| enabled | bool | 是否启用 |
+
+#### alert_events - 告警事件表
+#### notify_channels - 通知渠道表
+#### metric_data - 指标数据表
+
+### CI/CD
+
+#### pipelines - 流水线表
+#### pipeline_runs - 流水线执行记录表
+#### app_releases - 应用发布表
+
+### 自动化运维
+
+#### cron_jobs - 定时任务表
+#### scripts - 脚本表
+#### task_executions - 任务执行记录表
+#### playbooks - Ansible Playbook 表
+
+### 审批流程
+
+#### approval_templates - 审批模板表
+#### approval_processes - 审批流程表
+#### approval_steps - 审批步骤表
+
+### 其他
+
+#### navigation_groups - 导航分组表
+#### navigation_links - 导航链接表
+#### audit_logs - 审计日志表
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | uint | 主键 |
+| user_id | *uint | 操作用户 ID |
+| module | string | 模块 |
+| action | string | 操作类型 |
+| resource | string | 资源标识 |
+| request | string | 请求内容 |
+| response | string | 响应内容 |
+| error | string | 错误信息 |
+| ip | string | 操作 IP |
+| created_at | time | 操作时间 |
+
+## 表关系
+
+```
+users ──< user_roles >── roles ──< role_permissions >── permissions
+
+servers ──> cloud_accounts ──> clouds
+servers ──> regions
+
+alert_rules ──< alert_events
+alert_rules ──> notify_channels
+
+pipelines ──< pipeline_runs
+app_releases ──> pipelines
+
+approval_templates ──< approval_processes ──< approval_steps
+
+navigation_groups ──< navigation_links
+```
+
+## AutoMigrate
+
+表结构在 `backend/pkg/database/database.go` 中定义，服务启动时自动执行：
+
+```go
+func AutoMigrate(db *gorm.DB) error {
+    return db.AutoMigrate(
+        &models.User{}, &models.Role{}, &models.Permission{},
+        &models.Server{}, &models.Cloud{}, ...
+    )
+}
+```
+
+## 切换数据库
+
+### MySQL
+
+编辑 `backend/config.yaml`：
+```yaml
+database:
+  driver: mysql
+  host: localhost
+  port: 3306
+  user: root
+  password: your_password
+  dbname: aiops
+  charset: utf8mb4
+```
+
+### PostgreSQL
+
+```yaml
+database:
+  driver: postgres
+  host: localhost
+  port: 5432
+  user: postgres
+  password: your_password
+  dbname: aiops
+```

docs/deployment.md

@@ -0,0 +1,139 @@
+# 部署指南
+
+## 开发环境
+
+参见 [快速开始](./quick-start.md)。
+
+```bash
+./run.sh start
+```
+
+## 生产构建
+
+### 后端编译
+
+```bash
+cd backend
+CGO_ENABLED=1 go build -ldflags="-s -w" -o aiops-server cmd/main.go
+```
+
+### 前端构建
+
+```bash
+cd app
+npm run build  # 输出到 dist/
+```
+
+### 使用 Makefile
+
+```bash
+make build  # 同时构建前后端
+```
+
+## Docker 部署
+
+### Dockerfile
+
+后端已有 `backend/Dockerfile`，可基于此构建镜像。
+
+```bash
+cd backend
+docker build -t aiops-server .
+```
+
+### docker-compose
+
+```bash
+cd backend
+docker-compose up -d
+```
+
+## Nginx 反向代理
+
+前端构建后部署到 Nginx，后端 API 反向代理：
+
+```nginx
+server {
+    listen 80;
+    server_name aiops.example.com;
+
+    # 前端静态文件
+    location / {
+        root /usr/share/nginx/html;
+        try_files $uri $uri/ /index.html;
+    }
+
+    # 后端 API 代理
+    location /api/ {
+        proxy_pass http://127.0.0.1:8080;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+
+    # WebSocket 代理
+    location /ws/ {
+        proxy_pass http://127.0.0.1:8080;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+    }
+}
+```
+
+参考配置文件：`backend/nginx.conf`
+
+## 系统服务（systemd）
+
+创建 `/etc/systemd/system/aiops.service`：
+
+```ini
+[Unit]
+Description=EZOps AIOps Server
+After=network.target
+
+[Service]
+Type=simple
+User=www-data
+WorkingDirectory=/opt/aiops
+ExecStart=/opt/aiops/aiops-server
+Restart=always
+RestartSec=5
+Environment=GIN_MODE=release
+
+[Install]
+WantedBy=multi-user.target
+```
+
+```bash
+systemctl enable aiops
+systemctl start aiops
+```
+
+## 环境变量
+
+| 变量 | 默认值 | 说明 |
+|------|--------|------|
+| PORT | 8080 | 后端端口 |
+| GIN_MODE | debug | Gin 模式（release/debug） |
+| GOPROXY | - | Go 模块代理 |
+
+## 生产配置建议
+
+1. **数据库**: 生产环境使用 MySQL/PostgreSQL，不要用 SQLite
+2. **JWT Secret**: 更换为高强度随机字符串
+3. **CORS**: 生产环境配置允许的具体域名，不要用 `*`
+4. **HTTPS**: 配置 TLS 证书
+5. **日志**: 使用文件日志 + 日志轮转
+6. **备份**: 定期备份数据库
+
+## 健康检查
+
+```bash
+# 检查后端是否正常
+curl http://localhost:8080/health
+# {"status":"ok"}
+
+# 检查版本
+curl http://localhost:8080/version
+# {"version":"dev","build_time":"...","git_commit":"..."}
+```

docs/development-guide.md

@@ -0,0 +1,188 @@
+# 开发规范
+
+## Git 工作流
+
+### 分支策略
+
+| 分支 | 说明 |
+|------|------|
+| `main` / `master` | 生产分支，保护分支 |
+| `dev` | 开发集成分支 |
+| `feature/*` | 功能分支 |
+| `fix/*` | 修复分支 |
+| `hotfix/*` | 紧急修复 |
+
+### 提交规范
+
+```
+<type>: <description>
+
+- 变更点 1
+- 变更点 2
+```
+
+Type 列表：
+- `feat`: 新功能
+- `fix`: Bug 修复
+- `refactor`: 重构
+- `docs`: 文档
+- `style`: 样式
+- `test`: 测试
+- `chore`: 构建/工具
+
+示例：
+```
+feat: 添加服务器批量导入功能
+
+- 支持 Excel 导入
+- 支持云平台同步
+```
+
+## 后端规范（Go）
+
+### 目录职责
+
+| 目录 | 职责 |
+|------|------|
+| `cmd/` | 应用入口 |
+| `internal/handlers/` | HTTP 请求处理（参数校验、响应） |
+| `internal/models/` | 数据模型定义 |
+| `internal/config/` | 配置管理 |
+| `internal/middleware/` | 中间件 |
+| `internal/routes/` | 路由注册 |
+| `pkg/database/` | 数据库连接 |
+| `pkg/logger/` | 日志工具 |
+
+### 命名规范
+
+- 文件名：`snake_case.go`
+- 类型/方法：`PascalCase`
+- 变量：`camelCase`
+- 常量：`PascalCase` 或 `ALL_CAPS`
+
+### 统一响应格式
+
+```go
+// 成功响应
+c.JSON(http.StatusOK, models.Response{
+    Code:    200,
+    Message: "success",
+    Data:    result,
+})
+
+// 分页响应
+c.JSON(http.StatusOK, models.Response{
+    Code:    200,
+    Message: "success",
+    Data: models.ListResponse{
+        List:  items,
+        Total: total,
+    },
+})
+
+// 错误响应
+c.JSON(http.StatusBadRequest, models.Response{
+    Code:    400,
+    Message: "参数错误: " + err.Error(),
+})
+```
+
+### Handler 模板
+
+```go
+func (h *ServerHandler) CreateServer(c *gin.Context) {
+    // 1. 参数绑定
+    var req models.ServerRequest
+    if err := c.ShouldBindJSON(&req); err != nil {
+        c.JSON(http.StatusBadRequest, models.Response{Code: 400, Message: err.Error()})
+        return
+    }
+
+    // 2. 业务逻辑
+    server := models.Server{
+        Name: req.Name,
+        IP:   req.IP,
+    }
+    if err := h.db.Create(&server).Error; err != nil {
+        c.JSON(http.StatusInternalServerError, models.Response{Code: 500, Message: "创建失败"})
+        return
+    }
+
+    // 3. 返回结果
+    c.JSON(http.StatusOK, models.Response{Code: 200, Message: "创建成功", Data: server})
+}
+```
+
+### 注意事项
+
+- GORM `First()` 连续查询会带上次 ID，用 `Take()` 代替
+- Go 编译前设置 `GOPROXY=https://goproxy.cn,direct`
+- SQLite 需要 `CGO_ENABLED=1`
+- JWT 使用 `golang-jwt/jwt/v5`，`jwt.TimeFunc()` 已移除，用 `time.Now()`
+
+## 前端规范（React + TypeScript）
+
+### 目录职责
+
+| 目录 | 职责 |
+|------|------|
+| `src/components/*/` | 业务组件 |
+| `src/components/ui/` | shadcn/ui 基础组件 |
+| `src/hooks/` | 自定义 Hooks |
+| `src/lib/` | 工具函数 |
+| `src/services/` | API 封装 |
+| `src/store/` | Zustand 状态管理 |
+| `src/types/` | TypeScript 类型 |
+| `src/mocks/` | Mock 数据 |
+
+### 命名规范
+
+- 组件文件：`PascalCase.tsx`（如 `ServerManager.tsx`）
+- 工具文件：`camelCase.ts`（如 `formatDate.ts`）
+- 组件名：`PascalCase`
+
+### UI 设计原则
+
+- 能去掉的装饰都去掉（无边框、无多余分隔线）
+- 选中态用 `bg-surface-active`，不用彩色高亮
+- 页面打开即用，不需要额外的"新建"按钮跳转
+- 操作成功不弹 toast，仅在失败时提示
+
+### API 调用
+
+前端通过 Vite 代理访问后端 API：
+
+```typescript
+// 开发环境请求会被代理到 http://localhost:8080
+fetch('/api/v1/servers')
+```
+
+## 测试
+
+### 后端测试
+
+```bash
+cd backend
+go test -v ./...
+```
+
+### 前端构建测试
+
+```bash
+cd app
+npm run build  # TypeScript 编译 + Vite 构建
+```
+
+## 日志
+
+| 级别 | 使用场景 |
+|------|---------|
+| Info | 服务启动、正常操作 |
+| Warn | 配置缺失、降级处理 |
+| Error | 操作失败、异常 |
+| Fatal | 启动失败、不可恢复 |
+
+```go
+log.Info("server started", zap.String("port", cfg.Port))
+log.Error("database error", zap.Error(err))
+```

docs/project-structure.md

@@ -0,0 +1,136 @@
+# 项目结构
+
+## 整体结构
+
+```
+aiops/
+├── frontend/                    # 前端 (React 18 + TypeScript + Vite)
+│   ├── src/
+│   │   ├── components/          # 业务组件
+│   │   │   ├── aiops/           # AI 智能运维组件
+│   │   │   ├── approval/        # 审批流程
+│   │   │   ├── audit/           # SQL 审计
+│   │   │   ├── automation/      # 自动化运维
+│   │   │   ├── cloud/           # 云平台管理
+│   │   │   ├── dashboard/       # 仪表盘
+│   │   │   ├── deploy/          # CI/CD 部署
+│   │   │   ├── k8s/             # K8s 集群管理
+│   │   │   ├── layout/          # 布局组件
+│   │   │   ├── monitor/         # 监控告警
+│   │   │   ├── navigation/      # 导航管理
+│   │   │   ├── server/          # 服务器管理
+│   │   │   ├── system/          # 系统管理
+│   │   │   └── ui/              # shadcn/ui 基础组件
+│   │   ├── hooks/               # 自定义 Hooks
+│   │   ├── lib/                 # 工具库
+│   │   ├── mocks/               # Mock 数据
+│   │   ├── services/            # API 封装
+│   │   ├── store/               # Zustand 状态管理
+│   │   ├── types/               # TypeScript 类型定义
+│   │   ├── App.css              # 全局样式
+│   │   ├── App.tsx              # 根组件
+│   │   ├── index.css            # 基础样式
+│   │   └── main.tsx             # 应用入口
+│   ├── package.json
+│   ├── vite.config.ts           # Vite 配置（含 API 代理）
+│   ├── tailwind.config.js       # Tailwind CSS 配置
+│   └── tsconfig.json
+│
+├── backend/                     # 后端 (Go + Gin + GORM)
+│   ├── cmd/
+│   │   └── main.go              # 应用入口
+│   ├── internal/
+│   │   ├── api/
+│   │   │   ├── handlers/        # HTTP 处理器
+│   │   │   │   ├── alert.go     # 告警管理
+│   │   │   │   ├── approval.go  # 审批流程
+│   │   │   │   ├── audit.go     # 审计日志
+│   │   │   │   ├── automation.go # 自动化运维
+│   │   │   │   ├── dashboard.go # 仪表盘
+│   │   │   │   ├── k8s.go       # K8s 管理
+│   │   │   │   ├── navigation.go # 导航管理
+│   │   │   │   ├── pipeline.go  # CI/CD 流水线
+│   │   │   │   ├── server.go    # 服务器管理
+│   │   │   │   └── user.go      # 用户认证
+│   │   │   ├── middleware/      # 中间件
+│   │   │   │   └── auth.go      # JWT 认证 + RBAC
+│   │   │   └── routes/
+│   │   │       └── routes.go    # 路由注册
+│   │   ├── config/
+│   │   │   └── config.go        # 配置加载 (Viper)
+│   │   └── models/              # 数据模型
+│   │       ├── alert.go         # 告警模型
+│   │       ├── approval.go      # 审批模型
+│   │       ├── audit.go         # 审计日志模型
+│   │       ├── automation.go    # 自动化运维模型
+│   │       ├── cicd.go          # CI/CD 模型
+│   │       ├── common.go        # 通用模型 (Response/List/Page)
+│   │       ├── k8s.go           # K8s 模型
+│   │       ├── navigation.go    # 导航模型
+│   │       ├── server.go        # 服务器模型
+│   │       └── user.go          # 用户模型
+│   ├── pkg/
+│   │   ├── database/
+│   │   │   └── database.go      # 数据库连接 + AutoMigrate
+│   │   └── logger/
+│   │       └── logger.go        # Zap 日志
+│   ├── scripts/
+│   │   ├── init.sql             # 初始化 SQL
+│   │   └── mock.go              # Mock 数据生成
+│   ├── config.yaml              # 配置文件（SQLite 默认）
+│   ├── go.mod                   # Go 模块定义
+│   └── Dockerfile               # Docker 构建
+│
+├── docs/                        # 开发文档
+│   ├── README.md                # 文档索引
+│   ├── project-structure.md     # 本文件
+│   ├── quick-start.md           # 快速开始
+│   ├── api-reference.md         # API 接口
+│   ├── database-schema.md       # 数据库设计
+│   ├── development-guide.md     # 开发规范
+│   ├── deployment.md            # 部署指南
+│   ├── ROADMAP.md               # 项目路线图
+│   ├── PDD_PLAN.md              # 产品开发计划
+│   ├── PROJECT_SUMMARY.md       # 项目概述
+│   └── BACKEND_SUMMARY.md       # 后端摘要
+│
+├── run.sh                       # 一键启动脚本
+├── Makefile                     # 快捷命令
+├── .env.example                 # 环境变量模板
+├── .gitignore
+└── README.md
+```
+
+## 技术栈
+
+### 前端
+
+| 技术 | 版本 | 用途 |
+|------|------|------|
+| React | 18+ | 前端框架 |
+| TypeScript | 5+ | 类型安全 |
+| Vite | 7+ | 构建工具 |
+| Tailwind CSS | 3+ | 样式框架 |
+| shadcn/ui | - | UI 组件库 |
+| Zustand | - | 状态管理 |
+| TanStack Query | - | 数据请求 |
+
+### 后端
+
+| 技术 | 版本 | 用途 |
+|------|------|------|
+| Go | 1.21+ | 编程语言 |
+| Gin | v1.10+ | Web 框架 |
+| GORM | v1.25+ | ORM 框架 |
+| JWT | v5 (golang-jwt) | 认证 |
+| Viper | - | 配置管理 |
+| Zap | - | 结构化日志 |
+| SQLite/MySQL/PostgreSQL | - | 数据库 |
+
+## 端口分配
+
+| 服务 | 端口 | 说明 |
+|------|------|------|
+| 前端 (Vite dev) | 5173 | http://localhost:5173 |
+| 后端 (Gin) | 8080 | http://localhost:8080 |
+| 健康检查 | 8080 | http://localhost:8080/health |

docs/quick-start.md

@@ -0,0 +1,163 @@
+# 快速开始
+
+## 环境要求
+
+| 工具 | 最低版本 | 说明 |
+|------|---------|------|
+| Go | 1.21+ | 后端编译运行（需 CGO 支持 SQLite） |
+| Node.js | 18+ | 前端构建 |
+| npm | 9+ | 包管理 |
+| gcc/clang | - | CGO 编译 SQLite 需要 |
+
+### 检查环境
+
+```bash
+go version        # >= 1.21
+node -v           # >= 18
+gcc --version     # macOS 自带 clang
+```
+
+## 安装
+
+### 1. 克隆仓库
+
+```bash
+git clone https://gitee.com/attacker/aiops.git
+cd aiops
+```
+
+### 2. 安装依赖
+
+```bash
+make install
+# 或手动安装
+cd backend && go mod download && cd ..
+cd frontend cd app &&cd app && npm install && cd ..
+```
+
+### 3. 配置（可选）
+
+默认使用 SQLite，无需任何额外配置即可启动。
+
+如需使用 MySQL 等其他数据库，编辑 `backend/config.yaml`：
+
+```yaml
+database:
+  driver: mysql          # 改为 mysql / postgres
+  host: localhost
+  port: 3306
+  user: root
+  password: your_password
+  dbname: aiops
+```
+
+## 启动
+
+### 方式一：一键启动（推荐）
+
+```bash
+chmod +x run.sh
+./run.sh start
+```
+
+输出示例：
+```
+[INFO] ========== EZOps AIOps 启动脚本 ==========
+[INFO] 正在启动后端服务...
+[INFO] 编译 Go 程序...
+[SUCCESS] 后端服务已启动 (PID: 12345, 端口: 8080)
+[INFO] 正在启动前端服务...
+[SUCCESS] 前端服务已启动 (PID: 12346, 端口: 5173)
+[SUCCESS] ========== 所有服务已启动 ==========
+[INFO] 前端地址: http://localhost:5173
+[INFO] 后端地址: http://localhost:8080
+[INFO] 健康检查: http://localhost:8080/health
+```
+
+### 方式二：分别启动
+
+```bash
+# 仅后端
+./run.sh backend
+
+# 仅前端
+./run.sh frontend
+```
+
+### 方式三：使用 Makefile
+
+```bash
+make dev      # 启动
+make status   # 查看状态
+make stop     # 停止
+```
+
+## 访问
+
+| 地址 | 说明 |
+|------|------|
+| http://localhost:5173 | 前端界面 |
+| http://localhost:8080/health | 后端健康检查 |
+| http://localhost:8080/version | 版本信息 |
+| http://localhost:8080/api/v1/auth/login | 登录接口 |
+
+## 常用命令
+
+```bash
+./run.sh status    # 查看服务状态
+./run.sh stop      # 停止所有服务
+./run.sh restart   # 重启所有服务
+./run.sh help      # 查看帮助
+
+make logs          # 查看实时日志
+make build         # 构建生产包
+make clean         # 清理构建产物
+```
+
+## 日志位置
+
+| 服务 | 日志文件 |
+|------|---------|
+| 后端 | `backend/logs/server.log` |
+| 前端 | `frontend/logs/dev.log` |
+| 数据库 | `backend/data/aiops.db`（SQLite 文件） |
+
+## 数据库
+
+默认使用 SQLite，数据库文件位于 `backend/data/aiops.db`，首次启动时自动创建表结构（AutoMigrate）。
+
+### 重置数据库
+
+```bash
+./run.sh stop
+rm -f backend/data/aiops.db
+./run.sh start
+```
+
+## 常见问题
+
+### Q: CGO 编译失败？
+
+SQLite 需要 CGO 支持。确保环境变量 `CGO_ENABLED=1`：
+
+```bash
+export CGO_ENABLED=1
+```
+
+### Q: Go 模块下载慢？
+
+设置国内代理：
+
+```bash
+export GOPROXY=https://goproxy.cn,direct
+```
+
+### Q: 端口被占用？
+
+```bash
+./run.sh stop          # 先停止
+./run.sh start         # 再启动
+# 或强制释放端口
+lsof -ti:8080 | xargs kill -9
+lsof -ti:5173 | xargs kill -9
+```