performance-test/.cursor/skills/pref-web-dev/reference.md

pref-web 参考手册

devServer 代理完整列表（vue.config.js）

"/api"           → VUE_APP_APIPROXY
"/healthApi"     → VUE_APP_HEALTH_APIPROXY
"/WZLapi"        → VUE_APP_WZLAPIPROXY
"/ETLapi"        → VUE_APP_ETLAPIPROXY
"/tiles"         → VUE_APP_MAP
"/AnalysisMulti" → VUE_APP_AnalysisMultiAPIPROXY
"/transDataWeb"  → VUE_APP_WZLAPIPROXY
"/sAlgorithm"    → VUE_APP_sAlgorithmAPIPROXY
"/databaseApi"   → VUE_APP_databaseApiAPIPROXY
"/downLoadChart" → VUE_APP_downLoadChartAPIPROXY

pathRewrite 均去掉前缀后转发到 target。

healthRequest 模板

// src/utils/healthRequest.js
const HEALTH_BASE = process.env.NODE_ENV === "development"
  ? "/healthApi"
  : window?._BASE_CONFIG?.HEALTH_API || "/healthApi";

const service = axios.create({ baseURL: HEALTH_BASE, withCredentials: true });

// 拦截器：token 从 sessionStorage.vuex.auth.userInfo.token
// 404/HTML 错误：Message 提示 + reject，不 router.push

// src/api/healthAnalyse.js
export function getHealthOverview(params) {
  return healthRequest({
    url: "/energy-manage-analyse-service/healthscores/getHealthOverview",
    method: "post",
    params, // query 参数，POST 也需显式 params
  });
}

HealthHeader 默认风场逻辑

getDefaultTreeNode(treeData) {
  const root = treeData?.[0];
  return root?.children?.[0] || null;
}
// 加载树后：companyCode = defaultNode.codeNumber → emit change
// 勿用 selecttree type="1"（会选中根节点而非第一个子节点）

healthDashboardMapper 映射关系

UI 字段	API 来源
totalScore	healthscoresWindVO.overallScore
scoreDistribution / scoreSummary	excellentCount, goodCount, fairCount, poorCount
subsystemData	structureScore, systemScore, componentScore
healthyRankList	healthOverviewListVOList 按 overallScore 降序 Top5
riskRankList	同上升序 Top5
unitCards	列表项 → HealthUnitCard（含 engineId, fieldId）

下载 swagger 文档

curl "http://<host>:16880/energy-manage-analyse-service/v2/api-docs?group=2.X%E7%89%88%E6%9C%AC" \
  -o swagger.json

生产环境注意

• public/config/config.js 中 _BASE_CONFIG.API = "/api"；健康服务需运维配置 /healthApi 反向代理
• 勿在未授权时改 public/runtime-config.js、nginx、PM2

Rules vs Specs vs Skill

文件	作用	加载方式
.cursor/rules/*.mdc	每次对话自动注入的硬约束	alwaysApply
docs/AI_SPECS.md	人类/AI 详细说明	按需阅读
.cursor/skills/pref-web-dev/	开发工作流与踩坑	匹配 description 或 @ 引用