叫乘管理系统 梳理文档
本目录是对既有代码的结构化梳理，目的是为后续迭代提供统一的“地图”：知道每个业务落在哪个包/页面、数据怎么流转、接口和外部系统怎么对接、改动时应该看哪些文件。
后端：
yktgl/；前端：YktVue/，见 frontend/。 梳理基准：main分支提交135a192（2026-11-07）。
文档索引
| 文档 | 内容 | 适用场景 |
|---|---|---|
| 01-系统总览.md | 业务定位、角色、运行形态、技术栈、关键设计约束 | 新人入门、方案评审 |
| 02-工程结构与分层.md | 目录/包结构、分层约定、启动流程、公共组件 | 找代码、定落点 |
| 03-业务模块地图.md | 各业务模块职责、控制器、服务、依赖关系 | 评估改动影响面 |
| 04-核心业务流程.md | 入住、叫乘、复叫、报警、应答、离寓、房间、交路同步、卡务 | 改业务逻辑前必读 |
| 05-数据模型.md | 核心表、字段语义、状态码、归档与锁 | 写 SQL / 改表 / 排查数据 |
| 06-接口清单.md | Web 接口与设备接口清单、协议枚举 | 联调、接口扩展 |
| 07-外部集成与定时任务.md | Asterisk AMI、运安 SOAP、中心 HTTP、WebSocket、Quartz/@Scheduled | 排障、集成改造 |
| 08-部署与配置.md | Profile、数据库/Redis、资源目录、升级脚本 | 部署、环境切换 |
| 09-迭代指引与风险清单.md | 技术债、改动落点速查、待确认问题、迭代建议 | 排期、评审 |
| 10-架构优化方案-三端拆分.md | 平台端/公寓端/应用端拆分：现状评估、目标架构、职责边界、模块与数据归属、接口契约、设备接入、部署与迁移路径 | 架构评审、重构设计 |
| 11-既有数据库结构分析.md | 实测库级参数、40 表清单与规模、零主键零索引等结构缺陷、数据质量实证、表归属矩阵、类型归一与拆表建议 | 库设计评审、迁移改造 |
前端文档
前端梳理独立成册，入口见 frontend/README.md：
| 文档 | 内容 |
|---|---|
| frontend/01-前端总览与技术栈.md | 四类界面、运行拓扑、技术栈、全局变量 |
| frontend/02-工程结构与请求链路.md | 启动装配、登录守卫、axios、API 与后端映射 |
| frontend/03-路由与页面职责.md | 13 条路由、入口关系、遗留页面 |
| frontend/04-核心页面拆解-JcXx.md | 值班台布局、状态、操作、时间规则、轮询 |
| frontend/05-实时通信与语音告警.md | WebSocket/SIP、消息协议、告警与 TTS 队列 |
| frontend/06-食堂与自助终端模块.md | 自助登记、点餐/结算/后厨/保洁、选房与房间维护 |
| frontend/07-构建部署与风险清单.md | 构建、环境、部署要点、测试基线、P0/P1/P2 风险 |
建议阅读路径
- 第一次接触项目：01 → 02 → 03 → 04；再看前端 01 → 02 → 04。
- 要接一个需求：03 定位模块 → 04 看流程 → 09 查落点与风险 → 06/05 查接口和表；涉及页面时读前端 04/05。
- 线上排障：07（外部依赖/定时任务）→ 04（状态机）→ 05（数据与状态码）→ 08（配置）；前端问题读前端 05/07。
- 准备重构：02（分层）→ 09（技术债与建议）→ 10（三端拆分方案）→ 11（既有库结构分析）；前端读前端 02/04/07。
快速事实
- 后端：Spring Boot 2.6.13 + Java 8，默认 jar 打包（可改 WAR），上下文路径
/yktgl，默认端口8081。 - 数据库：KingbaseES 8（兼容 Oracle 语法），Redis 存 Session。
- 多公寓：同一套代码通过“客户端 IP → 公寓”解析
gyid，不依赖前端传参。 - 核心链路：设备/网页入寓登记 → 生成叫乘计划（Quartz 三个任务）→ 叫乘/复叫/报警/应答 → 离寓归档。
- 最大单体：后端
jcgl/service/JcglService.java（约 4192 行）；前端src/views/JcXx.vue（5294 行）。 - 前端：Vue 2.6 + Element UI，生产静态与接口同域
/yktgl；登录无真实 token，公寓gyid由后端按客户端 IP 解析。