第一阶段:模型 → 判定 → /auth/me → 列表。统计接口与前端管理页随后。
1) 模型与迁移(head 从 k1l2m3n4o5p6 推进到 l1m2n3o4p5q6)
· business_groups 组定义,parent_id 表达「大组 > 小组」
· business_group_phases 可见范围,独立成表以支持多选 —— 需求要求
「范围可配置、不要写死」,单列存不下多个 phase
· business_group_members 成员,一人可属多组(这是「同时看生产+维修」的实现)
只建表、不写种子数据,所以可以先部署代码再建组。
2) DataScope 判定模块(app/services/data_scope_service.py)
全仓库唯一的权限谓词来源,业务代码里不准再出现 lifecycle_phase 过滤。
两条红线照抄部门隔离的教训:
· None(不限) 与 frozenset()(空) 语义相反,绝不共用一个哨兵值
· 空集合必须显式 false() —— SQLAlchemy 对 in_(()) 生 成 IN (NULL),
一旦退化成不过滤就是全量泄漏
解析优先级:SUPER_ADMIN 硬放行(不可被分组覆盖)
> 显式分组(分组优先于角色)
> 未分组 SUPERVISOR 默认全厂
> 未分组普通用户
3) 过渡期开关 DATA_SCOPE_UNGROUPED(默认 ALL)
直接上严格模式会让所有未分组工人当场看不到自己的任务、现场停摆。
默认 ALL 先放行并打 WARNING 记录「谁还没分组」,配好组后再改 NONE。
4) /auth/me 返回 scope,phase 中文标签由服务端下发
—— 前端已有两份 phase 词表副本,不再加第三份。
5) 列表接口接入
· get_all_products:过滤加在 offset/limit 之前(其下有 6 段基于 product_ids
的批量预计算,过滤晚了等于算完再丢)
· get_all_tasks:谓词进【共享 filters】,保证 count 与 select 两条独立语句
同时生效,否则 total 与实际页不一致、移动端 hasMore 判断跟着错
· 扫码 get_product_by_serial 刻意不过滤,理由写死在 docstring 里
实测:空 scope 生成 false、受限 scope 生成 JOIN + IN 谓词;
/products 返回 2 条、/tasks 的 total 与 returned 一致。
79 lines
3.5 KiB
Python
79 lines
3.5 KiB
Python
"""核心配置 — Pydantic Settings 自动从 .env 读取"""
|
||
import json
|
||
from pydantic import model_validator
|
||
from pydantic_settings import BaseSettings
|
||
|
||
|
||
class Settings(BaseSettings):
|
||
# ---- 数据库 ----
|
||
DATABASE_URL: str = "postgresql+asyncpg://track:track_prod_2026@localhost:5433/track_production"
|
||
|
||
# ---- JWT ----
|
||
SECRET_KEY: str = "change-me-in-production"
|
||
ACCESS_TOKEN_EXPIRE_MINUTES: int = 120 # Access Token: 2 小时
|
||
REFRESH_TOKEN_EXPIRE_DAYS: int = 7 # Refresh Token: 7 天
|
||
|
||
# ---- 调试 ----
|
||
DEBUG: bool = True
|
||
|
||
# ---- 应用元信息 ----
|
||
APP_VERSION: str = "1.0.0"
|
||
|
||
# ---- 日志 ----
|
||
LOG_LEVEL: str = "INFO"
|
||
LOG_JSON: bool = True # 生产保持 True(便于采集);本地调试可设 False 换可读格式
|
||
|
||
# ---- 错误追踪(可选,不装 sentry-sdk 则自动跳过)----
|
||
SENTRY_DSN: str | None = None
|
||
SENTRY_TRACES_SAMPLE_RATE: float = 0.0
|
||
|
||
# ---- CORS 跨域白名单(JSON 数组字符串,直接从 .env 的 CORS_ORIGINS 读取) ----
|
||
CORS_ORIGINS: str = '["http://localhost:1420", "tauri://localhost"]'
|
||
|
||
# ---- MOM 仓储系统回调 Webhook(Track 作为接收方,验签用) ----
|
||
TRACK_WEBHOOK_KEY: str | None = None # MOM 回调 POST 时 Header X-API-Key 须等于此值
|
||
|
||
# ---- 组织隔离 ----
|
||
# 同一套代码部署给不同部门时,只需改这两个值(+ compose 里的项目名/容器名/端口)。
|
||
# 全仓库的部门过滤点只有三处 SQL:登录、人员列表、物料选择器,全部引用这里。
|
||
ORG_DEPARTMENT: str = "LICA" # MOM sys_user.department 的取值
|
||
MATERIAL_CATEGORY_PREFIX: str = "LICA/" # MOM material_base.category 的部门前缀
|
||
# 产品序列号前缀(产品身份证 / 二维码内容)。留空则生成纯 16 位 HEX。
|
||
# LICA 用 "L" 打头,一眼区分部门来源;IRIS 实例保持空串不受影响。
|
||
SERIAL_PREFIX: str = "L"
|
||
|
||
# ---- 业务分组数据范围 ----
|
||
# 未被分进任何业务组的**普通用户**(非超管、非主管)能看到什么:
|
||
# "ALL" = 过渡期先放行,同时打 WARNING 日志把「谁还没分组」暴露出来
|
||
# "NONE" = 目标态:看不到任何数据(列表返回空,不是 403)
|
||
# ⚠️ 直接上 NONE 会让所有未分组工人当场看不到自己的任务,现场停摆。
|
||
# 推荐节奏:先 ALL 上线 → 看日志收集未分组名单 → 配好组 → 再翻 NONE。
|
||
# 翻开关只需改这里 + 重启,不需要改代码、不需要迁移,回滚同样瞬时。
|
||
DATA_SCOPE_UNGROUPED: str = "ALL"
|
||
|
||
@property
|
||
def CORS_ORIGINS_LIST(self) -> list[str]:
|
||
"""将 JSON 字符串解析为 Python list,供 CORSMiddleware 使用"""
|
||
try:
|
||
return json.loads(self.CORS_ORIGINS)
|
||
except (json.JSONDecodeError, TypeError):
|
||
return ["http://localhost:1420", "tauri://localhost"]
|
||
|
||
@model_validator(mode="after")
|
||
def _validate_production_secret(self):
|
||
"""生产环境强制校验:SECRET_KEY 禁止使用默认值"""
|
||
if not self.DEBUG and self.SECRET_KEY == "change-me-in-production":
|
||
raise ValueError(
|
||
"生产环境 (DEBUG=False) 禁止使用默认 SECRET_KEY。"
|
||
"请在 .env 中设置 SECRET_KEY 为至少 32 字符的随机值。"
|
||
"示例: python -c \"import secrets; print(secrets.token_urlsafe(32))\""
|
||
)
|
||
return self
|
||
|
||
class Config:
|
||
env_file = ".env"
|
||
extra = "ignore"
|
||
|
||
|
||
settings = Settings()
|