{"id":37845922,"url":"https://github.com/heidsoft/itsm","last_synced_at":"2026-03-07T03:06:41.790Z","repository":{"id":304357503,"uuid":"1018400955","full_name":"heidsoft/itsm","owner":"heidsoft","description":"Enterprise IT Service Management Platform built with Go/Gin and Next.js","archived":false,"fork":false,"pushed_at":"2026-02-28T14:44:45.000Z","size":20846,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-28T17:47:28.008Z","etag":null,"topics":["agent","ai","bpmn","go","itil","itsm","nextjs","react","typescript"],"latest_commit_sha":null,"homepage":"https://github.com/heidsoft/itsm","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/heidsoft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-12T07:17:08.000Z","updated_at":"2026-02-28T14:44:48.000Z","dependencies_parsed_at":"2025-07-12T16:15:25.846Z","dependency_job_id":"d2b4d82b-8bdd-4ae3-8083-b4152693710e","html_url":"https://github.com/heidsoft/itsm","commit_stats":null,"previous_names":["heidsoft/itsm"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/heidsoft/itsm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heidsoft%2Fitsm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heidsoft%2Fitsm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heidsoft%2Fitsm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heidsoft%2Fitsm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heidsoft","download_url":"https://codeload.github.com/heidsoft/itsm/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heidsoft%2Fitsm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30206350,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T19:07:06.838Z","status":"online","status_checked_at":"2026-03-07T02:00:06.765Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai","bpmn","go","itil","itsm","nextjs","react","typescript"],"created_at":"2026-01-16T16:03:24.596Z","updated_at":"2026-03-07T03:06:41.779Z","avatar_url":"https://github.com/heidsoft.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ITSM 企业级IT服务管理平台\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Go-1.25+-00ADD8?style=flat\u0026logo=go\" alt=\"Go\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Next.js-15.5-000000?style=flat\u0026logo=nextdotjs\" alt=\"Next.js\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/TypeScript-5-3178C6?style=flat\u0026logo=typescript\" alt=\"TypeScript\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/PostgreSQL-17-336791?style=flat\u0026logo=postgresql\" alt=\"PostgreSQL\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Redis-7-DC382D?style=flat\u0026logo=redis\" alt=\"Redis\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-MIT-yellowgreen?style=flat\" alt=\"License\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e🚀 企业级 IT 服务管理平台 | 基于 ITIL 最佳实践 | AI 智能赋能\u003c/strong\u003e\n\u003c/p\u003e\n\n---\n\n## 📋 目录\n\n- [项目简介](#项目简介)\n- [快速开始](#快速开始)\n- [系统要求](#系统要求)\n- [技术架构](#技术架构)\n- [功能特性](#功能特性)\n- [文档导航](#文档导航)\n- [参与贡献](#参与贡献)\n- [许可证](#许可证)\n\n---\n\n## 🎯 项目简介\n\nITSM 是一个现代化的企业级 IT 服务管理(ITSM)平台，基于 **Go/Gin** 后端和 **Next.js/React** 前端构建。遵循 ITIL 最佳实践，集成 AI 智能功能，帮助企业高效管理 IT 服务。\n\n### 核心价值\n\n- **标准化**: 遵循 ITIL 最佳实践流程\n- **自动化**: BPMN 工作流引擎，自动化审批流程\n- **智能化**: AI 辅助工单分类、智能摘要、RAG 知识库\n- **可扩展**: 微服务架构，支持高并发、大规模部署\n\n---\n\n## 🚀 快速开始\n\n### 方式一：Docker Compose（推荐，5分钟启动）\n\n```bash\n# 1. 克隆项目\ngit clone https://github.com/heidsoft/itsm.git\ncd itsm\n\n# 2. 启动所有服务\nmake dev-up\n\n# 3. 访问应用\n# 前端: http://localhost:3000\n# 后端: http://localhost:8090\n# API 文档: http://localhost:8090/swagger\n```\n\n\u003e **首次登录**: 用户名 `admin`，密码 `admin123`\n\n### 方式二：本地开发\n\n```bash\n# 前置条件：Go 1.25+、Node.js 22+、PostgreSQL 14+、Redis 7+\n\n# 1. 克隆项目\ngit clone https://github.com/heidsoft/itsm.git\ncd itsm\n\n# 2. 启动数据库\ndocker compose up -d postgres redis\n\n# 3. 启动后端\ncd itsm-backend\ncp .env.example .env\ngo run main.go\n\n# 4. 启动前端（新终端）\ncd itsm-frontend\ncp .env.example .env.local\nnpm run dev\n```\n\n---\n\n## 📸 系统截图\n\n\u003e 💡 **提示**: 以下是系统界面预览，[在线 Demo](#) 即将上线 (关注更新)\n\n### 工单管理\n\n![工单列表](https://via.placeholder.com/1200x600/4A90E2/FFFFFF?text=工单列表页+-+工单管理+Dashboard)\n*工单列表页 - 支持筛选、排序、批量操作*\n\n![工单详情](https://via.placeholder.com/1200x600/4A90E2/FFFFFF?text=工单详情页+-+完整工单信息+评论+附件)\n*工单详情页 - 完整工单信息、评论、附件*\n\n### 仪表盘\n\n![仪表盘](https://via.placeholder.com/1200x600/4A90E2/FFFFFF?text=仪表盘+-+工单统计+SLA 合规率+趋势图)\n*仪表盘 - 工单统计、SLA 合规率、趋势图表*\n\n### 工作流引擎\n\n![BPMN 工作流](https://via.placeholder.com/1200x600/4A90E2/FFFFFF?text=BPMN+工作流设计器+-+可视化流程配置)\n*BPMN 工作流设计器 - 可视化流程配置*\n\n### SLA 监控\n\n![SLA 监控](https://via.placeholder.com/1200x600/4A90E2/FFFFFF?text=SLA+监控面板+-+实时追踪+违约预警)\n*SLA 监控面板 - 实时追踪、违约预警*\n\n### 知识库\n\n![知识库](https://via.placeholder.com/1200x600/4A90E2/FFFFFF?text=知识库+-+AI+智能问答+RAG+检索)\n*知识库 - AI 智能问答、RAG 检索*\n\n### 移动端\n\n![移动端](https://via.placeholder.com/1200x600/4A90E2/FFFFFF?text=移动端界面+-+响应式设计+PWA+支持)\n*移动端界面 - 响应式设计、PWA 支持*\n\n---\n\n## 💻 系统要求\n\n### 最低配置\n\n| 组件 | 最低版本 | 推荐版本 | 说明 |\n|------|---------|---------|------|\n| Go | 1.21 | 1.25+ | 后端运行时 |\n| Node.js | 18 | 22+ | 前端运行时 |\n| PostgreSQL | 14 | 17 | 主数据库 |\n| Redis | 6 | 7+ | 缓存/会话 |\n| Docker | 20 | 24+ | 容器化部署 |\n| Make | 3.8+ | - | 构建工具 |\n\n### 开发环境\n\n- **操作系统**: macOS / Linux (Ubuntu 22.04+) / Windows (WSL2)\n- **内存**: 8GB+ RAM\n- **磁盘**: 20GB+ 可用空间\n- **浏览器**: Chrome 100+ / Edge 100+ / Firefox 100+\n\n### 生产环境\n\n| 规模 | 用户数 | CPU | 内存 | 磁盘 |\n|------|--------|-----|------|------|\n| 小型 | \u003c100 | 2核 | 4GB | 50GB |\n| 中型 | 100-500 | 4核 | 8GB | 100GB |\n| 大型 | 500+ | 8核+ | 16GB+ | 200GB+ |\n\n---\n\n## 🏗 技术架构\n\n### 技术栈\n\n#### 后端技术\n\n| 技术 | 版本 | 用途 |\n|------|------|------|\n| Go | 1.25+ | 编程语言 |\n| Gin | v1.9+ | Web 框架 |\n| Ent | v0.13+ | ORM 框架 |\n| PostgreSQL | 14+ | 关系数据库 |\n| Redis | 7+ | 缓存/会话 |\n| BPMN Engine | - | 工作流引擎 |\n| Swagger | latest | API 文档 |\n\n#### 前端技术\n\n| 技术 | 版本 | 用途 |\n|------|------|------|\n| Next.js | 15.x | React 框架 |\n| React | 19.x | UI 库 |\n| TypeScript | 5.x | 类型系统 |\n| Ant Design | 6.x | UI 组件库 |\n| Tailwind CSS | 4.x | CSS 框架 |\n| TanStack Query | 5.x | 数据获取 |\n| Zustand | 5.x | 状态管理 |\n\n### 系统架构图\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│                         客户端层                                  │\n│   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐        │\n│   │   Web 浏览器  │    │   移动端     │    │   API 调用   │        │\n│   └─────────────┘    └─────────────┘    └─────────────┘        │\n└─────────────────────────────────────────────────────────────────┘\n                              │\n                              ▼\n┌─────────────────────────────────────────────────────────────────┐\n│                       接入层 (Nginx)                             │\n│              负载均衡 / SSL 终止 / 静态资源缓存                    │\n└─────────────────────────────────────────────────────────────────┘\n                              │\n              ┌───────────────┴───────────────┐\n              ▼                               ▼\n┌─────────────────────────┐       ┌─────────────────────────┐\n│      Next.js 前端        │       │      Go 后端 API        │\n│      端口: 3000          │       │      端口: 8090         │\n└─────────────────────────┘       └─────────────────────────┘\n              │                               │\n              │                               ├──────────────┐\n              │                               ▼              ▼\n              │                    ┌─────────────┐  ┌─────────┐\n              │                    │  PostgreSQL │  │  Redis  │\n              │                    │   端口:5432 │  │ 6379    │\n              │                    └─────────────┘  └─────────┘\n              │                               │\n              │                               ▼\n              │                    ┌─────────────────────┐\n              │                    │    AI 服务层        │\n              │                    │  (RAG/分类/摘要)     │\n              │                    └─────────────────────┘\n              ▼\n┌─────────────────────────────────────────────────────────────────┐\n│                      存储层                                       │\n│     ┌─────────────┐  ┌─────────────┐  ┌─────────────┐          │\n│     │   文件存储   │  │  向量存储   │  │  对象存储   │          │\n│     │  (MinIO/S3) │  │ (Chroma)   │  │             │          │\n│     └─────────────┘  └─────────────┘  └─────────────┘          │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## ✨ 功能特性\n\n### 核心模块\n\n| 模块 | 功能描述 |\n|------|----------|\n| 🎫 **工单管理** | 创建、分配、跟踪、关闭工单；SLA 管理；优先级处理 |\n| 🔥 **事件管理** | 事件发现、记录、分类、升级；实时监控告警 |\n| 🐛 **问题管理** | 根因分析、已知错误库、问题解决跟踪 |\n| 🔄 **变更管理** | 变更请求、风险评估、多级审批流程 |\n| 📋 **服务目录** | 服务请求模板、自助服务门户、服务水平协议 |\n| 📚 **知识库** | RAG 智能搜索、知识分类、FAQ 管理 |\n| 🔀 **工作流** | BPMN 可视化设计器、审批流程自动化 |\n| 👥 **用户管理** | 多租户、角色权限、LDAP 集成 |\n| 📊 **报表** | 自定义报表、BI 仪表盘、数据导出 |\n\n### AI 智能功能\n\n| 功能 | 说明 |\n|------|------|\n| 🤖 **智能分类** | 自动识别工单类型、优先级、影响范围 |\n| 📝 **自动摘要** | AI 生成工单/事件摘要 |\n| 🔍 **RAG 知识库** | 基于向量搜索的智能知识推荐 |\n| 💡 **智能建议** | 推荐解决方案、相似工单 |\n\n---\n\n## 📚 文档导航\n\n### 快速链接\n\n| 文档 | 说明 |\n|------|------|\n| [📖 开发指南](./docs/DEVELOPMENT.md) | 开发环境搭建、本地运行、联调配置 |\n| [🚀 部署指南](./docs/DEPLOYMENT.md) | 生产环境部署、Docker、K8s |\n| [⚙️ 配置参考](./docs/CONFIGURATION.md) | 环境变量详解、配置文件说明 |\n| [🗄️ 数据库](./docs/DATABASE.md) | 数据库配置、迁移、备份恢复 |\n| [🔧 运维手册](./docs/OPERATIONS.md) | 日志管理、监控告警、故障处理 |\n| [🔐 安全指南](./docs/SECURITY.md) | 安全加固、权限管理、审计日志 |\n| [📡 API 文档](./docs/API.md) | 接口文档、认证方式 |\n| [🏗️ 架构设计](./docs/ARCHITECTURE.md) | 系统架构、技术选型说明 |\n\n### 常用命令\n\n```bash\n# Docker 开发环境\nmake dev-up          # 启动\nmake dev-down        # 停止\nmake dev-logs        # 查看日志\nmake db-shell        # 进入数据库\n\n# 本地开发\ncd itsm-backend \u0026\u0026 go run main.go   # 后端\ncd itsm-frontend \u0026\u0026 npm run dev     # 前端\n\n# 构建\nmake build-backend    # 构建后端\nmake build-frontend   # 构建前端\n\n# 测试\nmake test            # 运行所有测试\nmake test-coverage   # 生成覆盖率报告\n\n# 代码质量\nmake lint            # 代码检查\nmake fmt             # 代码格式化\n```\n\n---\n\n## 🤝 参与贡献\n\n欢迎贡献代码！请阅读 [CONTRIBUTING.md](./CONTRIBUTING.md) 了解详情。\n\n### 开发流程\n\n```bash\n# 1. Fork 项目\n# 2. 克隆并创建分支\ngit clone https://github.com/heidsoft/itsm.git\ncd itsm\ngit checkout -b feature/your-feature\n\n# 3. 开发并提交\ngit commit -m \"feat: add new feature\"\n\n# 4. 推送并创建 PR\ngit push origin feature/your-feature\n```\n\n### 代码规范\n\n- **Go**: 遵循标准 Go 项目结构，使用 `gofumpt` 格式化\n- **TypeScript**: 严格模式，ESLint + Prettier\n- **提交信息**: 使用 [Conventional Commits](https://www.conventionalcommits.org/) 格式\n- **测试**: 新增功能需配套单元测试\n\n---\n\n## 📄 许可证\n\n[MIT](./LICENSE) - 请自由使用和修改。\n\n---\n\n## 📞 联系方式\n\n- **项目地址**: https://github.com/heidsoft/itsm\n- **问题反馈**: https://github.com/heidsoft/itsm/issues\n- **讨论社区**: https://github.com/heidsoft/itsm/discussions\n- **Email**: heidsoft@qq.com\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e⭐ 如果这个项目对你有帮助，请给一个 Star 支持！\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Made with ❤️ by ITSM Team\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheidsoft%2Fitsm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheidsoft%2Fitsm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheidsoft%2Fitsm/lists"}