业务模块地图

前端模块

前端业务模块主要位于 web/src/modules/：

• library/：资源库、集合、标签 API 和相关页面
• pending/：待办与待处理视频建议
• account/：账号相关页面和授权入口
• profile/：个人中心
• base/：基础管理 API 与通用后台页面

另外还有插件式页面位于 web/src/plugins/west/，包括数据看板、系统配置等扩展。

页面与业务模块的大致对应关系

页面或菜单	前端入口	后端领域
素材库	web/src/modules/library/	Library / Ingest
待办	web/src/modules/pending/	Pending
标签管理	web/src/modules/tags/	Tags
广告账户	web/src/modules/account/	账户与外部授权相关领域
基础后台能力	web/src/modules/base/	权限、日志、用户等通用服务

后端领域服务

后端业务服务主要位于 app/Domain/：

• Library/：资源库与集合
• Pending/：待办和视频建议
• Script/：脚本拆解与脚本库
• Task/：成片任务、转交流程、通知与推送
• Tags/：素材、项目、视频标签
• Ingest/：资源摄入和目录管理

回头找实现时怎么定位更快

页面操作不生效

1. 看前端 api/*.ts 调用了哪个接口
2. 找控制器和请求类
3. 再追到 app/Domain/ 里的实际业务服务

只知道一个表名

1. 在 Model/ 里找对应模型
2. 在 Repository/ 找仓储
3. 再反查被哪些领域服务调用

典型阅读路径

查一个页面对应的后端实现

1. 先看 web/src/modules/**/api/*.ts
2. 再找 app/Http/Admin/Controller 或 app/Http/Api/Controller
3. 最后追到 app/Domain/* 和 app/Repository/*

查一个异步动作

1. 先看控制器或服务入口
2. 再看 app/Job/、app/Process/Queue/
3. 最后看通知、回调或网关实现