{"id":13597778,"url":"https://github.com/734839030/seezoon-stack","last_synced_at":"2026-01-12T11:44:32.704Z","repository":{"id":40320413,"uuid":"310070910","full_name":"734839030/seezoon-stack","owner":"734839030","description":"一款基于当前最前沿的前端（Vue3 + Vite + Antdv）和后台（Spring boot）实现的低代码开发平台。","archived":false,"fork":false,"pushed_at":"2023-01-08T15:43:21.000Z","size":9473,"stargazers_count":305,"open_issues_count":11,"forks_count":109,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-04-10T05:40:52.892Z","etag":null,"topics":["admin","admin-dashboard","antdv","generator","java","redis","seezoon-generator","spring-boot","spring-security","spring-session","vite","vue3"],"latest_commit_sha":null,"homepage":"https://doc.stack.seezoon.com","language":"Java","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/734839030.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-11-04T17:24:34.000Z","updated_at":"2025-03-25T15:01:39.000Z","dependencies_parsed_at":"2023-02-08T06:31:31.247Z","dependency_job_id":null,"html_url":"https://github.com/734839030/seezoon-stack","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/734839030/seezoon-stack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/734839030%2Fseezoon-stack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/734839030%2Fseezoon-stack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/734839030%2Fseezoon-stack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/734839030%2Fseezoon-stack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/734839030","download_url":"https://codeload.github.com/734839030/seezoon-stack/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/734839030%2Fseezoon-stack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28338972,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T10:58:46.209Z","status":"ssl_error","status_checked_at":"2026-01-12T10:58:42.742Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["admin","admin-dashboard","antdv","generator","java","redis","seezoon-generator","spring-boot","spring-security","spring-session","vite","vue3"],"created_at":"2024-08-01T17:00:41.155Z","updated_at":"2026-01-12T11:44:32.687Z","avatar_url":"https://github.com/734839030.png","language":"Java","readme":"![seezoon](doc/pictures/logo.png)\n\n## 简介\n\n**Seezoon Stack** 以**快速开发**为目的，在开发速度和代码结构上做出一定取舍，无论如何，你将看到**非常地道**的 Java\n常用开发框架使用。该项目采用主流开发框架，无论打包、编译、部署都按着大公司的标准完成并不断逐步完善。\n\n## 💻 在线演示\n\n**详细文档及演示地址：**  [https://doc.stack.seezoon.com](https://doc.stack.seezoon.com)\n\n账号：admin\n\n密码：123456\n当前阿里云服务器到期，文档可以访问，系统暂时无法访问了.\n\n部分效果图：\n\n\u003cimg src=\"doc/pictures/image-20210422205522263.png\" alt=\"image-20210422205522263\" style=\"zoom:50%;\" /\u003e\n\n\u003cimg src=\"doc/pictures/image-20210422205553804.png\" alt=\"image-20210422205553804\" style=\"zoom:50%;\" /\u003e\n\n\u003cimg src=\"doc/pictures/image-20210422205738456.png\" alt=\"image-20210422205738456\" style=\"zoom:50%;\" /\u003e\n\n## 技术选型\n\n**Seezoon Stack** 采用当下最前沿前后端的技术栈完成。\n\n后台**主要**框架：\n\n| 框架名称                  | 框架地址                                             | 说明           |\n| ------------------------- | ---------------------------------------------------- | -------------- |\n| Spring Boot               | https://spring.io/projects/spring-boot               | 自动装配       |\n| Spring Session Data Redis | https://spring.io/projects/spring-session-data-redis | 登录态管理     |\n| Spring Security           | https://spring.io/projects/spring-security           | 登录及权限控制 |\n| Mybatis                   | https://mybatis.org/mybatis-3/zh/index.html          | 持久层         |\n| Springfox                 | https://github.com/springfox/springfox               | openAPI 3 文档 |\n\n## 特性\n\n- JSR303 验证、标准API模型，错误码、异常处理封装\n- 请求埋点，返回头添加`X-Trace-Id`，通过`MDC`在日志中埋入线程ID;\n- Redis 封装，序列化\n- RestTemplate 线程池、证书请求及默认属性约定\n- Spring Boot 异步线程配置\n- 跨域支持\n- 基于openAPI 3.0 规范的自动生成文档\n- 前后端一体化代码生成\n- 登录及权限控制\n- 文件处理，支持磁盘文件和阿里云OSS\n- 国际化\n- 通用数据权限\n- 动态菜单\u0026按钮\n\n优先级较低的功能(TODO)：\n\n- 阿里云短信\n- Excel 处理\n- 微信公众号、小程序相关，登录，支付等常用封装\n- 云原生部署及编排文档\n\n前台**主要**框架：\n\n| 框架名称         | 框架地址                                        | 说明            |\n| ---------------- | ----------------------------------------------- | --------------- |\n| Vue 3            | https://v3.cn.vuejs.org/guide/introduction.html | 双向绑定        |\n| Vite             | https://cn.vitejs.dev/                          | 构建工具        |\n| Ant Design Vue 2 | https://2x.antdv.com/components/overview-cn/    | 组件            |\n| TypeScript 4     | https://www.typescriptlang.org/zh/              | JavaScript 超集 |\n| Windi Css        | https://windicss.org/guide/                     | css 辅助类      |\n| Iconify          | https://iconify.design/                         | 图标库          |\n\n前端框架 fork  [Vue vben admin 2.0](https://vvbin.cn/doc-next/)，定期会合并上游特性，具体组件请参考 Vben admin 文档。在此也感谢Vben admin 对该项目提供的帮助。\n\n前端主要采用Ant Design Vue 2 作为主要组件库，降低学习成本，主体框架均为TypeScript，业务功能采用JavaScript编写，针对快速开发JavaScript 代码量较为简洁，速度较快。\n\n## 环境准备\n\n- JDK 1.8 + （建议11）\n- Maven 3 +\n- Node 12 +\n- Yarn（安装完node，可用`npm install -g yarn`）\n- Redis\n- Mysql 5.7 + (建议8)\n\n## 🚀 快速开始\n\n**代码下载**\n\n可以通过 IDEA `File-\u003eNew-\u003eProject From Version Control `导入，也可以通过命令下载后导入。\n\n\u003e 建议fork 后到自己仓库后再导入，方便后续同步更新。\n\n```\ngit clone https://github.com/734839030/seezoon-stack.git\n```\n\n**工程结构**\n\n```\n​```\n.\n└── seezoon-stack   parent工程\n    ├── build 构建所需文件\n    │   ├── assembly    生成产出物结构\n    │   │   ├── bin     项目脚本\n    │   │   ├── conf    配置目录\n    │   │   ├── logs    日志目录\n    │   │   └── assembly.xml     maven assembly 打包插件描述文件(不打包到产出物)\n    │   ├── build.sh    构建脚本\n    │   ├── eclipse-codestyle.xml  P3C代码格式,可以自行更新\n    │   ├── maven-settings.xml     maven的setting配置(可选)\n    │   └── mybatis-generator-config.xml  原生mybatis-generator 描述文件(可选)\n    ├── db DB脚本目录\n    ├── doc 项目文档及资料维护目录\n    ├── seezoon-admin-server  管理端服务\n    ├── seezoon-admin-web  后台页面目前fork上游,代码库单独维护稳定后合并\n    ├── seezoon-dao    DAO层，方便管理端和C端引用\n    ├── seezoon-framework  管理端和C端通用框架层(基础中间件,参数验证，安全控制)\n    ├── seezoon-generator  通用代码生成器，可以单独使用也可以供其他组件继承使用\n    └── seezoon-user-server  C端服务端TODO\n​```\n```\n\n### 后台\n\n- **初始化DB脚本**\n\n  脚本见`db/seezoon-stack.sql`\n\n- **配置seezoon-admin-server**\n\n  在如下配置文件配置**DB**和**Redis**账号密码\n\n  `seezoon-admin-server/src/main/resources/application-local.properties`\n\n- **IDEA中启动后台**\n\n\u003e 执行如下类中Main方法(如果报依赖错误，可以执行parent 工程mvn package)\n\n​      `seezoon-admin-server/src/main/java/com/seezoon/admin/AdminMain.java`\n\n### 前台\n\n- **安装依赖并启动**\n\n  ```\n  cd seezoon-stack/seezoon-admin-web\n  yarn install\n  yarn serve \n  \n  # 访问地址\n  http://localhost:3100/\n  ```\n\n- **本地测试文件服务器(可选)**\n\n  ```\n  cd seezoon-admin-web/test/server/upload\n  yarn install\n  yarn start\n  \n  # 管理端上传文件后，可以直接访问地址static目录静态文件\n  http://localhost:3001/static/xxxx\n  ```\n\n## 生产环境部署\n\n线上目录结构，\n\n```\n/data/\n│── cert\n├── seezoon-admin-server  # 后台产出物\n│   ├── bin\n│   ├── conf\n│   ├── logs\n│   └── work\n├── seezoon-admin-web    # 前端产出物\n│   ├── assets\n│   └── resource\n└── upload-server  文件上传目录，默认使用磁盘文件，使用OSS则不需要.\n```\n\n### 😇 手工部署-后台\n\n\u003e 线上环境安装Java 1.8 + ，推荐11。\n\n采用[maven-assembly-plugin](http://maven.apache.org/plugins/maven-assembly-plugin/)生成构建物，可以直接生成生产部署的目录结构，方便DevOps 集成.\n\n```\ncd seezoon-admin-server\nmvn clean package\n```\n\n**产出物目录**\n\n`seezoon-admin-server/target/seezoon-admin-server`\n\n**只需要维护产出物`conf `目录的`application.properties `即可**，然后就可以发布了。\n\n\u003e 配置文件与环境分离，`maven-jar-plugin` 打包产出物`jar`会排出`resources`目录如下文件：\n\n```\napplication-local.properties\nlogback-spring.xml\n```\n\n\u003e 如果不介意各个环境配置都在工程中那就很方便，使用spring boot 提供的`--spring.profiles.active`，在启动命令中选择配置文件。\n\n\u003cimg src=\"doc/pictures/image-20210423121842460.png\" alt=\"image-20210423121842460\" /\u003e\n\n### 😇 手工部署-前台\n\n```\ncd seezoon-admin-web\nyarn build\n```\n\n**产出物**\n\n`seezoon-admin-web/dist` 中文件发布到线上nginx 目录即可，该工程nginx 配置如下，仅供参考。\n\n```\nupstream seezoon-admin-server {\n    server 127.0.0.1:8080 max_fails=3 fail_timeout=10s;\n}\n\nserver {\n    listen       80;\n    server_name  stack.seezoon.com;\n    rewrite ^(.*)$  https://$host$1 permanent;\n}\n\nserver {\n    listen       443;\n    server_name  stack.seezoon.com;\n    ssl on;\n    ssl_certificate   /data/cert/stack.seezoon.com.pem; \n    ssl_certificate_key  /data/cert/stack.seezoon.com.key;\n    ssl_session_timeout 5m;\n    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;\n    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;\n    ssl_prefer_server_ciphers on;\n\n    # api\n    location ^~ /api/ {\n        proxy_redirect off;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Real-PORT $remote_port;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n        proxy_pass http://seezoon-admin-server/;\n    }\n    # 文件服务\n    location ^~ /file/ {\n        access_log off;\n        alias /data/upload-server/;\n    }\n\n    # 静态资源\n    location / {\n        access_log off;\n        root /data/seezoon-admin-web/;\n        index index.html index.htm;\n    }\n\n}\n```\n\n\u003e 可选静态资源压缩配置，放在`nginx.conf http` 节点下。\n\n```\n# 打开gzip 效果更佳\ngzip on;\ngzip_min_length 1k;\ngzip_buffers 4 16k;\ngzip_http_version 1.0;\ngzip_comp_level 6;\ngzip_types text/plain application/javascript application/x-javascript text/css application/xml text/javascript application/x-httpd-php image/jpeg image/gif image/png;\ngzip_vary off;\ngzip_disable \"MSIE [1-6]\\.\";\n```\n\n\n\n## 如何贡献\n\n非常欢迎你的加入！[提一个 Issue](https://github.com/734839030/seezoon-stack/issues/new) 或者提交一个 Pull Request。\n\n**Pull Request：**\n\n1. Fork 代码! (同步上游：git pull https://github.com/734839030/seezoon-stack.git master)\n2. 创建自己的分支: `git checkout -b feat/xxxx`\n3. 提交你的修改: `git commit -m 'feat(function): add xxxxx'`\n4. 推送您的分支: `git push origin feat/xxxx`\n5. 提交`pull request`\n\n## Git 贡献提交规范\n\n参考规范 ([Angular](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular))\n\n    - `feat` 增加新功能\n    - `fix` 修复问题/BUG\n    - `style` 代码风格相关无影响运行结果的\n    - `perf` 优化/性能提升\n    - `refactor` 重构\n    - `revert` 撤销修改\n    - `test` 测试相关\n    - `docs` 文档/注释\n    - `chore` 依赖更新/脚手架配置修改等\n    - `workflow` 工作流改进\n    - `ci` 持续集成\n    - `types` 类型定义文件更改\n    - `wip` 开发中\n\n","funding_links":[],"categories":["Java"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F734839030%2Fseezoon-stack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F734839030%2Fseezoon-stack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F734839030%2Fseezoon-stack/lists"}