docs: 标记任务 #101 验收完成

# Conflicts:
#	docs/02-architecture-and-code-map.md

Sense/scripts/runtime/sense-common.ps1

@@ -228,7 +228,7 @@ function Initialize-SenseRuntime {
         '    enableddb: false',
         '  jwt:',
         "    secret: $(ConvertTo-SenseYamlString $jwtSecret)",
-        '    timeout: 3600',
+        '    timeout: 2592000',
         '  database:',
         '    driver: postgres',
         "    source: $(ConvertTo-SenseYamlString $databaseURL)",

Sense/server/cmd/migrate/migration/version/2026081623100_sense_layout.go

@@ -0,0 +1,85 @@
+package version
+
+import (
+	"fmt"
+	"runtime"
+
+	"gorm.io/gorm"
+
+	"git.ilapage.cn/ila/yovision/Sense/server/cmd/migrate/migration"
+	migrationModels "git.ilapage.cn/ila/yovision/Sense/server/cmd/migrate/migration/models"
+	common "git.ilapage.cn/ila/yovision/Sense/server/common/models"
+)
+
+const senseLayoutMenuName = "SenseManage"
+
+var sensePageMenus = []migrationModels.SysMenu{
+	{MenuName: "SenseDeviceManage", Title: "设备管理", Icon: "monitor", Path: "devices", MenuType: "C", Permission: "sense:device:list", Component: "/sense/device/index", Sort: 1, Visible: "0", IsFrame: "1"},
+	{MenuName: "SenseAdmission", Title: "视频接入", Icon: "video-camera", Path: "admission", MenuType: "C", Permission: "sense:admission:list", Component: "/sense/admission/index", Sort: 2, Visible: "0", IsFrame: "1"},
+	{MenuName: "SenseMedia", Title: "视频服务", Icon: "video-play", Path: "media", MenuType: "C", Permission: "sense:media:list", Component: "/sense/media/index", Sort: 3, Visible: "0", IsFrame: "1"},
+	{MenuName: "SenseLiveview", Title: "实时监看", Icon: "eye-open", Path: "liveview", MenuType: "C", Permission: "sense:liveview:view", Component: "/sense/liveview/index", Sort: 4, Visible: "0", IsFrame: "1"},
+	{MenuName: "SenseArea", Title: "区域与警戒线", Icon: "guide", Path: "area", MenuType: "C", Permission: "sense:area:list", Component: "/sense/area/index", Sort: 5, Visible: "0", IsFrame: "1"},
+}
+
+func init() {
+	_, fileName, _, _ := runtime.Caller(0)
+	migration.Migrate.SetVersion(migration.GetFilename(fileName), migrateSenseLayout)
+}
+
+func migrateSenseLayout(db *gorm.DB, version string) error {
+	return db.Transaction(func(tx *gorm.DB) error {
+		if err := alignSenseLayout(tx); err != nil {
+			return err
+		}
+		return tx.Create(&common.Migration{Version: version}).Error
+	})
+}
+
+func alignSenseLayout(tx *gorm.DB) error {
+	root, err := ensureDeviceMenu(tx, migrationModels.SysMenu{
+		MenuName:  senseLayoutMenuName,
+		Title:     "视频感知",
+		Icon:      "video-camera",
+		Path:      "/sense",
+		MenuType:  "M",
+		ParentId:  0,
+		Component: "Layout",
+		Sort:      5,
+		Visible:   "0",
+		IsFrame:   "1",
+	})
+	if err != nil {
+		return fmt.Errorf("ensure Sense layout menu: %w", err)
+	}
+
+	for _, desired := range sensePageMenus {
+		desired.ParentId = root.MenuId
+		desired.Paths = fmt.Sprintf("/0/%d", root.MenuId)
+		if _, err = ensureDeviceMenu(tx, desired); err != nil {
+			return fmt.Errorf("align Sense page menu %s: %w", desired.MenuName, err)
+		}
+	}
+
+	if err = rebuildSenseMenuPaths(tx, root.MenuId, "/0"); err != nil {
+		return err
+	}
+	return nil
+}
+
+func rebuildSenseMenuPaths(tx *gorm.DB, menuID int, parentPath string) error {
+	path := fmt.Sprintf("%s/%d", parentPath, menuID)
+	if err := tx.Model(&migrationModels.SysMenu{}).Where("menu_id = ?", menuID).Update("paths", path).Error; err != nil {
+		return fmt.Errorf("update menu %d paths: %w", menuID, err)
+	}
+
+	var children []migrationModels.SysMenu
+	if err := tx.Where("parent_id = ?", menuID).Order("sort, menu_id").Find(&children).Error; err != nil {
+		return fmt.Errorf("list children of menu %d: %w", menuID, err)
+	}
+	for _, child := range children {
+		if err := rebuildSenseMenuPaths(tx, child.MenuId, path); err != nil {
+			return err
+		}
+	}
+	return nil
+}

Sense/server/cmd/migrate/migration/version/2026081623100_sense_layout_test.go

@@ -0,0 +1,208 @@
+package version
+
+import (
+	"fmt"
+	"os"
+	"testing"
+
+	"gorm.io/driver/postgres"
+	"gorm.io/driver/sqlite"
+	"gorm.io/gorm"
+
+	migrationModels "git.ilapage.cn/ila/yovision/Sense/server/cmd/migrate/migration/models"
+	common "git.ilapage.cn/ila/yovision/Sense/server/common/models"
+)
+
+func TestAlignSenseLayoutPreservesShellAndExistingPages(t *testing.T) {
+	db := openSenseLayoutTestDB(t)
+	seedLegacySenseMenus(t, db)
+	associationsBefore := countRoleMenuAssociations(t, db)
+
+	if err := alignSenseLayout(db); err != nil {
+		t.Fatal(err)
+	}
+	// The alignment helper is intentionally idempotent because partially upgraded
+	// deployments may rerun the repair before the migration version is recorded.
+	if err := alignSenseLayout(db); err != nil {
+		t.Fatalf("repeat alignment: %v", err)
+	}
+
+	root := requireMenu(t, db, senseLayoutMenuName)
+	if root.ParentId != 0 || root.Component != "Layout" || root.Path != "/sense" || root.MenuType != "M" {
+		t.Fatalf("unexpected root menu: %#v", root)
+	}
+	if root.Paths != fmt.Sprintf("/0/%d", root.MenuId) {
+		t.Fatalf("root paths=%q", root.Paths)
+	}
+
+	for _, desired := range sensePageMenus {
+		page := requireMenu(t, db, desired.MenuName)
+		if page.ParentId != root.MenuId || page.Path != desired.Path || page.Component != desired.Component || page.Permission != desired.Permission {
+			t.Errorf("unexpected page %s: %#v", desired.MenuName, page)
+		}
+		wantPagePaths := fmt.Sprintf("/0/%d/%d", root.MenuId, page.MenuId)
+		if page.Paths != wantPagePaths {
+			t.Errorf("page %s paths=%q want %q", desired.MenuName, page.Paths, wantPagePaths)
+		}
+
+		var buttons []migrationModels.SysMenu
+		if err := db.Where("parent_id = ? AND menu_type = ?", page.MenuId, "F").Find(&buttons).Error; err != nil {
+			t.Fatal(err)
+		}
+		if len(buttons) != 1 {
+			t.Fatalf("page %s button count=%d", desired.MenuName, len(buttons))
+		}
+		wantButtonPaths := fmt.Sprintf("%s/%d", wantPagePaths, buttons[0].MenuId)
+		if buttons[0].Paths != wantButtonPaths {
+			t.Errorf("button %s paths=%q want %q", buttons[0].MenuName, buttons[0].Paths, wantButtonPaths)
+		}
+	}
+
+	var rootCount int64
+	if err := db.Model(&migrationModels.SysMenu{}).Where("menu_name = ?", senseLayoutMenuName).Count(&rootCount).Error; err != nil {
+		t.Fatal(err)
+	}
+	if rootCount != 1 {
+		t.Fatalf("Sense layout menu count=%d", rootCount)
+	}
+	if associationsAfter := countRoleMenuAssociations(t, db); associationsAfter != associationsBefore {
+		t.Fatalf("role-menu associations changed from %d to %d", associationsBefore, associationsAfter)
+	}
+}
+
+func TestMigrateSenseLayoutRollsBackWhenRequiredPageIsMissing(t *testing.T) {
+	db := openSenseLayoutTestDB(t)
+	seedLegacySenseMenus(t, db)
+	if err := db.Where("menu_name = ?", "SenseArea").Delete(&migrationModels.SysMenu{}).Error; err != nil {
+		t.Fatal(err)
+	}
+
+	// A missing page is recreated by the repair, so force a failure when the
+	// migration records its version and verify the menu transaction also rolls back.
+	version := "2026081623100"
+	if err := db.Create(&common.Migration{Version: version}).Error; err != nil {
+		t.Fatal(err)
+	}
+	if err := migrateSenseLayout(db, version); err == nil {
+		t.Fatal("expected duplicate migration version error")
+	}
+
+	var rootCount, areaCount int64
+	db.Model(&migrationModels.SysMenu{}).Where("menu_name = ?", senseLayoutMenuName).Count(&rootCount)
+	db.Model(&migrationModels.SysMenu{}).Where("menu_name = ?", "SenseArea").Count(&areaCount)
+	if rootCount != 0 || areaCount != 0 {
+		t.Fatalf("transaction left partial menus: root=%d area=%d", rootCount, areaCount)
+	}
+}
+
+func openSenseLayoutTestDB(t *testing.T) *gorm.DB {
+	t.Helper()
+	db, err := gorm.Open(sqlite.Open("file:"+t.Name()+"?mode=memory&cache=shared"), &gorm.Config{})
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err = db.AutoMigrate(&migrationModels.SysRole{}, &migrationModels.SysMenu{}, &common.Migration{}); err != nil {
+		t.Fatal(err)
+	}
+	return db
+}
+
+func TestSenseLayoutMigrationOnPostgres(t *testing.T) {
+	dsn := os.Getenv("SENSE_LAYOUT_MIGRATION_TEST_DATABASE_URL")
+	if dsn == "" {
+		t.Skip("set SENSE_LAYOUT_MIGRATION_TEST_DATABASE_URL to run the PostgreSQL migration test")
+	}
+	db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{})
+	if err != nil {
+		t.Fatal(err)
+	}
+	const schema = "sense_layout_101_test"
+	if err = db.Exec("DROP SCHEMA IF EXISTS " + schema + " CASCADE").Error; err != nil {
+		t.Fatal(err)
+	}
+	if err = db.Exec("CREATE SCHEMA " + schema).Error; err != nil {
+		t.Fatal(err)
+	}
+	t.Cleanup(func() { db.Exec("DROP SCHEMA IF EXISTS " + schema + " CASCADE") })
+	sqlDB, err := db.DB()
+	if err != nil {
+		t.Fatal(err)
+	}
+	sqlDB.SetMaxOpenConns(1)
+	if err = db.Exec("SET search_path TO " + schema).Error; err != nil {
+		t.Fatal(err)
+	}
+	if err = db.AutoMigrate(&migrationModels.SysRole{}, &migrationModels.SysMenu{}, &common.Migration{}); err != nil {
+		t.Fatal(err)
+	}
+	seedLegacySenseMenus(t, db)
+
+	const version = "2026081623100"
+	if err = migrateSenseLayout(db, version); err != nil {
+		t.Fatal(err)
+	}
+	root := requireMenu(t, db, senseLayoutMenuName)
+	if root.Component != "Layout" || root.Path != "/sense" {
+		t.Fatalf("unexpected PostgreSQL root: %#v", root)
+	}
+	var pages, versions int64
+	db.Model(&migrationModels.SysMenu{}).Where("parent_id = ? AND menu_type = ?", root.MenuId, "C").Count(&pages)
+	db.Model(&common.Migration{}).Where("version = ?", version).Count(&versions)
+	if pages != int64(len(sensePageMenus)) || versions != 1 {
+		t.Fatalf("pages=%d versions=%d", pages, versions)
+	}
+}
+
+func seedLegacySenseMenus(t *testing.T, db *gorm.DB) {
+	t.Helper()
+	role := migrationModels.SysRole{RoleName: "site_admin", RoleKey: "site_admin", Status: "2"}
+	if err := db.Create(&role).Error; err != nil {
+		t.Fatal(err)
+	}
+	assigned := make([]migrationModels.SysMenu, 0, len(sensePageMenus)*2)
+	for index, desired := range sensePageMenus {
+		legacy := desired
+		legacy.Path = "/sense/" + desired.Path
+		legacy.ParentId = 0
+		legacy.Sort = index + 5
+		legacy.Paths = ""
+		if err := db.Create(&legacy).Error; err != nil {
+			t.Fatal(err)
+		}
+		button := migrationModels.SysMenu{
+			MenuName:   desired.MenuName + "Action",
+			Title:      "测试操作",
+			MenuType:   "F",
+			Permission: desired.Permission + ":action",
+			ParentId:   legacy.MenuId,
+			Paths:      fmt.Sprintf("/0/%d", legacy.MenuId),
+			Visible:    "1",
+			IsFrame:    "1",
+		}
+		if err := db.Create(&button).Error; err != nil {
+			t.Fatal(err)
+		}
+		assigned = append(assigned, legacy, button)
+	}
+	if err := db.Model(&role).Association("SysMenu").Append(assigned); err != nil {
+		t.Fatal(err)
+	}
+}
+
+func countRoleMenuAssociations(t *testing.T, db *gorm.DB) int64 {
+	t.Helper()
+	var count int64
+	if err := db.Table("sys_role_menu").Count(&count).Error; err != nil {
+		t.Fatal(err)
+	}
+	return count
+}
+
+func requireMenu(t *testing.T, db *gorm.DB, name string) migrationModels.SysMenu {
+	t.Helper()
+	var menu migrationModels.SysMenu
+	if err := db.Where("menu_name = ?", name).First(&menu).Error; err != nil {
+		t.Fatal(err)
+	}
+	return menu
+}

