Files
archery-event-docs/05-通用基础/系统架构总览.md
2026-04-07 16:15:59 +08:00

36 lines
1.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 系统架构总览
## 1. 文档目标
说明射箭赛事平台四个代码工程之间的职责分工、调用关系与边界,作为后续系统设计和开发拆分依据。
## 2. 四个工程的定位
| 工程 | 面向对象 | 核心职责 |
| --- | --- | --- |
| 微信小程序 | 参赛用户 | 浏览赛事、报名支付、查看通知与成绩 |
| 商户后台 | 赛事主办方 | 维护赛事、处理报名、录入成绩、查看数据 |
| 管理后台 | 平台运营 | 审核商户、审核赛事、风控治理、报表统计 |
| 后台 API 服务 | 全部客户端 | 提供统一业务接口、权限控制、订单支付、成绩与消息能力 |
## 3. 推荐逻辑架构
- 展示层:微信小程序、商户后台、管理后台
- 接口层:统一后台 API
- 领域层:用户、商户、赛事、报名、订单、成绩、通知、审核
- 基础设施层:数据库、缓存、对象存储、消息通知、支付能力
## 4. 系统交互关系
1. 用户通过微信小程序调用后台 API 完成登录、报名、支付。
2. 商户后台调用后台 API 完成赛事管理、报名管理、成绩录入。
3. 管理后台调用后台 API 完成审核、运营配置、数据查询。
4. 后台 API 对接微信登录、微信支付、短信/订阅消息等第三方能力。
## 5. 设计原则
- 业务规则统一收敛在后台 API避免多端逻辑分叉。
- 商户与平台的权限边界必须清晰隔离。
- 接口设计优先稳定、可扩展、可审计。
- 文档命名与术语优先统一,便于 agent 自动续写。
## 6. 当前待定项
- 前端框架与后端语言尚未确定。
- 是否采用单体架构还是模块化服务架构待后续决策。
- 消息通知、对象存储、日志平台的具体选型待确认。