開源后台系統*mee-admin*

mee-admin開源后台系統

Preface

  這是一個開放的時代，我們不能總是把東西揣在口袋里面自己樂呵。
  也正如名言所說的“如果你有兩塊面包，你當用其中一塊去換一朵水仙花”
  所以，繼上一次把我的兩個個人項目開源之后今天我再一次把自有的后台頁面也開源出來，以回饋整個開源世界。

開源地址

https://github.com/funnyzpc/mee-admin

項目結構概述

mee-admin是由我的個人mee項目開源而來,mee-admin項目是一個前后端一體化的項目,不過在代碼上實現了頁面與數據分離，是一個非常好的
輕量級后端工程，所以在正式使用時您會發現主體業務部門均是采用json交互，前端頁面使用模板工具實現數據展現及編輯
與jeesite不一樣，我們不使用jsp+sitmesh+ehcache臃腫化項目
與Spring-Cloud-Platform xboot 不一樣,這里不使用vue iview 做前后端分離，也不使用springclooud做集群分布式
所以我的項目更加輕量級，不需要裝node 不需要npm打包 需不要安裝nginx 同時也不需要編寫無聊的mapper接口，不需要單獨寫增刪改....
所以對於企業內部需求開發更是無比的急速
同時，mee-admin只需具有java后端以及一點點javascript開發能力，便可急速上手。

項目技術相關

• 使用springboot 2.3.4.RELEASE作為基礎框架
• 使用mybatis作為dao框架
• 使用postgreSQL 作為框架DB(可支持Mysql及Oracle)
• 使用shiro做權限管理
• 使用Freemarker做頁面模板
• 使用jquery 插件作javascript基本擴展庫使用
  • 目前只是一些組件依賴用,建議大多數情況下使用ES5或ES6規范的javascript擴展
• 使用handlebars做表單及數據模板
• 使用seajs 做基礎模塊管理
• 封裝了序列(ID)生成器(支持分布式)
  • SeqGenServiceImpl 序列生成器(支持分布式)
  • SeqGenUtil 普通序列生成器
• 封裝了Jackson的json庫，完全可替代fastjson
• 封裝了物理分頁PhysicalPageInterceptor及邏輯分頁LogicalPageIntercepter(兩個可任選其一)，完全替代RowBounds及一眾分頁依賴
• 封裝了Excel及CSV工具
  • ExcelReadUtil EXCEL讀工具
  • ExcelWriteUtil EXCEL寫工具
  • CSVUtils CSV讀工具
• 簡單封裝了java8日期工具類 DateUtil

項目界面

• 登錄
  

• 主頁
  

• 報表
  

• 基礎配置
  

• 編輯及修改
  

• 系統配置
  

項目運行及打包

• 本地項目運行

  • Fork mee-admin
  • git clone mee-admin to local
  • init DB table
  • use Idea IDE open project
  • auto build dependency
  • Idea start config
    • run MeeApplication and program arguments add --spring.profiles.active=dev
    • 注dev、test、prod均為pom.xml下配置的環境參數

• 打包及Linux服務器構建腳本,見mee-admin

  • 必須安裝maven(方法請自行搜索引擎查找)

項目訪問

• local: http://127.0.0.1/mee/login
• server: http://[Your DOMAIN or HOST+PORT]/mee/login

Notice

雖整個項目封裝的較為完整, 但是對於一些自定義的展示還是需要有一定的前端技能
作為補償，這里大致寫了功能開發流程[see:Function flow](#### Function flow),具體的還需要讀者具體學習哈~

Function flow

• 功能開發流程

  • 添加mybatis SQL xml文件及映射實體類entity
  • 編寫控制器controller及業務service代碼
  • 編寫構建前端頁面並添加菜單項
  • 添加依賴js resources/public/module 下
  • 后端添加權限標識@RequiresPermissions("your_auth_code")
  • 前端(菜單和業務頁面)添加權限標識<@shiro.hasPermission name="your_auth_code"></@shiro.hasPermission>
  • 后台添加菜單項目
  • 后台角色權限分配

• js添加對話框或按鈕擴展功能(這是難點!)

       業務前端js采用模塊化依賴並封裝了表單著錄以及增刪改查相應功能，十分便捷，
    目前對於擴展功能(比如添加一個’重算‘) 需要自定義函數及相應邏輯，具體流程大致如下

1. 在search-form內定義button控件(一定要有name屬性)
2. 在依賴的js文件內的init函數內定義擴展toolbar:{ "控件屬性名": 屬性名對應函數 }
3. 編寫相應函數邏輯

end

歡迎提交issue，如有好的建議及意也請留下腳印，這里先感謝哈😁
同時, 如有困難可以咨詢 [e-mail]