Sense/server/common/middleware/auth.go

@@ -8,16 +8,11 @@ import (
 	jwt "github.com/go-admin-team/go-admin-core/sdk/pkg/jwtauth"
 )
 
+const defaultLoginValidity = 30 * 24 * time.Hour
+
 // AuthInit jwt验证new
 func AuthInit() (*jwt.GinJWTMiddleware, error) {
-	timeout := time.Hour
-	if config.ApplicationConfig.Mode == "dev" {
-		timeout = time.Duration(876010) * time.Hour
-	} else {
-		if config.JwtConfig.Timeout != 0 {
-			timeout = time.Duration(config.JwtConfig.Timeout) * time.Second
-		}
-	}
+	timeout := resolveJWTTimeout(config.ApplicationConfig.Mode, config.JwtConfig.Timeout)
 	return jwt.New(&jwt.GinJWTMiddleware{
 		Realm:           "Sense",
 		Key:             []byte(config.JwtConfig.Secret),
@@ -34,3 +29,13 @@ func AuthInit() (*jwt.GinJWTMiddleware, error) {
 	})
 
 }
+
+func resolveJWTTimeout(mode string, configuredSeconds int64) time.Duration {
+	if mode == "dev" {
+		return time.Duration(876010) * time.Hour
+	}
+	if configuredSeconds > 0 {
+		return time.Duration(configuredSeconds) * time.Second
+	}
+	return defaultLoginValidity
+}

Sense/server/common/middleware/auth_test.go

@@ -0,0 +1,57 @@
+package middleware
+
+import (
+	"testing"
+	"time"
+
+	"github.com/go-admin-team/go-admin-core/sdk/config"
+)
+
+func TestResolveJWTTimeoutDefaultsToThirtyDays(t *testing.T) {
+	for _, mode := range []string{"prod", "test", "demo"} {
+		if got := resolveJWTTimeout(mode, 0); got != 30*24*time.Hour {
+			t.Errorf("mode %s timeout=%s, want 720h", mode, got)
+		}
+	}
+}
+
+func TestResolveJWTTimeoutHonorsExplicitConfiguration(t *testing.T) {
+	if got := resolveJWTTimeout("prod", 3600); got != time.Hour {
+		t.Fatalf("timeout=%s, want 1h", got)
+	}
+}
+
+func TestResolveJWTTimeoutKeepsUpstreamDevelopmentBehavior(t *testing.T) {
+	if got := resolveJWTTimeout("dev", 1); got != 876010*time.Hour {
+		t.Fatalf("development timeout=%s", got)
+	}
+}
+
+func TestAuthInitSignsTokenExpiringAfterThirtyDays(t *testing.T) {
+	oldMode := config.ApplicationConfig.Mode
+	oldTimeout := config.JwtConfig.Timeout
+	oldSecret := config.JwtConfig.Secret
+	t.Cleanup(func() {
+		config.ApplicationConfig.Mode = oldMode
+		config.JwtConfig.Timeout = oldTimeout
+		config.JwtConfig.Secret = oldSecret
+	})
+
+	config.ApplicationConfig.Mode = "prod"
+	config.JwtConfig.Timeout = 0
+	config.JwtConfig.Secret = "task-104-test-secret-not-for-production"
+
+	auth, err := AuthInit()
+	if err != nil {
+		t.Fatal(err)
+	}
+	now := time.Date(2026, 8, 17, 10, 0, 0, 0, time.UTC)
+	auth.TimeFunc = func() time.Time { return now }
+	_, expiresAt, err := auth.TokenGenerator(map[string]interface{}{})
+	if err != nil {
+		t.Fatal(err)
+	}
+	if got := expiresAt.Sub(now); got != 30*24*time.Hour {
+		t.Fatalf("signed token validity=%s, want 720h", got)
+	}
+}

Sense/server/config/READMEN.md

@@ -20,7 +20,7 @@ settings:
     # JWT加密字符串
     secret: ""
     # 过期时间单位：秒
-    timeout: 3600
+    timeout: 2592000
   database:
     # 数据库名称
     name: dbname 

Sense/server/config/settings.demo.yml

@@ -16,7 +16,7 @@ settings:
     frontpath: ../ui/src
   jwt:
     secret: ""
-    timeout: 3600
+    timeout: 2592000
   logger:
     # 日志存放路径
     path: temp/logs

Sense/server/config/settings.full.yml

@@ -34,7 +34,7 @@ settings:
     # token 密钥，生产环境时及的修改
     secret: ""
     # token 过期时间 单位：秒
-    timeout: 3600
+    timeout: 2592000
   database:
     # Sense 仅支持 PostgreSQL；连接信息由仓库外配置提供。
     driver: postgres

Sense/server/config/settings.sqlite.yml

@@ -25,7 +25,7 @@ settings:
     # token 密钥，生产环境时及的修改
     secret: ""
     # token 过期时间 单位：秒
-    timeout: 3600
+    timeout: 2592000
   database:
     # 文件名为上游兼容名称；Sense 仍只支持 PostgreSQL。
     driver: postgres

Sense/server/config/settings.yml

@@ -25,7 +25,7 @@ settings:
     # 必填。生产环境至少 32 个字符；不得提交真实值。
     secret: ""
     # token 过期时间 单位：秒
-    timeout: 3600
+    timeout: 2592000
   database:
     # 数据库类型 mysql, sqlite3, postgres, sqlserver
     # sqlserver: sqlserver://用户名:密码@地址?database=数据库名

Sense/tests/package/run-tests.ps1

@@ -65,6 +65,7 @@ try {
     Assert-Equal 18071 $state.Port 'non-empty process environment must override sense.env'
     Assert-True (-not (Test-Path -LiteralPath $marker)) 'sense.env content must never execute'
     $generatedSettings = Get-Content -LiteralPath $state.SettingsPath -Raw
+    Assert-True $generatedSettings.Contains('timeout: 2592000') 'generated runtime settings must keep login valid for 30 days'
     Assert-True ((Get-SenseEnvironmentValue -Name 'SENSE_DATABASE_URL').Contains('p#&;=x')) 'special characters must survive env parsing'
     Assert-True ($generatedSettings.Contains('password=p#\u0026;=x')) 'special characters must be safely JSON-escaped in YAML'
     Assert-True (-not ((Get-SenseDatabaseInfo (Get-SenseEnvironmentValue -Name 'SENSE_DATABASE_URL')).Sanitized.Contains('password='))) 'PostgreSQL tool arguments must not contain password'

Sense/ui/src/utils/auth.js

@@ -1,13 +1,14 @@
 import Cookies from 'js-cookie'
 
 const TokenKey = 'Sense-Admin-Token'
+const LoginValidityDays = 30
 
 export function getToken() {
   return Cookies.get(TokenKey)
 }
 
 export function setToken(token) {
-  return Cookies.set(TokenKey, token)
+  return Cookies.set(TokenKey, token, { expires: LoginValidityDays })
 }
 
 export function removeToken() {

Sense/ui/tests/unit/utils/auth.spec.js

@@ -0,0 +1,32 @@
+import Cookies from 'js-cookie'
+import { getToken, removeToken, setToken } from '@/utils/auth'
+
+jest.mock('js-cookie', () => ({
+  get: jest.fn(),
+  set: jest.fn(),
+  remove: jest.fn()
+}))
+
+describe('Sense login token cookie', () => {
+  beforeEach(() => {
+    jest.clearAllMocks()
+  })
+
+  it('persists the token for 30 days', () => {
+    setToken('test-token')
+
+    expect(Cookies.set).toHaveBeenCalledWith(
+      'Sense-Admin-Token',
+      'test-token',
+      { expires: 30 }
+    )
+  })
+
+  it('reads and removes the same product-specific cookie', () => {
+    getToken()
+    removeToken()
+
+    expect(Cookies.get).toHaveBeenCalledWith('Sense-Admin-Token')
+    expect(Cookies.remove).toHaveBeenCalledWith('Sense-Admin-Token')
+  })
+})

docs/02-architecture-and-code-map.md

@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Architecture-and-Code-Map
 wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Architecture-and-Code-Map.-
-wiki_revision: 5cbaa178193811083519c5125febf8cc962c94ee
-synchronized_at: 2026-08-16T11:45:49Z
+wiki_revision: 8df12aa3e136b1faee9c2dffb58ca39b045bc49f
+synchronized_at: 2026-08-17T02:54:44Z
 <!-- gitea-wiki-mirror:end -->
 
 # 架构与代码地图
@@ -85,9 +85,11 @@ Sense/Brain 生成事件
 
 Sense 已由工单 #61 从冻结 go-admin/go-admin-ui 源码建立：后端入口为 `Sense/server/main.go`，前端入口为 `Sense/ui/src/main.js`，来源和完整 commit 记录在 `Sense/LICENSES/SOURCES.md`。后端保留 Cobra、Gin、GORM、Casbin、JWT 和迁移体系，前端保留 Router、Store、API、Layout、动态菜单与权限指令。上游作业、代码生成、监控等源码暂留用于升级追溯，但路由及用户入口不启用。
 
+Sense 业务菜单必须遵循冻结 GoAdmin 的路由树：顶层目录使用 `MenuType=M`、`Component=Layout`，设备管理、视频接入、视频服务、实时监看、区域与警戒线使用相对路径作为 `MenuType=C` 子页面，操作权限继续作为页面下的 `MenuType=F` 节点。这样动态路由只替换 Layout 的右侧内容区，左侧导航、顶部栏和标签页始终保留；旧数据库由 `Sense/server/cmd/migrate/migration/version/2026081623100_sense_layout.go` 新增迁移修正父子关系和完整 `paths`，页面 URL 与权限标识不变。
+
 工单 #64 在该基线上重建 Sense 独立身份能力：`Sense/server/app/admin/apis/identity_bootstrap.go` 提供受外部高熵令牌保护的一次性首位管理员初始化，数据库迁移固定建立 `admin`、`implementation_operator`、`site_admin`、`viewer` 四个角色及最小 Casbin 权限；前端继续复用 go-admin-ui 动态菜单、权限按钮、请求封装与 Layout。仓库仍不提供默认账号、默认密码或可用 JWT 密钥。
 
-Sense JWT realm 固定为 `Sense`；浏览器令牌 Cookie 为 `Sense-Admin-Token`，后端仅接受标准 Authorization Bearer 或独立的 `sense_session` Cookie，不接受查询参数令牌，也不得与 Bell 共享 JWT 密钥、Cookie 或账户库。登录成功/失败、登出、密码变更和鉴权拒绝写入身份审计；审计内容必须剔除密码、令牌、Cookie、验证码和其他秘密。配置管理 CRUD、configKey、set-config、接口管理等非产品必要路由不注册，即使管理员直接调用也返回 404。登录外壳必需的匿名只读 `GET /api/v1/app-config` 是唯一例外：它复用 GoAdmin `SysConfig.Get2SysApp`，只投影标记为前端可见的配置，不提供写入或管理能力。
+Sense JWT realm 固定为 `Sense`；浏览器令牌 Cookie 为 `Sense-Admin-Token`，后端仅接受标准 Authorization Bearer 或独立的 `sense_session` Cookie，不接受查询参数令牌，也不得与 Bell 共享 JWT 密钥、Cookie 或账户库。Sense 默认登录有效期为固定 30 天：后端 JWT 使用 2,592,000 秒，前端 Token Cookie 使用 30 天持久化期限；不做滑动续期、Refresh Token 或服务端单 Token 撤销，退出只删除本机 Cookie。部署新版本后已有 Token 不会自动延长，用户必须重新登录取得新有效期。登录成功/失败、登出、密码变更和鉴权拒绝写入身份审计；审计内容必须剔除密码、令牌、Cookie、验证码和其他秘密。配置管理 CRUD、configKey、set-config、接口管理等非产品必要路由不注册，即使管理员直接调用也返回 404。登录外壳必需的匿名只读 `GET /api/v1/app-config` 是唯一例外：它复用 GoAdmin `SysConfig.Get2SysApp`，只投影标记为前端可见的配置，不提供写入或管理能力。
 
 工单 #65 新增设备台账入口：后端按 `models → dto → service → api → router` 分层位于 `Sense/server/app/sense/device/`，管理路由在 `Sense/server/app/admin/router/sense_device.go`，前端页面位于 `Sense/ui/src/views/sense/device/index.vue`。设备凭据由 `Sense/server/app/sense/credential/` 独立存储和 AES-256-GCM 加密，HTTP 只返回是否已配置，不提供凭据读取接口。
 

docs/04-local-development-and-verification.md

@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Local-Development-and-Verification
 wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Local-Development-and-Verification.-
-wiki_revision: ee4819a84dd40846bc8fe1865e08590e1cf9cb81
-synchronized_at: 2026-08-15T09:58:37Z
+wiki_revision: 84a086640dc3618e43f834c488080f1e0cb5b063
+synchronized_at: 2026-08-17T02:54:49Z
 <!-- gitea-wiki-mirror:end -->
 
 # 本地开发与验证
@@ -148,6 +148,8 @@ Remove-Variable bootstrapToken, bootstrapBody
 
 初始化成功后停止服务，从启动环境中执行 `Remove-Item Env:SENSE_BOOTSTRAP_TOKEN`，再按正常生产方式启动。已有任一用户时初始化接口会拒绝请求。Sense 在 production、test、dev 模式均只提交账号和密码，不显示、不请求也不校验验证码；`/api/v1/captcha` 暂时保留作上游兼容接口，但登录页和登录 API 不依赖它。登录成功、错误密码和未认证拒绝仍必须写入脱敏身份审计，密码继续执行 6–72 字节策略。
 
+Sense 默认登录有效期为固定 30 天。仓库配置和 Windows 运行脚本生成的 `jwt.timeout` 均为 `2592000` 秒，前端 `Sense-Admin-Token` Cookie 使用 30 天持久化期限。更新该版本后必须重新登录，已有 Token 不会自动延长。该有效期不是滑动续期；退出登录会删除本机 Cookie，但当前无状态 JWT 架构不提供服务端单 Token 撤销。如需立即使全部已签发 Token 失效，应在受控维护窗口轮换仓库外 JWT secret，并明确通知所有用户重新登录。
+
 身份回归至少覆盖：admin 可管理账户及查看审计；implementation_operator 只能查看实施所需日志和字典支撑数据；site_admin 可维护账户并读取角色、部门、岗位、字典，但不能修改角色或菜单；viewer 不能访问管理接口。还要验证配置/接口管理路由返回 404、短密码被拒绝、6 位全小写密码可用，以及登录/登出/改密/拒绝审计中不含密码、令牌、Cookie 或验证码。身份审计直接写入 PostgreSQL，不依赖通用操作日志数据库开关。
 
 详细来源与安全约束见 `Sense/LICENSES/SOURCES.md` 和 `Sense/README.md`。

docs/09-product-requirements.md

@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Product-Requirements
 wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Product-Requirements.-
-wiki_revision: 221fd392c943caab13ee097c19a3d19d4410b65a
-synchronized_at: 2026-08-15T09:59:15Z
+wiki_revision: e6c6e0d7f658a7c1040fe569026e7d0ec581701a
+synchronized_at: 2026-08-17T02:54:53Z
 <!-- gitea-wiki-mirror:end -->
 
 # 产品需求
@@ -48,7 +48,7 @@ YoVision 首个可交付目标是在民办寄宿学校以默认 16 路高风险
 
 ### P0
 
-- **SEN-001 独立登录与权限**：Sense 自有用户、角色、菜单、会话和审计；至少覆盖管理员、实施/运维、站点管理员和只读边界。首期采用账号密码直接登录，所有运行模式均不使用验证码；密码保持 6–72 字节且不强制字符复杂度，登录成功与失败必须记录不含秘密的身份审计。
+- **SEN-001 独立登录与权限**：Sense 自有用户、角色、菜单、会话和审计；至少覆盖管理员、实施/运维、站点管理员和只读边界。首期采用账号密码直接登录，所有运行模式均不使用验证码；密码保持 6–72 字节且不强制字符复杂度，登录成功与失败必须记录不含秘密的身份审计。默认登录有效期为固定 30 天，后端 JWT 与浏览器持久 Cookie 必须一致；版本更新后已有 Token 不自动延长，不提供滑动续期或服务端单 Token 撤销。
 - **SEN-002 设备台账**：以 Device 为根实体，通过 `modality` 和 `capabilities` 表达 video/radar/contact/button/wearable/other；首期只完整实现 video，未实现适配器显示 `adapter_not_ready`。
 - **SEN-003 ONVIF/RTSP 接入**：支持发现或手工添加、Profiles、StreamUri、主/子码流、校时、认证失败、重新探测和凭据更新。
 - **SEN-004 批量开通**：默认 16 路可导入、预校验、待激活、逐项成功/失败、仅重试失败项；部分成功不做整体回滚。

docs/task/101-Sense-GoAdmin-应用外壳.md

@@ -0,0 +1,107 @@
+<!-- gitea-wiki-mirror:start -->
+generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
+wiki_page: Task-101-Sense-GoAdmin-应用外壳
+wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Task-101-Sense-GoAdmin-%E5%BA%94%E7%94%A8%E5%A4%96%E5%A3%B3.-
+wiki_revision: a32fd29a7b8c4fa42396e9f249bcdd99d0c09e74
+synchronized_at: 2026-08-27T07:52:48Z
+<!-- gitea-wiki-mirror:end -->
+
+# 101 Sense-GoAdmin-应用外壳
+
+- 类型：缺陷修复
+- 所属 Epic：#7
+- 所属 MVP / 版本：#8 / Sense 首个独立纵切
+- 状态：已完成
+- 日期：2026-08-16
+- Gitea 工单：https://git.ilapage.cn/ila/yovision/issues/101
+- Wiki 页面：Task-101-Sense-GoAdmin-应用外壳
+- Wiki revision：见本地镜像头
+
+## 背景与目标
+
+Sense 五个业务菜单原来都以顶层业务组件注册。go-admin-ui 只有在动态路由组件为 `Layout` 时才保留侧栏、顶部导航和标签页，因此点击设备管理等入口会用业务页面替换整个 GoAdmin 外壳。
+
+本任务恢复冻结 GoAdmin 的标准父子菜单结构：应用外壳保持不变，模块切换只替换右侧内容区域。
+
+## 最终方案
+
+新增迁移 `2026081623100_sense_layout.go`，创建唯一的“视频感知”顶层目录：
+
+- 顶层目录：`MenuType=M`、`Path=/sense`、`Component=Layout`。
+- 设备管理、视频接入、视频服务、实时监看、区域与警戒线：作为相对路径的 `MenuType=C` 子页面。
+- 页面下既有 `MenuType=F` 操作权限保持不变。
+- 递归重算父目录、页面和按钮的完整 `paths`。
+- 页面 URL、组件、权限标识、角色关联和业务 API 均不改变。
+- 使用新增事务迁移兼容已经执行旧迁移的 PostgreSQL 数据库，不修改历史迁移。
+
+与建单方案一致，没有修改 go-admin-ui 公共 Layout 或动态路由生成器。
+
+## 修改文件
+
+- `Sense/server/cmd/migrate/migration/version/2026081623100_sense_layout.go`：新增 GoAdmin Layout 菜单兼容迁移。
+- `Sense/server/cmd/migrate/migration/version/2026081623100_sense_layout_test.go`：覆盖菜单层级、相对路径、完整 paths、角色关联保持、重复对齐、事务回滚和 PostgreSQL。
+- `docs/02-architecture-and-code-map.md`：同步架构 Wiki 中的 Sense 动态菜单长期规则。
+- `wiki-docs.json`、`docs/task/101-Sense-GoAdmin-应用外壳.md`：任务归档映射与镜像。
+
+## 验收结果
+
+| 验收标准 | 结果 |
+|---|---|
+| 五个业务页位于 Layout 父路由下 | 通过 |
+| 设备管理进入 `#/sense/devices`，标题与路径不串位 | 通过 |
+| 切换和刷新后侧栏、顶部栏、标签页保留 | 通过 |
+| 页面组件、权限标识和角色关联保持 | 通过 |
+| 已有 PostgreSQL 数据库迁移无重复菜单 | 通过 |
+| 重复对齐安全、失败事务回滚 | 通过 |
+| 后端、前端和 Windows 包验证 | 通过 |
+| Wiki、归档、PR 和证据 | 通过，用户已验收 |
+
+## 测试
+
+- `go test ./cmd/migrate/migration/version -run 'Test(AlignSenseLayout|MigrateSenseLayout|SenseLayout)' -count=1`：通过。
+- 真实 PostgreSQL 隔离 schema `TestSenseLayoutMigrationOnPostgres`：通过并清理测试 schema。
+- `go test ./...`：通过。
+- `go vet ./...`、后端构建：通过。
+- `pnpm lint`：0 error，32 条冻结上游/既有 warning。
+- `pnpm test:unit -- --runInBand`：17 suites、46 tests 全部通过。
+- `pnpm build:prod`：通过，4 条既有构建 warning。
+- Windows PowerShell 5.1 包测试：21 assertions 通过；包审计通过。
+- 本机生产数据库迁移及启动：通过。
+- Headless Edge：依次打开五个菜单及刷新区域页面，`.app-wrapper`、侧栏、navbar、TagsView 全程可见，URL 均正确。
+- Windows ZIP：`Sense/dist/sense-windows-amd64.zip`，SHA-256 `BAAA973F8502BB5B0BC080F11931E60419B25EFA8FF722A6B9F9B98364399642`，源码提交 `4423d528b1dc6ebe8b6f7b8272ca5111032a1608`。
+- **未验证部分**：客户全新 Windows 主机及 implementation_operator/site_admin/viewer 三种岗位的人工视觉验收；本机使用 admin 完成真实浏览器回归，用户已确认验收通过。
+
+## 遗留问题
+
+#99、#104 与 #101 均已由用户验收；#101 经 PR #102 合入 `dev`，`main` 保持不变。#90 的项目档案 Wiki 更新未混入本任务提交；客户全新 Windows 主机及三个非 admin 岗位的人工视觉验收仍未覆盖。
+
+## 相关提交
+
+- `4423d528b1dc6ebe8b6f7b8272ca5111032a1608` 修复 Sense GoAdmin 应用外壳。
+- `e652109` 记录 Sense Layout 菜单长期架构。
+
+## #99 合入后的组合验收包
+
+- 用户验收 #99 后，PR #100 已合入 `dev`；本任务分支通过合并提交 `42dc77b1f904032131c51b3864184c4ccaea6b8f` 更新到该基线。
+- 冲突处理保留 Wiki 事实源中 #99 的匿名只读 `app-config` 边界、#101 的 GoAdmin Layout 菜单规则，以及两张任务归档映射。
+- 重新生成 `Sense/dist/sense-windows-amd64.zip`；包内 `source_commit=42dc77b1f904032131c51b3864184c4ccaea6b8f`。
+- 新 ZIP SHA-256：`65AF5DD1CFB5D4F8339DCCC53717354495259F13630FBC0C6A4AFC1ACD794B26`。
+- 固定工具链 production build、包审计、Windows PowerShell 5.1 包测试 21 项、真实 PostgreSQL 迁移/启动及 `TestRegisterBaseRouterExposesOnlyFrontendAppConfig` 均通过。
+- 现场配置在构建前备份、ZIP 生成后恢复；ZIP 仍只包含模板配置。Sense 当前监听 `127.0.0.1:18080`。
+## #104 合入后的最终组合验收包
+
+- #104 已由用户验收并经 PR #105 合入 `dev@46c3232da40528d031367225b09d4f28c85a8312`；#101 分支通过合并提交 `8cdd3f61cbd8f5bbc1a972525da91aaf49a39bb0` 更新到该基线。
+- 唯一合并冲突是 `Architecture-and-Code-Map` 镜像头；读取 Wiki revision `8df12aa3e136b1faee9c2dffb58ca39b045bc49f` 确认页面同时包含 #101 Layout 菜单规则和 #104 30 天登录规则后，以该事实源解决。业务代码无冲突。
+- `go test ./...`、`go vet ./...`、`go build ./...` 全部通过；前端 lint 0 error（32 条既有 warning），18 suites / 48 tests 通过，production build 通过（4 条既有 warning）。
+- Windows 包资源审计、包审计和 22 assertions 通过；使用现场 PostgreSQL 完成幂等迁移与生产启动，`data/runtime/settings.yml` 确认 `timeout: 2592000`。
+- Chrome 真实回归依次验证设备管理、视频接入、视频服务、实时监看、区域与警戒线五个入口；URL 分别为 `#/sense/devices`、`#/sense/admission`、`#/sense/media`、`#/sense/liveview`、`#/sense/area`，侧栏、Navbar、TagsView 全程可见。直接刷新区域页面后外壳与选中标签保持，控制台无错误。
+- 本机直连验证 `/health`、`/api/v1/app-config` 和 `/` 均返回 200；首次命令行请求受开发机 HTTP 代理影响，明确绕过代理后通过，不属于 Sense 服务错误。
+- 组合 ZIP：`Sense/dist/sense-windows-amd64-101-104.zip`，56,461,005 bytes，SHA-256 `46B2B5654EE3F61788CA4E51F5CB66C1A7C7D1088EFFD39C0281E86E84F964A2`，包内 `source_commit=8cdd3f61cbd8f5bbc1a972525da91aaf49a39bb0`。标准 ZIP 内容相同且仅含模板配置；现场配置只恢复到解压目录。
+- 当前组合服务监听 `127.0.0.1:18080`。临时现场配置备份已删除，源码目录 `node_modules` 已清理。
+- **未验证部分**：客户全新 Windows 主机及 implementation_operator/site_admin/viewer 三种岗位的人工视觉验收；用户已确认当前交付验收通过。
+
+## 验收确认
+
+- 2026-08-27，用户明确确认“#101通过验收”。
+- PR #102 按规定合入 `dev`，`main` 未变更。
+- 工单 #101 状态更新为“已完成”并关闭；所属 MVP #8 的子工单索引同步勾选。

docs/task/104-Sense-30天登录有效期.md

@@ -0,0 +1,80 @@
+<!-- gitea-wiki-mirror:start -->
+generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
+wiki_page: Task-104-Sense-30天登录有效期
+wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Task-104-Sense-30%E5%A4%A9%E7%99%BB%E5%BD%95%E6%9C%89%E6%95%88%E6%9C%9F.-
+wiki_revision: 2b4df23ec321de868840da61d87d8d6fce8537a7
+synchronized_at: 2026-08-17T03:46:13Z
+<!-- gitea-wiki-mirror:end -->
+
+# 104 Sense-30天登录有效期
+
+- 类型：需求
+- 所属 Epic：#7
+- 所属 MVP / 版本：#8
+- 状态：已完成
+- 日期：2026-08-17
+- Gitea 工单：https://git.ilapage.cn/ila/yovision/issues/104
+- Wiki 页面：Task-104-Sense-30天登录有效期
+- Wiki revision：见本地镜像头
+
+## 背景与目标
+
+Sense 原生产、demo、SQLite 和完整配置默认 JWT 有效期为 3600 秒，前端 Token 使用浏览器会话 Cookie。按用户确认，将默认登录有效期统一调整为固定 30 天，使浏览器重启后在 Token 未过期时仍可保持登录。
+
+## 最终方案
+
+- 保留 go-admin JWT 中间件和 go-admin-ui `js-cookie` 封装；非开发模式未显式配置时默认使用 30 天，合法显式配置仍优先，开发模式保持上游行为。
+- 生产、demo、SQLite、full 与 Windows 运行时生成配置统一使用 2,592,000 秒。
+- `Sense-Admin-Token` Cookie 使用 `expires: 30`；退出登录仍删除 Cookie。
+- 不是滑动续期，不增加 Refresh Token、服务端会话表或 Token 黑名单。已有 Token 不自动延长，部署后需重新登录。
+- Token 泄露窗口扩大到 30 天；紧急失效需要轮换 JWT secret，这会使全部现有登录失效。
+
+## 修改文件
+
+- `Sense/server/common/middleware/auth.go`、`auth_test.go`：实现并验证默认 30 天 JWT。
+- `Sense/server/config/settings*.yml`、`READMEN.md`：统一配置值和示例。
+- `Sense/scripts/runtime/sense-common.ps1`、`Sense/tests/package/run-tests.ps1`：统一并验证 Windows 运行时配置。
+- `Sense/ui/src/utils/auth.js`、`Sense/ui/tests/unit/utils/auth.spec.js`：持久化 Cookie 30 天并验证设置、读取和删除。
+- `docs/02-architecture-and-code-map.md`、`docs/04-local-development-and-verification.md`、`docs/09-product-requirements.md`：由 Wiki 同步的长期文档镜像。
+
+## 验收结果
+
+| 验收标准 | 结果 |
+|---|---|
+| 非开发模式签发 JWT 的到期时间为签发后 30 天 | 通过 |
+| Token Cookie 使用 30 天持久化期限，退出仍删除 | 通过 |
+| 浏览器关闭后重新打开仍保持登录 | 通过（用户验收） |
+| 所有运行配置及 Windows 生成值为 2,592,000 秒 | 通过 |
+| Go、Vue、Windows 包测试与 PostgreSQL 启动回归 | 通过 |
+| ZIP 仅含模板配置，不包含现场秘密或数据 | 通过 |
+| 已有 Token 不自动延长并记录重新登录要求 | 通过 |
+
+## 测试
+
+- `go test ./...`：通过。
+- `go vet ./...`：通过。
+- `go build ./...`：通过。
+- `pnpm run lint`：0 error，32 条上游既有 warning。
+- `pnpm exec vue-cli-service test:unit --runInBand`：18 suites、48 tests 通过。
+- `Sense/tests/package/run-tests.bat -PackageRoot Sense/dist/sense-windows-amd64`：22 assertions 通过。
+- Windows amd64 生产构建、资源审计、包审计：通过；4 条既有构建 warning。
+- 独立 #104 包使用现场 PostgreSQL 完成迁移和启动，`127.0.0.1:18080` 监听成功，生成配置确认 `timeout: 2592000`。
+- 包：`Sense/dist/sense-windows-amd64-104.zip`，56,457,546 bytes，SHA-256 `BCE3EDD3F5BD79C75A953CB7673D1C9867CE3BB89755D6A188C7CA1226D05CE3`，来源提交 `adc227f110bf0c456d1523eac151ed1d8360cc83`。
+- 一次错误的 Vue 测试参数把 `--runInBand` 识别为模式而未找到测试，已改用正确命令并通过；一次临时运行数据恢复把日志目录复制成同名文件，修正验证环境后从失败点重试并通过，均非产品代码缺陷。
+- **未验证部分**：无法用真实等待 30 天验证自然到期；以固定时钟 JWT 测试和 Cookie 参数单测覆盖。用户已于 2026-08-17 明确验收通过，浏览器关闭/重开行为由人工确认。#104 独立包不包含仍待验收的 #101；两项进入 `dev` 后才能生成最终组合包。
+
+## 遗留问题
+
+- 当前服务已恢复为用户原有的 #101 验证包，避免应用外壳回退；#104 独立包保留为具名 ZIP，未覆盖当前标准包。
+- 当前架构没有服务端单 Token 撤销能力，这是确认范围内的安全限制。
+
+## 验收确认
+
+- 用户于 2026-08-17 明确回复“#104 验收通过”。
+- PR #105 按仓库门禁合入 `dev`；`main` 不变。
+
+## 相关提交
+
+- `857ba45` feat: 将 Sense 登录有效期调整为30天 (#104)
+- `a843121` docs: 记录 Sense 30天登录有效期 (#104)
+- `adc227f` test: 验证 Sense 30天 JWT 到期时间 (#104)

wiki-docs.json

@@ -144,9 +144,17 @@
       "page": "Task-97-Sense免验证码登录与管理员密码重置",
       "path": "docs/task/97-Sense免验证码登录与管理员密码重置.md"
     },
+    {
+      "page": "Task-101-Sense-GoAdmin-应用外壳",
+      "path": "docs/task/101-Sense-GoAdmin-应用外壳.md"
+    },
     {
       "page": "Task-99-Sense登录页只读配置接口",
       "path": "docs/task/99-Sense登录页只读配置接口.md"
+    },
+    {
+      "page": "Task-104-Sense-30天登录有效期",
+      "path": "docs/task/104-Sense-30天登录有效期.md"
     }
   ]
 }