# publicdata 模块说明

> 路径：`app/publicdata/`  
> 返回主说明：[README](../../README.md)

## 1. 模块职责

- 提供项目公共数据结构与基础类型定义；
- 提供公共工具函数（时间、校验、编码、通用转换等）；
- 提供跨模块共享数据访问基础（含 `sharedatastruct`）。

## 2. 关键文件

- `publicdata.c/h`
- `public_func.c`
- `public_define.h`
- `sharedatastruct.h`
- `type.h`

## 3. 对外使用说明

- 业务模块统一通过该目录中的类型/结构做数据交换；
- 公共算法或通用转换优先放在 `public_func.c`，避免重复实现；
- 涉及全局共享结构时，需保持字段定义与实际访问一致。

## 4. 维护建议

- 新增公共结构时同步检查所有引用模块编译影响；
- 避免在该模块引入业务耦合逻辑，保持“基础层”定位。

## 5. 关联文档

- 主索引：[README](../../README.md)