huike-front/CLAUDE.md

# huike-front 项目指南

## vConsole 显示规则

vConsole 仅在当前用户有 `SYS_CAN_SUDO` tag 时显示。判断逻辑在 `src/App.vue:updateVConsoleVisibility()`。

Tags 通过 `get_all_tags_of_the_user` API 异步加载（`src/store/user.ts:getTags()`），在 `setCurrentUser()` 之后执行。vConsole 的 watch 需要 `{ deep: true }` 以及独立的 `store.current.tags` watch 来覆盖异步加载完成后的触发。

## 版本号 debug 日志

`src/App.vue:onMounted()` 中有一条 `console.debug('[App.vue] deploy_ver=YYYYMMDD.NNN')`（如 `20260503.001`）。

**每次部署前必须递增这个版本号**：当天第一次部署用 `.001`，第二次用 `.002`，依此类推。跨天重置为 `.001`。这样在 vConsole 中就能精确确认小程序加载的是哪一次部署的 JS。