chore: initialize application scaffold

2026-08-23 19:55:59 +08:00
parent 36088ce005
commit 6591e3fa1e
36 changed files with 7771 additions and 0 deletions
@@ -0,0 +1,13 @@
+# 架构说明
+
+## 分层职责
+
+用户请求经过 Controller 到达 Service；Service 负责业务规则并调用 Repository；Repository 仅负责 TypeORM 持久化。Entity 映射数据库表，DTO 校验请求输入。
+
+## 模块扩展
+
+新增领域模块时，在 `apps/api/src/modules` 创建独立目录，并保持 `controller`、`service`、`repository`、`dto`、`entities` 的职责边界。跨模块调用应通过导出的服务完成，不应直接访问另一模块的 Repository。
+
+## 前端划分
+
+用户端与管理端各自独立构建、部署。页面放在 `pages`，可复用业务单元放在 `components`，HTTP 调用应集中到 `api` 目录，避免把网络逻辑散落在页面中。