package comm

import (
	"os"
	"strconv"
	"strings"
)

// 部署身份（应用名/区域）解析——全服务唯一入口。
//
// 一份部署只用一组环境变量声明「我是谁」，就是统计上报那一组：
//   - ANALYZE_APP_NAME —— 应用名，须与 console 注册表 app_registry 的 name 与 app_name
//     【两列同时】完全一致（大小写敏感）
//   - ANALYZE_REGION   —— 区域，pb.Region 枚举整数（1=中国 2=美国 …，见 region.go）
//
// ⚠️ 为什么是「两列同时」：这一个变量被两处以不同口径消费，缺一不可——
//   - 按应用作用域读配置（本文件的 AppName()）：配置表按 app_registry.app_name 存；
//   - 统计落库：console 消费快照时先过 isRegisteredApp() → getAppByName()，那里查的是
//     `app_registry.name`（见 modules/console/model_registry.go）。对不上就整条丢弃，
//     只在 console 日志留一行 `console.stat: 快照应用未在 console 注册，未落库`，
//     数据滞留在业务侧 Redis，看板恒为 0 且不报任何错。
// 所以注册应用时要把 name 与 app_name 填成同一个值；只满足一半必然坏掉另一半。
// （2026-09-01 在阿龙测试机实测：两列不一致，实时统计累计 152 条被拒、一条都没落库。）
//
// 历史上还有一组同义的 APP_NAME / APP_REGION（服务配置托管、会议记录编排在用），
// 与 ANALYZE_* 语义完全重复，却因为一个走 yaml options、一个走裸 env 而长期并存：
// 线上普遍只填了 ANALYZE_*，于是按作用域读配置的地方全部静默退化成「全局默认」，
// 后台明明按应用配好了却下发不到客户端。2026-08-12 已删除 APP_NAME/APP_REGION，
// 所有消费方一律走本文件的 AppName/AppRegion/AppRegionId。

// AppName 返回本部署的应用名（console 注册表 app_registry.app_name；该列须与 name 列同值，
// 理由见上方说明）。返回 "" 表示未声明部署身份，调用方按「全局默认」作用域处理。
func AppName() string {
	return strings.TrimSpace(os.Getenv("ANALYZE_APP_NAME"))
}

// AppRegionId 返回本部署的区域枚举值（pb.Region int32）；未配置或非法返回 0（未知）。
// 按 int32 分层的表（会议记录编排 echomeet_orch 等）用它。
func AppRegionId() int32 {
	v := strings.TrimSpace(os.Getenv("ANALYZE_REGION"))
	if v == "" {
		return 0
	}
	n, err := strconv.ParseInt(v, 10, 32)
	if err != nil {
		// 容错：有人按老习惯填了短代码（cn/us…）也认。
		return RegionFromCode(strings.ToLower(v))
	}
	return int32(n)
}

// AppRegion 返回 app_registry.region 口径的区域字符串，用于按 (app_name, region) 查注册表
// 与服务配置托管表 app_service_config。
//
// ⚠️ 不是 RegionCode() 的细分短代码：后台把区域收敛成「国内(cn) / 海外(hw)」两档
// （见 admin app/utils/regions.ts），注册表里存的就是这两个值，所以这里也归一成两档——
// 直接用 "us"/"ea" 这种细分码去匹配注册表会一行都查不到。未配置返回 ""（全局默认）。
func AppRegion() string {
	switch id := AppRegionId(); {
	case id == 0:
		return ""
	case RegionCode(id) == RegionCodeCN:
		return RegionCodeCN
	default:
		return RegionCodeOverseas
	}
}