This commit is contained in:
2025-07-16 23:32:22 +08:00
parent a68f313818
commit f49270db9c

View File

@ -110,31 +110,31 @@
| `.env.example` | 文件 | 环境变量模板,供复制为 `.env` 使用 |
| `phpunit.xml.dist` | 文件 | PHPUnit 测试配置 |
| **路径** | **类型** | **功能说明** |
|------------------------|----------|--------------------------------|
| `app/` | 文件夹 | 应用主要业务代码入口,包含以下子模块 |
| `app/Amqp/` | 文件夹 | AMQP 消息发送/消费任务类 |
| `app/Aspect/` | 文件夹 | AOP 切面逻辑(如日志、鉴权) |
| `app/Command/` | 文件夹 | CLI 自定义命令脚本 |
| `app/Constants/` | 文件夹 | 全局常量定义(状态码、消息类型等) |
| `app/Context/` | 文件夹 | 请求上下文管理(如 QID、用户信息 |
| `app/Controller/` | 文件夹 | HTTP 接口控制层 |
| `app/Dao/` | 文件夹 | 直接数据库访问层封装 |
| `app/Exception/` | 文件夹 | 自定义异常类和统一逻辑 |
| `app/Helpers/` | 文件夹 | 通用工具函数 |
| `app/Job/` | 文件夹 | 定时任务或队列任务执行类 |
| `app/JsonRpc/` | 文件夹 | JSON-RPC 接口,供硬件或外部调用 |
| `app/Listener/` | 文件夹 | 事件监听器与触发机制 |
| `app/Log/` | 文件夹 | 日志入口、格式化、QID 链路 |
| `app/Middleware/` | 文件夹 | HTTP/MQ 中间件(限流、鉴权、异常处理) |
| `app/Model/` | 文件夹 | ORM 映射层,对应数据库表 |
| `app/Process/` | 文件夹 | 自定义进程(如 Socket、守护进程 |
| **路径** | **类型** | **功能说明** |
|------------------------|----------|------------------------------|
| `app/` | 文件夹 | 应用主要业务代码入口,包含以下子模块 |
| `app/Amqp/` | 文件夹 | AMQP 消息发送/消费任务类 |
| `app/Aspect/` | 文件夹 | AOP 切面逻辑(如日志、鉴权) |
| `app/Command/` | 文件夹 | CLI 自定义命令脚本 |
| `app/Constants/` | 文件夹 | 全局常量定义(状态码、消息类型等) |
| `app/Context/` | 文件夹 | 请求上下文管理(如 QID、用户信息 |
| `app/Controller/` | 文件夹 | HTTP 接口控制层 |
| `app/Dao/` | 文件夹 | 直接数据库访问层封装 |
| `app/Exception/` | 文件夹 | 自定义异常类和统一逻辑 |
| `app/Helpers/` | 文件夹 | 通用工具函数 |
| `app/Job/` | 文件夹 | 定时任务或队列任务执行类 |
| `app/JsonRpc/` | 文件夹 | JSON-RPC 接口,供硬件或外部调用 |
| `app/Listener/` | 文件夹 | 事件监听器与触发机制 |
| `app/Log/` | 文件夹 | 日志入口、格式化、QID 链路 |
| `app/Middleware/` | 文件夹 | HTTP/MQ 中间件(限流、鉴权、异常处理) |
| `app/Model/` | 文件夹 | ORM 映射层,对应数据库表 |
| `app/Process/` | 文件夹 | 自定义进程(如 Socket、守护进程 |
| `app/Repository/` | 文件夹 | Repository 或 DAO 层,封装 Model 调用 |
| `app/Request/` | 文件夹 | 接口参数验证对象 |
| `app/Scope/` | 文件夹 | Eloquent 范畴定义global/local |
| `app/Service/` | 文件夹 | 业务逻辑层,处理 Controller 请求 |
| `app/Task/` | 文件夹 | 异步任务,配合 Scheduler 使用 |
| `app/Utils/` | 文件夹 | 独立于业务的工具逻辑封装 |
| `app/Request/` | 文件夹 | 接口参数验证对象 |
| `app/Scope/` | 文件夹 | Eloquent 范畴定义global/local |
| `app/Service/` | 文件夹 | 业务逻辑层 |
| `app/Task/` | 文件夹 | 异步任务,配合 Scheduler 使用 |
| `app/Utils/` | 文件夹 | 独立于业务的工具逻辑封装 |
- 代码调用层级Controller → Repository → Dao → Service → Model
- Repository 不直接操作 DB由 Dao 统一调用 Model