目錄結(jié)構(gòu)前端目錄freesia-amidn目錄結(jié)構(gòu)來自layui-vue-adminsrc文件下api前端請(qǐng)求后端服務(wù)的路由assert一些內(nèi)置或必要的資源文件layouts全局框架樣式組件router靜態(tài)路由和動(dòng)態(tài)路由的配置、路由守衛(wèi)storePinia全局變量維護(hù)stylescss樣式文件typesTypeScript類型定義util一些工具類views系統(tǒng)展示頁(yè)面后端目錄后端按職責(zé)劃分為三個(gè)頂層模塊freesia-common通用基礎(chǔ)能力、freesia-webWeb業(yè)務(wù)與啟動(dòng)、freesia-extends第三方組件擴(kuò)展。通用模塊freesia-common通用APIfreesia-common-api管理項(xiàng)目公共的yml配置文件日志文件格式配置文件、spy SQL日志打印配置、banner通用的i18n信息離線IP地址定位庫(kù)ip2region所有POJO的基類PO、DTO、VO、Bean、Entity、Model統(tǒng)一返回結(jié)果集與狀態(tài)碼常量通用靜態(tài)類、雪花ID生成器ECharts圖表實(shí)體代碼生成器freesia-common-codegen項(xiàng)目?jī)?nèi)生成Java文件的自定義代碼生成程序生成文件所需要的配置文件basic.propertiesftl模板文件api、controller、converter、dto、mapper、mapperXml、po、repository、service、serviceImpl、vo通用框架frameworkfreesia-common-framework配置類ConfigurationXSS過濾、WebMvc各種工具類Util支持通用模塊的Component包含切面類Aspect異常類Exception及其處理鏈Handler通用轉(zhuǎn)換器Converter反射轉(zhuǎn)換、MapStruct轉(zhuǎn)換基礎(chǔ)控制器BaseController、基礎(chǔ)業(yè)務(wù)實(shí)現(xiàn)BaseServiceImpl通用分頁(yè)查詢、表格返回結(jié)果等POJO通用JSON模塊freesia-common-jsonJackson的JSON工具類UJSON通用校驗(yàn)?zāi)Kfreesia-common-validation自定義校驗(yàn)注解如手機(jī)號(hào)校驗(yàn)校驗(yàn)器Validator與校驗(yàn)策略Strategy校驗(yàn)相關(guān)的i18n信息通用持久層模塊freesia-common-jdbcMybatis-Plus、JPAMySQL/PostgreSQL配置類Druid過濾器配置審計(jì)組件Mybatis、JPA的創(chuàng)建人/修改人自動(dòng)填充通用緩存模塊freesia-common-cache引入Spring Cache緩存抽象依賴目前為預(yù)留模塊暫無代碼實(shí)現(xiàn)通用Redis模塊freesia-common-redisRedis與Redisson配置類Redis工具類URedis通用對(duì)象存儲(chǔ)freesia-common-oss同通用服務(wù)模塊都是提供通用服務(wù)只是單獨(dú)提取出來包括OSS對(duì)象存儲(chǔ)配置和記錄上傳文件的信息功能提供OssFactory、OssHandler等操作入口與Domain域名注解通用權(quán)限認(rèn)證freesia-common-satokenSa-Token配置類與登錄用戶模型權(quán)限校驗(yàn)實(shí)現(xiàn)與Redis會(huì)話處理器登錄安全策略配置密碼重試次數(shù)、鎖定時(shí)間通用加密模塊freesia-common-crypt響應(yīng)體AES加解密處理Encrypt注解與返回值處理器密鑰管理器支持密鑰輪換與寬限期通用脫敏模塊freesia-common-desensitizationDesensitize注解與脫敏類型脫敏序列化器與格式化處理器通用多租戶模塊freesia-common-tenant多租戶配置與租戶處理器租戶字段與忽略表配置通用限流模塊freesia-common-ratelimitRateLimiter注解基于Redis固定窗口的限流切面通用冪等模塊freesia-common-idempotentIdempotent注解防止重復(fù)提交的冪等切面通用日志模塊freesia-common-logLogRecord注解操作日志記錄切面通用Excel模塊freesia-common-excelexcel導(dǎo)入導(dǎo)出導(dǎo)入監(jiān)聽器與導(dǎo)出處理器Excel工具類UExcel通用網(wǎng)絡(luò)模塊freesia-common-nethttp網(wǎng)絡(luò)請(qǐng)求HttpClient連接池配置、重試處理器等文件下載、URL配置等服務(wù)通用郵件模塊freesia-common-mail郵件發(fā)送配置與工具類UMail通用SSE模塊freesia-common-sse服務(wù)端推送SSE配置與Emitter管理器消息接收處理器與心跳調(diào)度消息主題常量通用接口文檔模塊freesia-common-docSpringDoc/OpenAPI接口文檔配置文檔分組與自定義處理器Web服務(wù)模塊freesia-webWebAPI模塊freesia-web-api管理Web層跨模塊共享的Bean通用圖標(biāo)、圖標(biāo)模板Provider服務(wù)接口由icon等業(yè)務(wù)模塊實(shí)現(xiàn)admin注入消費(fèi)各業(yè)務(wù)模塊的模塊常量定義I18n信息僅依賴common-api極輕量任意模塊均可安全引入AdminAPI模塊freesia-web-admin-apiadmin域用戶/租戶/OSS/公告的對(duì)外共享契約Service接口、PO、DTO、Entity、常量、UNotice實(shí)現(xiàn)在freesia-web-admin消費(fèi)方為account、icon等業(yè)務(wù)模塊——依賴方向與web-api相反二者互補(bǔ)不重合業(yè)務(wù)模塊禁止直接依賴freesia-web-admin需獲取admin域能力時(shí)統(tǒng)一依賴本模塊攜帶JPA PO是為保持admin包名不變、實(shí)現(xiàn)類零源碼改動(dòng)的折中設(shè)計(jì)后續(xù)收緊域隔離時(shí)優(yōu)先收斂為接口DTOWeb應(yīng)用啟動(dòng)模塊freesia-web-appAdmin應(yīng)用的啟動(dòng)Admin應(yīng)用的Yml配置文件測(cè)試類包括Java測(cè)試與Spring測(cè)試應(yīng)用啟動(dòng)后的初始化RunnerWeb框架模塊freesia-web-framework配置類ConfigurationWeb通用、Mybatis、驗(yàn)證碼、Jackson支持Web模塊的Component異常類Exception及其切面各種需要作用于配置類的處理類handler、幫助類helper數(shù)據(jù)權(quán)限攔截器與Mybatis的SQL攔截器自定義注解數(shù)據(jù)列、數(shù)據(jù)權(quán)限配置屬性類PropertiesWeb管理系統(tǒng)模塊freesia-web-admin后端管理系統(tǒng)核心業(yè)務(wù)邏輯MVC架構(gòu)覆蓋用戶、角色、菜單、部門、字典、租戶、客戶端、系統(tǒng)配置、通知公告、文件管理、URL配置、敏感日志、待辦、動(dòng)態(tài)列配置等管理功能登錄認(rèn)證策略密碼、驗(yàn)證碼、二維碼、第三方OAuth登錄記賬模塊freesia-web-account記賬相關(guān)的賬目、費(fèi)用分?jǐn)偂㈩A(yù)算、報(bào)表等業(yè)務(wù)邏輯支持賬目導(dǎo)入導(dǎo)出、報(bào)表定時(shí)生成與重算通用圖標(biāo)模塊freesia-web-icon通用圖標(biāo)與圖標(biāo)模板表頭、明細(xì)管理支持圖標(biāo)樹查詢與排序世界時(shí)鐘模塊freesia-web-worldclock世界時(shí)鐘城市管理日出日落時(shí)間計(jì)算與時(shí)區(qū)轉(zhuǎn)換歷史上的今天模塊freesia-web-todayhistory歷史上的今天數(shù)據(jù)爬取與解析定時(shí)同步歷史事件數(shù)據(jù)AI對(duì)話模塊freesia-web-chatDeepSeek對(duì)話會(huì)話、消息記錄RAG知識(shí)庫(kù)檢索增強(qiáng)與向量存儲(chǔ)pgvector拼豆模塊freesia-web-fusebean拼豆像素畫生成內(nèi)置image-to-pindou圖像轉(zhuǎn)換技能Node腳本與MARD色卡擴(kuò)展模塊freesia-extendsSpringBootAdmin服務(wù)端freesia-spring-adminSpring Boot Admin服務(wù)端配置敏感字段脫敏與實(shí)例狀態(tài)通知XXL-JOB執(zhí)行器freesia-xxl-jobXXL-JOB執(zhí)行器配置XXL-JOB建表SQL