yovision/Bell/README.md

Bell

Bell 是独立部署的预警管理产品。本目录从冻结的 go-admin/go-admin-ui 完整源码派生；来源与裁剪证据见 LICENSES/SOURCES.md。

固定工具链

• Go 1.26.5：$env:GOTOOLCHAIN='go1.26.5'
• Node 22.22.1
• pnpm 9.15.1：corepack pnpm@9.15.1

必需环境变量

BELL_DATABASE_URL=<独立 PostgreSQL DSN>
BELL_JWT_SECRET=<至少 32 字符的独立随机值>
BELL_BOOTSTRAP_USERNAME=<仅首次迁移使用>
BELL_BOOTSTRAP_PASSWORD=<仅首次迁移使用，至少 8 字符>

可选 BELL_HOST、BELL_PORT 覆盖默认监听 127.0.0.1:18090。不要把这些值写入仓库。

迁移与启动

Set-Location Bell/server
$env:GOTOOLCHAIN='go1.26.5'
go run . migrate -c config/settings.yml
go run . server -c config/settings.yml

前端：

Set-Location Bell/ui
corepack pnpm@9.15.1 install --frozen-lockfile
corepack pnpm@9.15.1 dev

生产构建使用 corepack pnpm@9.15.1 build:prod。生产环境不会生成或接受仓库默认管理员、默认 JWT secret 或默认数据库连接串。

Windows 交付与独立验收

• Windows 构建：Bell\scripts\build\build-windows.bat
• 包审计：pwsh -NoProfile -File Bell\scripts\build\test-package.ps1 -PackageRoot Bell\dist\bell-windows-amd64
• 隔离 E2E：pwsh -NoProfile -File Bell\scripts\test-independent-e2e.ps1 -PreparedPackageRoot Bell\dist\bell-windows-amd64
• 包内启动、检查和停止：start-bell.bat、check-bell.bat -Running、stop-bell.bat

完整配置、排错和验收标准见 README-WINDOWS.md 与 ACCEPTANCE.md。隔离 E2E 使用临时 PostgreSQL、随机端口和随机凭据，不启动或调用 Sense、Brain。