110 lines
4.2 KiB
Python
110 lines
4.2 KiB
Python
# ============================================================
|
||
# 功能开关（Feature Flags）文件化配置（moduleId: feature-flags, 可重生 ✅）
|
||
# 用一个 JSON 文件控制哪些功能上线可见、哪些功能隐藏不用。
|
||
#
|
||
# 语义（务必牢记）：
|
||
# - 这是「可用性/可见性」开关，不是权限边界；隐藏不等于鉴权，
|
||
# P2/P3 权力路径仍由 Harness 门禁独立保证。
|
||
# - fail-open 诚实回退：文件缺失/损坏/版本不符 → 全部功能默认开启，
|
||
# 并在响应里显式携带 source/error，绝不静默吞掉配置错误，
|
||
# 也绝不因配置损坏把系统锁死。
|
||
# - 未知键忽略但如实列入 unknown；非 bool 值该键回退默认开启并记录错误。
|
||
#
|
||
# 配置文件（默认 server/data/features.json，APS_FEATURES_PATH 可覆盖）：
|
||
# {"version": 1, "features": {"orders": true, "drawing": false, ...}}
|
||
# ============================================================
|
||
from __future__ import annotations
|
||
|
||
import json
|
||
import os
|
||
from typing import Any
|
||
|
||
_SCHEMA_VERSION = 1
|
||
_PATH_ENV = "APS_FEATURES_PATH"
|
||
|
||
# 功能目录：key → 中文标签（顺序即展示顺序；新增功能必须在此登记）
|
||
FEATURE_CATALOG: dict[str, str] = {
|
||
"visual": "会话结果视口（甘特/负荷/交期）",
|
||
"orders": "订单管理",
|
||
"master": "主数据",
|
||
"flex": "柔性工作台",
|
||
"timeline": "排产结构（时间线）",
|
||
"drawing": "图纸识别（DXF）",
|
||
"mesh": "多智能体编排",
|
||
"knowledge": "知识平台",
|
||
"skills": "算法 Skill 管理",
|
||
"gov": "审批治理",
|
||
"regen": "重生中心",
|
||
"settings": "设置",
|
||
}
|
||
|
||
|
||
def default_features_path() -> str:
|
||
configured = os.environ.get(_PATH_ENV)
|
||
if configured:
|
||
return configured
|
||
from server.aps_home import path_under_data
|
||
|
||
return str(path_under_data("features.json"))
|
||
|
||
|
||
def _all_enabled() -> dict[str, bool]:
|
||
return {key: True for key in FEATURE_CATALOG}
|
||
|
||
|
||
def load_feature_flags(file_path: str | None = None) -> dict[str, Any]:
|
||
"""读取并解析功能开关配置。
|
||
|
||
Returns: {"version": 1, "source": "default"|"file", "path": str,
|
||
"error": str | None, "unknown": [str],
|
||
"features": {key: {"enabled": bool, "label": str}}}
|
||
"""
|
||
path = file_path or default_features_path()
|
||
enabled = _all_enabled()
|
||
source = "default"
|
||
error: str | None = None
|
||
unknown: list[str] = []
|
||
|
||
if not os.path.exists(path):
|
||
pass # 文件缺失：默认全开
|
||
else:
|
||
try:
|
||
with open(path, "r", encoding="utf-8") as handle:
|
||
raw = json.load(handle)
|
||
except (json.JSONDecodeError, OSError, UnicodeDecodeError) as exc:
|
||
error = f"功能开关配置无法解析（{type(exc).__name__}），已回退全部默认开启"
|
||
else:
|
||
if not isinstance(raw, dict) or raw.get("version") != _SCHEMA_VERSION:
|
||
error = "功能开关配置顶层结构或 version 非法，已回退全部默认开启"
|
||
elif not isinstance(raw.get("features"), dict):
|
||
error = "功能开关配置 features 段不是对象，已回退全部默认开启"
|
||
else:
|
||
source = "file"
|
||
value_errors: list[str] = []
|
||
for key, value in raw["features"].items():
|
||
if key not in FEATURE_CATALOG:
|
||
unknown.append(str(key))
|
||
continue
|
||
if not isinstance(value, bool):
|
||
value_errors.append(key) # 非 bool：该键回退默认开启
|
||
continue
|
||
enabled[key] = value
|
||
if value_errors:
|
||
error = (
|
||
"功能开关配置存在非 bool 取值（"
|
||
+ ",".join(sorted(value_errors))
|
||
+ "），对应功能已回退默认开启"
|
||
)
|
||
|
||
return {
|
||
"version": _SCHEMA_VERSION,
|
||
"source": source,
|
||
"path": str(path),
|
||
"error": error,
|
||
"unknown": unknown,
|
||
"features": {
|
||
key: {"enabled": enabled[key], "label": label}
|
||
for key, label in FEATURE_CATALOG.items()
|
||
},
|
||
}
|