Files
aiops/docs/project-structure.md
T
attacker 97c4207ff8 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 依赖
2026-06-13 23:34:23 +08:00

5.9 KiB

项目结构

整体结构

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