---
name: zy-wcs-dev
description: 维护和开发 WCS（Spring Boot + MyBatis-Plus + Layui/Vue）项目的执行型技能。处理后端接口/服务/Mapper 与 XML 联动修改、设备线程与调度逻辑排查、前端页面与静态 JS 改动、以及本地构建与回归验证。用户提到 WCS、`com/zy` 包结构、`application.yml`、`mapper/*.xml`、`src/main/webapp/views`、设备控制线程（Crn/Rgv/Station/DualCrn）或要求“按当前项目方式改代码/排查问题”时使用。
---

# zy-wcs-dev

## Overview

在该仓库内执行改动时，优先最小变更、快速验证、明确影响范围。始终把 Java 代码、MyBatis XML、前端页面与对应静态脚本视为一个联动单元。

## Project Quick Map

- 后端入口：`src/main/java/com/zy/Boot.java`
- 核心分层：
  - `core`：设备编排、连接驱动、线程与协议
  - `asrs`：业务域、任务调度、接口控制器
  - `system`：用户权限、日志、系统配置
  - `common`：公共 web 与工具类
- 持久层：
  - Java Mapper：`src/main/java/com/zy/**/mapper/*Mapper.java`
  - SQL XML：`src/main/resources/mapper/*.xml`
- 前端：
  - 页面：`src/main/webapp/views/**`
  - 脚本：`src/main/webapp/static/js/**`
  - 样式：`src/main/webapp/static/css/**`
- 配置：`src/main/resources/application.yml`
- 构建产物：`target/wcs.war`

## Workflow

### 1. Confirm Scope

- 明确改动属于哪一层：后端接口、业务服务、设备线程、数据库映射、前端页面。
- 明确是否涉及联动文件：`Controller -> Service -> Mapper.java -> Mapper.xml -> view/js`。
- 明确是否需要兼容现有上下文路径：`/@pom.build.finalName@`（实际为 `/wcs`）。

### 2. Locate Code Precisely

- 用 `rg` 快速定位，避免盲目全量阅读：
```bash
rg -n "关键字" src/main/java src/main/resources src/main/webapp
rg --files src/main/java/com/zy | rg "Controller|Service|Mapper"
```
- 优先读取与改动直接相关的最小文件集，再扩展上下游依赖。

### 3. Implement Minimal Safe Change

#### 后端改动

- 控制器仅做参数与响应组织，核心逻辑放在 `Service`/`ServiceImpl`。
- 修改实体/字段时同步检查：
  - 实体类
  - Mapper 接口
  - 对应 XML（`resultMap`、`select/insert/update`）
- 设备相关逻辑改动时，优先检查：
  - `core/thread/**`
  - `core/network/**`
  - `core/task/**`
  - `asrs/task/**`

#### 前端改动

- 页面通常在 `views/<feature>/`，其逻辑通常在 `static/js/<feature>/`。
- 改动页面字段时同步检查后端接口字段名与 JSON 结构。
- 保持当前 Layui/Vue 代码风格，不引入重型新框架。

### 4. Validate Locally

按成本从低到高执行：

1. 编译校验：
```bash
mvn -q -DskipTests compile
```
2. 单测（若有）：
```bash
mvn test
```
3. 打包：
```bash
mvn clean package -DskipTests
```
4. 本地启动验证：
```bash
mvn spring-boot:run
```

启动后重点检查：
- 端口是否为 `9090`
- 上下文路径是否为 `/wcs`
- 日志目录是否可写：`./stock/out/wcs/logs`

### 5. High-Risk Checklist

- 不提交真实密钥/密码。`application.yml` 出现敏感值时，输出中使用脱敏占位。
- 修改 Mapper XML 后，确认 SQL 字段与实体字段映射一致，避免运行时空字段或类型错误。
- 修改调度器或线程逻辑时，确认不存在明显阻塞、死循环或共享状态竞争。
- 修改 API 时，确认前端调用路径包含上下文路径前缀（`/wcs`）。

## Response Template

执行任务后，按以下结构给出结果：

1. 先给结论：完成了什么、影响哪些模块。
2. 列出修改文件清单。
3. 说明验证命令与结果（成功/失败及原因）。
4. 若有未完成项，明确阻塞点和下一步。

## Do and Don't

- Do：优先最小改动、可回滚、可验证。
- Do：新增逻辑时保持命名和包结构一致（Controller/Service/Mapper）。
- Don't：未经要求不改动无关文件或进行大规模重构。
- Don't：未经确认不删除或替换现有设备编排主流程。