{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/523", "result": {"data":{"issuesJson":{"id":"d98a5f8f-29da-5592-bfe4-64e9418fc083","title":"sunwenbo/smart-api: 基于 Go 语言开发的自定义开放式工单系统","number":523,"bodyHTML":"
\n



\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Repossunwenbo/smart-api
Views\"views\"
Stars\"stars\"
Forks\"forks\"
License\"license\"
UpdatedAt\"last-commit\"
CreatedAt\"create-at\"
\n\n

\"\"

\n\n
\n

Smart 工单系统

\n

Smart-API 工单系统是基于 Go 语言开发的后台管理系统，前后端分离，采用 Gin 框架作为后端，Vue.js 和 Element UI 作为前端。系统旨在实现对工单管理的高效处理，支持任务分配、执行监控、实时更新等功能。

\n

\n

\"Static
\n\"License\"

\n

简体中文|English

\n

基于Gin + Vue + Element UI OR Arco Design OR Ant Design的前后端分离权限管理系统,系统初始化极度简单，只需要配置文件中，修改数据库连接，系统支持多指令操作，迁移指令可以让初始化数据库信息变得更简单，服务指令可以很简单的启动api服务

\n

前端项目

\n

后端项目

\n

smart 命名原则

\n\n

🎬 在线体验

\n

点击访问在线演示

\n
\n

默认登录账户: admin / 123456

\n
\n

✨ 架构特性

\n\n

🤩 功能特色

\n\n

🎁 内置

\n
    \n
  1. 多租户：系统默认支持多租户，按库分离，一个库一个租户。
    2. \n
  2. 用户管理：用户是系统操作者，该功能主要完成系统用户配置。
    3. \n
  3. 部门管理：配置系统组织机构（公司、部门、小组），树结构展现支持数据权限。
    4. \n
  4. 岗位管理：配置系统用户所属担任职务。
    5. \n
  5. 菜单管理：配置系统菜单，操作权限，按钮权限标识，接口权限等。
    6. \n
  6. 角色管理：角色菜单权限分配、设置角色按机构进行数据范围权限划分。
    7. \n
  7. 字典管理：对系统中经常使用的一些较为固定的数据进行维护。
    8. \n
  8. 参数管理：对系统动态配置常用参数。
    9. \n
  9. 操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
    10. \n
  10. 登录日志：系统登录日志记录查询包含登录异常。
    11. \n
  11. 接口文档：根据业务代码自动生成相关的api接口文档。
    12. \n
  12. 代码生成：根据数据表结构生成对应的增删改查相对应业务，全程可视化操作，让基本业务可以零代码实现。
    13. \n
  13. 表单构建：自定义页面样式，拖拉拽实现页面布局。
    14. \n
  14. 服务监控：查看一些服务器的基本信息。
    15. \n
  15. 内容管理：demo功能，下设分类管理、内容管理。可以参考使用方便快速入门。
    16. \n
  16. 定时任务：自动化任务，目前支持接口调用和函数调用。
    17. \n
\n

🛰️ 系统模块

\n
    \n
  1. 用户管理：支持用户信息的管理及权限分配。
    2. \n
  2. 任务中心：提供工单的分配、追踪和状态监控。
    3. \n
  3. 工单中心：工单申请和查看工单列表。
    4. \n
  4. 流程中心：自定义工单类型、工单表单、审批流程支持多个业务场景。
    5. \n
  5. 角色管理：通过角色实现细粒度的权限控制。
    6. \n
  6. 日志管理：包括系统操作日志和任务执行日志。
    7. \n
  7. 服务监控：实时查看服务器性能与运行状态。
    8. \n
  8. 评分与留言：任务结束后支持用户对工单评分并提交评价。
    9. \n
\n

🔧 技术栈

\n\n

🚀 快速开始

\n

准备工作

\n

你需要在本地安装 go gin node 和 git

\n

📦 环境要求

\n\n

后端安装步骤

\n
    \n
  1. \n

    克隆项目：

    \n
    git clone https://github.com/sunwenbo/smart-api.git\ncd smart-api
    \n
    2. \n
  2. \n

    安装依赖：

    \n
    go mod tidy
    \n
    3. \n
  3. \n

    配置数据库连接信息：

    \n
    cp config/settings.full.yml config/settings.yml
    \n

    ⚠️：修改 config/settings.yml 中的数据库连接信息确保数据库配置正确，在执行初始化数据库前要先手动创建数据库。

    \n
      \n
    1. 配置文件中修改数据库信息
      2. \n
    2. 注意: settings.database 下对应的配置数据
      3. \n
    3. 确认log路径
      4. \n
    \n
    4. \n
  4. \n

    编译

    \n
    go build -o smart-api main.go
    \n
    5. \n
  5. \n

    初始化数据库：

    \n
    # 首次配置需要初始化数据库资源信息\n# macOS or linux 下使用\n$ ./smart-api migrate -c config/settings.yml\n\n# ⚠️注意:windows 下使用\n$ smart-api.exe migrate -c config/settings.yml\n\n# 启动项目，也可以用IDE进行调试\n# macOS or linux 下使用\n$ ./smart-api server -c config/settings.yml\n\n\n# ⚠️注意:windows 下使用\n$ smart-api.exe server -c config/settings.yml
    \n
    6. \n
  6. \n

    sys_api 表的数据如何添加

    \n
    # 在项目启动时，使用`-a true` 系统会自动添加缺少的接口数据\n./smart-api server -c config/settings.yml -a true
    \n
    7. \n
  7. \n

    更新Swagger文档生成

    \n
    go generate
    \n
    8. \n
  8. \n

    启动服务：

    \n
    ./smart-api server -c config/settings.yml
    \n
    9. \n
  9. \n

    本地开发数据库迁移

    \n
    生成迁移文件\ngo run main.go migrate -g true -c config/settings.yml\n\n生成迁移文件--系统相关\ngo run main.go migrate -g true -a true  -c config/settings.yml\n   \n修改完迁移文件后，执行下面命令开始变更\ngo run main.go migrate -c config/settings.yml\n\n接口管理生成\ngo run main.go server -c config/settings.yml -a false\n
    \n
    \n常用命令示例\n\ngo run main.go migrate -h # 帮助\ngo run main.go migrate -g true -a true  -c config/settings.yml # 生成smart-api系统预置 迁移文件\ngo run main.go migrate -g true -c config/settings.yml  # 生成 自定义功能 迁移文件 自己开发新功能用这个功能\ngo run main.go migrate -c config/settings.yml # 执行迁移命令 迁移 未迁移过的 文件\n\n参数说明：\n\n-h # 帮助\n-c # 指定配置文件 默认使用 -c config/settings.yml 配置文件\n-a # 生成 系统预置 迁移文 生成到` cmd/migrate/migration/version ` go-admin系统迁移文件在这目录里操作，最好不要动，方便同步升级\n-g # 生成迁移文 生成到` cmd/migrate/migration/version-local `  自己开发新功能的迁移文件在这目录里操作\n
    \n
    10. \n
\n

交叉编译

\n
# windows\nenv GOOS=windows GOARCH=amd64 go build main.go\n\n# or\n# linux\nenv GOOS=linux GOARCH=amd64 go build main.go
\n

前端安装步骤

\n
    \n
  1. \n

    克隆前端项目：

    \n
    git clone https://github.com/sunwenbo/smart-ui.git\ncd smart-ui
    \n
    2. \n
  2. \n

    安装依赖：

    \n
    npm config set registry https://registry.npmmirror.com/  \nnpm config get registry\nnpm install --legacy-peer-deps
    \n
    3. \n
  3. \n

    启动开发服务器：

    \n
    npm run dev
    \n
    4. \n
  4. \n

    访问地址：

    \n

    打开浏览器并访问 http://localhost:9527 查看前端界面。

    \n
    5. \n
\n

使用docker启动

\n

非本地部署时要先初始化数据库的数据，可以使用本地编译后的二进制文件执行如下命令

\n

后端

\n

⚠️⚠️⚠️要修改settings.yml 文件中的数据库信息，同样需要手动创建smart-api库

\n
./smart-api migrate -c config/settings.yml
\n

本地如果是arm架构，但是想构建为x86架构的镜像，mac为例

\n
# 构建镜像\ndocker buildx build --platform linux/amd64 -t registry.cn-beijing.aliyuncs.com/sunwenbo/smart-api:latest . --load    \n# 推向镜像仓库\ndocker push registry.cn-beijing.aliyuncs.com/sunwenbo/smart-api:latest\n# 启动后端服务，挂载settings.yml文件， 我将配置文件放在了\"/data/config/\" 目录下\ndocker run -itd  \\\n  -p 8000:8000 \\\n  -v /data/config/:/home/service/config/ \\\n  --name smart-api \\\n  registry.cn-beijing.aliyuncs.com/sunwenbo/smart-api:latest
\n

前端

\n
# 构建镜像\ndocker buildx build --platform linux/amd64 -t registry.cn-beijing.aliyuncs.com/sunwenbo/smart-ui:latest . --load\n# 推向镜像仓库\ndocker push registry.cn-beijing.aliyuncs.com/sunwenbo/smart-ui:latest \n# 启动前端服务，挂载nginx的配置文件\ndocker run -itd  \\\n  -p 80:80 \\\n  -v /data/default.conf:/etc/nginx/conf.d/default.conf \\\n  --name smart-ui \\\n  registry.cn-beijing.aliyuncs.com/sunwenbo/smart-ui:latest
\n

查看部署后状态

\n

\"img.png\"

\n

使用kubernetes部署

\n

初始化数据方法如上☝️

\n

后端

\n
cd smart-api/scripts/\nbash install.sh
\n

前端

\n
cd smart-ui/scripts/\n执行部署前要修改yaml中的配置，例如ingress\nbash install.sh
\n

检查部署情况

\n
kubect get cm -n sre \nkubect get pod -n sre \nkubect get ingress -n sre
\n

使用说明

\n
    \n
  1. 登录系统：使用默认管理员账户 admin 登录系统。
    2. \n
  2. 创建工单：进入任务管理页面，点击“创建工单”，填写相关信息并分配处理人。
    3. \n
  3. 任务执行监控：通过系统内的任务执行界面，可实时查看任务的执行状态、执行结果及日志。
    4. \n
  4. 工单评分与留言：工单结束后，用户可以对工单进行评分，并通过留言功能记录对工单处理过程的反馈。
    5. \n
\n

系统截图

\n

[数据统计]\"数据统计\"

\n

[工单申请]\"工单申请\"

\n

[自定义流程]\"自定义流程\"

\n

[自定义模板]\"自定义模板\"

\n

[工单管理]\"工单管理\"

\n

[任务类型]\"任务类型\"

\n

登录界面

\n

\"登录界面\"

\n

工单管理

\n

\"工单管理\"

\n

实时任务监控

\n

\"实时任务监控\"

\n

贡献指南

\n

欢迎社区开发者贡献代码或提供意见。如果你想参与本项目，请参考以下步骤：

\n
    \n
  1. \n

    Fork 本仓库：点击右上角的 Fork 按钮将项目复制到你的 GitHub 账户。

    \n
    2. \n
  2. \n

    克隆你的 Fork：在终端中运行以下命令，将项目克隆到本地：

    \n
    git clone https://github.com/your-username/smart-api-backend.git
    \n
    3. \n
  3. \n

    创建一个分支：在克隆的项目目录下，创建一个新分支用于开发：

    \n
    git checkout -b feature-branch-name
    \n
    4. \n
  4. \n

    提交你的改动：进行开发后，使用 git add 和 git commit 提交你的代码改动。

    \n
    git add .\ngit commit -m \"描述你的改动\"
    \n
    5. \n
  5. \n

    发起 Pull Request：在 GitHub 上提交 Pull Request，请确保你的代码通过了所有测试并遵循代码风格。

    \n
    6. \n
\n

常见问题

\n

如何修改数据库配置？

\n

数据库配置存储在 config/settings.yml 中，你可以根据自己的需求修改其中的 database 配置项。

\n

如何增加新的 API 接口？

\n

在 api 目录下创建新的处理逻辑，并在 router 中注册该路由。服务层逻辑应放置在 service 目录中。

\n

如何实现 WebSocket 实时任务监控？

\n

在任务执行时，系统通过 WebSocket 向前端推送任务状态更新信息。前端使用 WebSocket 接口接收并动态展示任务执行日志。

\n

开源许可

\n

Smart-API 工单系统使用 MIT 许可证 开源，欢迎个人和企业免费使用与修改。

\n

📨 互动

\n\n \n \n \n\n \n \n \n \n
个人微信微信群🔥🔥🔥
\n

💎 贡献者

\n

感谢以下开发者对本项目的贡献：

\n\n
\n

如果你有任何问题或建议，请通过 issue 提交。

\n
\n

🤝 特别感谢

\n

JetBrains 开源证书支持

\n

smart-api 项目一直以来都是在 JetBrains 公司旗下的 GoLand 集成开发环境中进行开发，基于 free JetBrains Open Source license(s) 正版免费授权，在此表达我的谢意。

\n

\n

开源框架组件

\n
    \n
  1. go-admin # 非常强大的后端开发框架、内置功能非常丰富,本项目基于go-admin框架开发
    2. \n
  2. wfd-vue # 流程设计器
    3. \n
  3. VForm 一款高效的Vue 2 / Vue3 的低代码表单可视化设计，一键生成源码
    4. \n
  4. ant-design
    5. \n
  5. ant-design-pro
    6. \n
  6. arco-design
    7. \n
  7. arco-design-pro
    8. \n
  8. gin
    9. \n
  9. casbin
    10. \n
  10. spf13/viper
    11. \n
  11. gorm
    12. \n
  12. gin-swagger
    13. \n
  13. jwt-go
    14. \n
  14. vue-element-admin
    15. \n
  15. ruoyi-vue
    16. \n
  16. form-generator
    17. \n
\n

🤟 打赏

\n
\n

如果你觉得这个项目帮助到了你，你可以帮作者买一杯☕️表示鼓励 :

\n
\n

\n

🤝 链接

\n

Go开发者成长线路图

\n

🔑 License

\n

MIT

\n

Copyright (c) 2022 sunwenbo

","updatedAt":"2025-05-22T01:48:44Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"工单","color":"e52df1"}},{"node":{"name":"sunwenbo","color":"046f98"}}]},"comments":{"edges":[]}}},"pageContext":{"number":523,"previous":{"title":"akazwz/smail: 使用 cloudflare worker 快速搭建临时邮箱服务","number":522},"next":{"title":"pymumu/smartdns: 一个本地DNS服务器，获取最快的网站IP，获得最佳上网体验，支持DoH，DoT，DoQ。","number":524}}}, "staticQueryHashes": ["151096407","2861350382"]}