系统模块

# 字典缓存配置
dict:
  cache:
    enabled: true
    expire: 3600 # 缓存过期时间（秒）

<script setup lang="ts">
// 优雅解构，支持多个字典同时获取
const { sys_user_sex, sys_notice_type } = useDict('sys_user_sex', 'sys_notice_type');
</script>

<template>
  <!-- 直接绑定 options -->
  <Select v-model="form.sex" :options="sys_user_sex" />
</template>

public interface DictApi {
    /**
     * 根据字典类型获取数据列表
     */
    List<DictItemDTO> getDictData(String typeCode);

    /**
     * 获取字典标签（翻译）
     */
    String getDictLabel(String typeCode, String itemValue);
}

@Service
@RequiredArgsConstructor
public class UserServiceImpl implements UserService {

    private final DictApi dictApi;

    public UserVO getUser(Long id) {
        User user = userMapper.selectById(id);
        UserVO vo = toVO(user);
        
        // 使用契约接口获取字典标签（仅需取值）
        vo.setSexLabel(dictApi.getDictLabel("sys_user_sex", user.getSex()));
        
        return vo;
    }
}

// 注入消息服务
@Autowired
private MessageService messageService;

// 发送消息
MessageDTO messageDTO = new MessageDTO();
messageDTO.setTemplateCode("sys_user_register");
messageDTO.setReceiverId(userId);
messageDTO.setVariables(Collections.singletonMap("username", username));
messageService.send(messageDTO);

// 获取未读消息数量
import { useMessage } from '@/hooks/useMessage';

const { unreadCount, getUnreadCount } = useMessage();

// 获取消息列表
const messageList = await messageService.getMessageList({ page: 1, size: 10 });

@OperationLog(module = "用户管理", name = "新增用户", type = OperationType.ADD)
@PostMapping
public Result<Void> addUser(@RequestBody @Validated UserDTO userDTO) {
    // 新增用户逻辑
}

// 获取配置值
ConfigService configService = SpringContextHolder.getBean(ConfigService.class);
String siteTitle = configService.getConfigValue("site_title");

// 或使用注解
@Value("${config.site_title}")
private String siteTitle;

# 本地存储配置
storage:
  type: local
  local:
    base-path: uploads
    domain: http://localhost:8080

# MinIO 配置
storage:
  type: minio
  minio:
    endpoint: http://minio:9000
    access-key: minioadmin
    secret-key: minioadmin
    bucket-name: tagtag
    domain: http://minio:9000

// 注入存储服务
@Autowired
private StorageService storageService;

// 上传文件
MultipartFile file = request.getFile("file");
StorageResult result = storageService.upload(file, "image/");

// 下载文件
String fileId = request.getParameter("fileId");
storageService.download(fileId, response);

tagtag-module-system
└── src
    └── main
        ├── java
        │   └── dev
        │       └── tagtag
        │           └── module
        │               └── system
        │                   ├── controller
        │                   │   ├── DictController.java
        │                   │   ├── MessageController.java
        │                   │   ├── OperationLogController.java
        │                   │   └── StorageController.java
        │                   ├── entity
        │                   │   ├── DictType.java
        │                   │   ├── DictData.java
        │                   │   ├── MessageTemplate.java
        │                   │   ├── MessageRecord.java
        │                   │   └── OperationLog.java
        │                   ├── mapper
        │                   │   ├── DictMapper.java
        │                   │   ├── MessageMapper.java
        │                   │   └── OperationLogMapper.java
        │                   ├── service
        │                   │   ├── DictService.java
        │                   │   ├── MessageService.java
        │                   │   ├── OperationLogService.java
        │                   │   └── StorageService.java
        │                   └── util
        │                       └── StorageUtil.java
        └── resources
            ├── db
            │   ├── schema.sql
            │   └── data
            │       ├── 01_sys_message.sql
            │       ├── 02_sys_message_menu.sql
            │       └── 03_sys_dict_menu.sql
            └── mapper
                └── system
                    ├── DictMapper.xml
                    ├── MessageMapper.xml
                    └── OperationLogMapper.xml

frontend/apps/tagtag/src/views/modules/system
├── dict
│   ├── data.ts
│   └── index.vue
├── message
│   ├── data.ts
│   └── index.vue
├── log
│   ├── data.ts
│   └── index.vue
└── storage
    ├── file
    │   ├── data.ts
    │   └── index.vue
    └── config
        ├── data.ts
        └── index.vue