目录结构前端目录freesia-amidn目录结构来自layui-vue-adminsrc文件下api前端请求后端服务的路由assert一些内置或必要的资源文件layouts全局框架样式组件router静态路由和动态路由的配置、路由守卫storePinia全局变量维护stylescss样式文件typesTypeScript类型定义util一些工具类views系统展示页面后端目录后端按职责划分为三个顶层模块freesia-common通用基础能力、freesia-webWeb业务与启动、freesia-extends第三方组件扩展。通用模块freesia-common通用APIfreesia-common-api管理项目公共的yml配置文件日志文件格式配置文件、spy SQL日志打印配置、banner通用的i18n信息离线IP地址定位库ip2region所有POJO的基类PO、DTO、VO、Bean、Entity、Model统一返回结果集与状态码常量通用静态类、雪花ID生成器ECharts图表实体代码生成器freesia-common-codegen项目内生成Java文件的自定义代码生成程序生成文件所需要的配置文件basic.propertiesftl模板文件api、controller、converter、dto、mapper、mapperXml、po、repository、service、serviceImpl、vo通用框架frameworkfreesia-common-framework配置类ConfigurationXSS过滤、WebMvc各种工具类Util支持通用模块的Component包含切面类Aspect异常类Exception及其处理链Handler通用转换器Converter反射转换、MapStruct转换基础控制器BaseController、基础业务实现BaseServiceImpl通用分页查询、表格返回结果等POJO通用JSON模块freesia-common-jsonJackson的JSON工具类UJSON通用校验模块freesia-common-validation自定义校验注解如手机号校验校验器Validator与校验策略Strategy校验相关的i18n信息通用持久层模块freesia-common-jdbcMybatis-Plus、JPAMySQL/PostgreSQL配置类Druid过滤器配置审计组件Mybatis、JPA的创建人/修改人自动填充通用缓存模块freesia-common-cache引入Spring Cache缓存抽象依赖目前为预留模块暂无代码实现通用Redis模块freesia-common-redisRedis与Redisson配置类Redis工具类URedis通用对象存储freesia-common-oss同通用服务模块都是提供通用服务只是单独提取出来包括OSS对象存储配置和记录上传文件的信息功能提供OssFactory、OssHandler等操作入口与Domain域名注解通用权限认证freesia-common-satokenSa-Token配置类与登录用户模型权限校验实现与Redis会话处理器登录安全策略配置密码重试次数、锁定时间通用加密模块freesia-common-crypt响应体AES加解密处理Encrypt注解与返回值处理器密钥管理器支持密钥轮换与宽限期通用脱敏模块freesia-common-desensitizationDesensitize注解与脱敏类型脱敏序列化器与格式化处理器通用多租户模块freesia-common-tenant多租户配置与租户处理器租户字段与忽略表配置通用限流模块freesia-common-ratelimitRateLimiter注解基于Redis固定窗口的限流切面通用幂等模块freesia-common-idempotentIdempotent注解防止重复提交的幂等切面通用日志模块freesia-common-logLogRecord注解操作日志记录切面通用Excel模块freesia-common-excelexcel导入导出导入监听器与导出处理器Excel工具类UExcel通用网络模块freesia-common-nethttp网络请求HttpClient连接池配置、重试处理器等文件下载、URL配置等服务通用邮件模块freesia-common-mail邮件发送配置与工具类UMail通用SSE模块freesia-common-sse服务端推送SSE配置与Emitter管理器消息接收处理器与心跳调度消息主题常量通用接口文档模块freesia-common-docSpringDoc/OpenAPI接口文档配置文档分组与自定义处理器Web服务模块freesia-webWebAPI模块freesia-web-api管理Web层跨模块共享的Bean通用图标、图标模板Provider服务接口由icon等业务模块实现admin注入消费各业务模块的模块常量定义I18n信息仅依赖common-api极轻量任意模块均可安全引入AdminAPI模块freesia-web-admin-apiadmin域用户/租户/OSS/公告的对外共享契约Service接口、PO、DTO、Entity、常量、UNotice实现在freesia-web-admin消费方为account、icon等业务模块——依赖方向与web-api相反二者互补不重合业务模块禁止直接依赖freesia-web-admin需获取admin域能力时统一依赖本模块携带JPA PO是为保持admin包名不变、实现类零源码改动的折中设计后续收紧域隔离时优先收敛为接口DTOWeb应用启动模块freesia-web-appAdmin应用的启动Admin应用的Yml配置文件测试类包括Java测试与Spring测试应用启动后的初始化RunnerWeb框架模块freesia-web-framework配置类ConfigurationWeb通用、Mybatis、验证码、Jackson支持Web模块的Component异常类Exception及其切面各种需要作用于配置类的处理类handler、帮助类helper数据权限拦截器与Mybatis的SQL拦截器自定义注解数据列、数据权限配置属性类PropertiesWeb管理系统模块freesia-web-admin后端管理系统核心业务逻辑MVC架构覆盖用户、角色、菜单、部门、字典、租户、客户端、系统配置、通知公告、文件管理、URL配置、敏感日志、待办、动态列配置等管理功能登录认证策略密码、验证码、二维码、第三方OAuth登录记账模块freesia-web-account记账相关的账目、费用分摊、预算、报表等业务逻辑支持账目导入导出、报表定时生成与重算通用图标模块freesia-web-icon通用图标与图标模板表头、明细管理支持图标树查询与排序世界时钟模块freesia-web-worldclock世界时钟城市管理日出日落时间计算与时区转换历史上的今天模块freesia-web-todayhistory历史上的今天数据爬取与解析定时同步历史事件数据AI对话模块freesia-web-chatDeepSeek对话会话、消息记录RAG知识库检索增强与向量存储pgvector拼豆模块freesia-web-fusebean拼豆像素画生成内置image-to-pindou图像转换技能Node脚本与MARD色卡扩展模块freesia-extendsSpringBootAdmin服务端freesia-spring-adminSpring Boot Admin服务端配置敏感字段脱敏与实例状态通知XXL-JOB执行器freesia-xxl-jobXXL-JOB执行器配置XXL-JOB建表SQL