From b8e778ae4255ba3fc36a1cd6bcb735e29bd19eee Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Thu, 13 Aug 2026 09:25:53 +0800
Subject: [PATCH] docs: add Sense empty navigation troubleshooting (#44)

---
 Troubleshooting.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Troubleshooting.md b/Troubleshooting.md
index d59208c..88d0e49 100644
--- a/Troubleshooting.md
+++ b/Troubleshooting.md
@@ -39,6 +39,7 @@
 |---|---|
 | 启动提示缺少 `SENSE_DATABASE_URL` | 正式模式必须提供独立 PostgreSQL URL；只有测试/smoke 可显式使用 `memory`。 |
 | 登录统一提示用户名或密码错误 | 为避免枚举账户，失败响应不区分用户不存在、密码错误或账户停用；由管理员查看审计。 |
+| 管理员登录后侧栏没有模块 | 先确认 /api/v1/identity/me 返回角色与权限；若权限正常，检查前端是否从具有 children 的应用布局路由派生菜单，不得依赖重复 / 路由记录顺序。 |
 | `adapter_not_ready` | 当前设备类型尚无适配器，不代表网络故障；首期完整支持 video。 |
 | `discovery_unavailable` | 未设置获准的 `SENSE_ONVIF_DISCOVERY_IP`，或该 IP 不属于本机网卡。可改用手工 ONVIF 地址。 |
 | `authentication_failed` | 在设备管理中重新写入凭据后再次执行接入检查；不要把凭据写进地址。 |