1、立项原因：业余足球和青训俱乐部的日常运营普遍依赖微信群、Excel 表格和口头通知——训练比赛靠群里刷屏接龙，出勤靠人工点数，赛事报名和赛程编排靠手工排表，家长与教练之间缺少统一渠道。信息散落在多个工具里，导致漏通知、漏报名、费用对不上、球员数据无法沉淀。本项目旨在把"建队—排期—出勤—比赛—沟通—数据"整条链路收进一个 App，让教练、队员、家长、裁判和赛事组织者在同一套系统内协作。
2、行业场景与业务背景：主要面向校园足球、青训机构和业余联赛。这类组织的特点是"人多、事杂、组织者多为兼职、预算有限"：一支球队几十号人，每周多场训练和比赛；一个杯赛可聚集数十支队伍、上百场比赛。业务上需要覆盖球队组建与入队审批、球衣号码与分组管理、日程发布与出勤签到、赛事报名审批与赛程生成、比赛计分与积分榜、赛后数据统计，以及队内动态与即时沟通。移动端是主要入口（教练在场边、家长在通勤途中），因此要求轻量、消息触达及时、弱网下仍可用
1、功能模块：系统面向七类角色（App 管理员、赛事管理员、教练、队员、家长、裁判、球迷），划分为八大模块：用户与权限、球队与名单、赛事、日程安排、出勤与签到、沟通与通知、费用记账、数据统计，移动端共 71 个页面，并配套一套管理后台。
2、主要功能：
·用户与权限：邮箱/手机注册与验证码、JWT 登录、Google/Twitter 第三方登录、RBAC 角色权限、个人资料与头像、修改密码、绑定手机邮箱。
·球队管理：建队与编辑、申请加入与教练审批、球员增删改、球队分组与分组成员、球衣号码分配、球队内角色权限、球队动态墙与点赞评论、教练查看全队比赛报表。
·赛事管理：创建赛事（循环赛/淘汰赛，4/8/16/32 队对阵模板）、队伍报名与审批、赛程自动生成、比赛实时计分与事件录入（进球/黄红牌/换人）、双视角阵容安排、实时积分榜与对阵图、赛事新闻与动态、全文搜索。
·日程与出勤：日历月视图、创建与编辑活动、Google Maps 选址与导航、出勤回复、二维码扫码签到与撤销、活动提醒。
·沟通与通知：WebSocket 群聊与私聊、图片/视频/文件消息、离线消息同步、好友申请与备注、好友实时在线状态、统一通知中心（站内信/推送/邮件/短信），FCM 与 APNs 混合推送。
·费用与统计：球队收支记账与余额汇总、球员技术统计（进球/出场/首发/黄牌/红牌/上场时间）、上场时间自动计算。
·管理后台：基于若依的 Vue3 + Element Plus 后台，管理用户、角色、字典、签到记录、推送消息与系统监控。
1、我负责的具体任务：独立完成全栈设计与开发。包括需求分析与数据库设计（38 张业务表）、后端多模块工程搭建与全部业务接口开发、Netty 实时通信模块、推送与统一通知中心、移动端页面与状态管理、管理后台，以及后期基于设计稿的全站 UI 改版。
2、技术栈与架构：移动端 UniApp + Vue 3 + Pinia，一套代码多端运行；后端 Spring Boot 2.5.15 + Spring Security + JWT + MyBatis/PageHelper + MySQL + Redis + Druid，按 admin/framework/system/common/quartz/generator/netty 七个模块拆分；管理后台 Vue3 + Element Plus；消息推送 FCM + APNs。
3、实现亮点与难点：
·实时通信：Netty 独立模块承载 WebSocket 长连接，握手阶段完成 JWT 认证，实现群聊/私聊路由、好友上下线广播与离线消息补拉；聊天记录按群分表存储，控制单表体量。
·统一通知中心：以 NotificationManager 门面 + ChannelManager 抽象四类渠道（站内信/推送/邮件/短信），站内信经 WebSocket 桥实时下发，配合定时任务扫描活动人员表触发提醒，业务侧只调用一次接口即可多渠道触达。
·赛事引擎：循环赛与 4/8/16/32 队淘汰赛赛程自动生成、对阵图渲染、比分与比赛事件联动、积分榜实时计算，球员上场时间由换人事件自动推算，替代了原先手工统计。
·工程化与体验：自研设计系统（设计令牌 + 共享样式库 + 82 个描边图标 + 悬浮胶囊式 TabBar），71 个页面统一视觉；配套骨架屏与启动页加载体系，并针对弱网做了请求重试与状态兜底。
评论