@kernel-sig/console 0.1.0

package/backend/app/schemas/sig.py

@@ -0,0 +1,246 @@
+"""版本、分支、会议、成员的对外 Schema。"""
+
+import uuid
+from datetime import date, datetime
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from app.models.classification import PRKind
+
+
+class BranchSummary(BaseModel):
+    """分支/版本概览。"""
+
+    name: str
+    raw_names: list[str]
+    """库中实际出现过的写法。构造 PR 列表链接时用它们做筛选值。"""
+
+    kind: str
+    series: str | None = None
+    sp: int | None = None
+    upstream_base: str | None = None
+    state: str = "active"
+    note: str | None = None
+    keepers: list[str] = []
+
+    open_count: int = 0
+    merged_count: int = 0
+    merged_recent: int = 0
+    last_merged_at: datetime | None = None
+
+    latest_tag: str | None = None
+    last_report_on: date | None = None
+
+
+class MergeBucketRead(BaseModel):
+    label: str
+    start: date
+    end: date
+    total: int = 0
+    by_kind: dict[str, int] = {}
+
+
+class PeriodSummaryRead(BaseModel):
+    label: str
+    start: date
+    end: date
+    total: int = 0
+    cve_count: int = 0
+    by_branch: dict[str, int] = {}
+    by_kind: dict[str, int] = {}
+    top_contributors: list[tuple[str, int]] = []
+
+
+class ReleaseReportPatchRead(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    sequence: int
+    group_name: str | None
+    title: str
+    pull_number: int | None
+    url: str | None
+
+
+class ReleaseReportRead(BaseModel):
+    """一期一分支的版本进展报告。既是双周合入总结，也是该版本的 release notes。"""
+
+    id: uuid.UUID
+    branch: str
+    from_tag: str | None
+    to_tag: str | None
+    patch_count: int | None
+    listed_count: int
+    iso_urls: list[str] | None
+    cve_ids: list[str] | None
+    groups: list[dict] | None = None
+    meeting_held_on: date | None = None
+
+
+class PullRef(BaseModel):
+    """议题里引用的 PR。
+
+    只给出编号无法跳转 —— 详情页的路由用的是内部 id。
+    服务端在返回整场会议时一次性把编号解析成 id，前端就不必为每个链接
+    再发一次请求。
+    """
+
+    number: int
+    id: uuid.UUID | None = None
+    title: str | None = None
+    state: str | None = None
+    kind: PRKind | None = None
+
+
+class MeetingAgendaRead(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    id: uuid.UUID
+    sequence: int
+    num: str | None
+    title: str
+    owner: str | None
+    body: str | None
+    pull_numbers: list[int] | None
+    issue_numbers: list[int] | None
+    pull_refs: list[PullRef] = []
+
+
+class MeetingSummary(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    id: uuid.UUID
+    held_on: date
+    start_time: str | None
+    title: str
+    host: str | None
+    next_host: str | None
+    host_order: list[str] | None
+    meeting_url: str | None
+    minutes_url: str | None
+    status: str
+    agenda_count: int = 0
+    report_count: int = 0
+
+
+class MeetingDetail(MeetingSummary):
+    legacy: str | None = None
+    agendas: list[MeetingAgendaRead] = []
+    reports: list[ReleaseReportRead] = []
+
+
+class MemberRead(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    id: uuid.UUID
+    name: str
+    role: str
+    roles: list[str] | None = None
+    atomgit_id: str | None
+    gitee_id: str | None
+    github_id: str | None
+    email: str | None
+    org: str | None
+    is_active: bool
+    repositories: list[str] | None = None
+    admin_repositories: list[str] | None = None
+    kept_branches: list[str] | None = None
+
+
+class SubsystemOwnerRead(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    id: uuid.UUID
+    module: str
+    section: str | None
+    paths: list[str] | None
+    committer_logins: list[str] | None
+
+
+class MemberStats(BaseModel):
+    """成员贡献统计。按需现算，不落库。"""
+
+    login: str
+    name: str | None = None
+    role: str | None = None
+    authored: int = 0
+    """提交的 PR 数。"""
+
+    merged: int = 0
+    reviews: int = 0
+    """产生的评审事件数（LGTM / NACK 等）。"""
+
+    subsystems: list[str] = []
+
+
+class KindCountRead(BaseModel):
+    kind: PRKind
+    count: int
+
+
+class AttentionSampleRead(BaseModel):
+    number: int
+    title: str
+    subject_type: str
+    subject_id: str
+    url: str | None
+    severity: str
+    detail: str | None
+    age_days: int | None
+    # 认领作用于关注项本身，而不是被关注的对象 —— 界面据此调
+    # /attention/{id}/acknowledge
+    item_id: str
+    acknowledged_by: str | None = None
+
+
+class AttentionThemeRead(BaseModel):
+    name: str
+    count: int
+    samples: list[AttentionSampleRead] = []
+
+
+class AttentionGroupRead(BaseModel):
+    """一条规则的聚合结果。"""
+
+    rule: str
+    label: str
+    meaning: str
+    action: str
+    subject: str
+    count: int
+    severity: str
+    oldest_days: int | None
+    samples: list[AttentionSampleRead] = []
+    themes: list[AttentionThemeRead] = []
+    high_volume: bool = False
+    # 已被认领的条数。被认领的未必落在样例里，所以单独统计
+    acknowledged_count: int = 0
+
+
+class AttentionSummaryRead(BaseModel):
+    """首页摘要。分组与计数出自同一次查询，两个数字不会互相矛盾。"""
+
+    total: int
+    group_count: int
+    by_severity: dict[str, int]
+    blocking: int
+    top: list[AttentionGroupRead] = []
+
+
+class AttentionSettingRead(BaseModel):
+    rule: str
+    label: str
+    meaning: str
+    action: str
+    subject: str
+    enabled: bool
+    days: int
+    default_days: int
+    subject_scope: str
+    high_volume: bool
+    open_count: int = 0
+
+
+class AttentionSettingUpdate(BaseModel):
+    enabled: bool | None = None
+    days: int | None = Field(default=None, ge=0, le=3650)
+    subject_scope: str | None = Field(default=None, pattern="^(all|pull_request|issue)$")

package/backend/app/schemas/user.py

@@ -0,0 +1,79 @@
+"""用户 Schema。
+
+``Role`` 是 ``IntEnum``（用于角色强弱比较），但对外一律以**名称**传输
+（``"ADMIN"`` 而非 ``50``）—— 整数会随枚举顺序调整而变化，不能作为对外契约。
+"""
+
+import uuid
+from datetime import datetime
+from typing import Annotated, Any
+
+from pydantic import BaseModel, BeforeValidator, ConfigDict, Field, PlainSerializer, field_validator
+
+from app.core.permissions import Permission, Role
+
+
+def _parse_role(value: Any) -> Any:
+    """接受角色名或数值，统一转为 Role。"""
+    if isinstance(value, str) and not value.lstrip("-").isdigit():
+        try:
+            return Role[value.upper()]
+        except KeyError as exc:
+            raise ValueError(f"未知角色：{value}") from exc
+    return value
+
+
+RoleField = Annotated[
+    Role,
+    BeforeValidator(_parse_role),
+    PlainSerializer(lambda role: role.name, return_type=str),
+]
+
+
+class UserRead(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    id: uuid.UUID
+    username: str
+    display_name: str
+    email: str
+    role: RoleField
+    atomgit_login: str | None
+    is_active: bool
+    last_login_at: datetime | None
+    created_at: datetime
+
+
+class CurrentUser(UserRead):
+    """当前登录用户，附带计算出的权限列表。"""
+
+    permissions: list[Permission] = Field(default_factory=list)
+
+
+class UserCreate(BaseModel):
+    username: str = Field(min_length=3, max_length=64)
+    display_name: str = Field(min_length=1, max_length=128)
+    email: str = Field(min_length=3, max_length=255)
+    password: str = Field(min_length=8, max_length=256)
+    role: RoleField = Role.VIEWER
+    atomgit_login: str | None = Field(default=None, max_length=64)
+
+    @field_validator("username")
+    @classmethod
+    def _validate_username(cls, v: str) -> str:
+        # 用户名会被用于日志与审计检索，限制字符集避免歧义
+        if not v.replace("_", "").replace("-", "").isalnum():
+            raise ValueError("用户名只能包含字母、数字、下划线与连字符")
+        return v
+
+
+class UserUpdate(BaseModel):
+    display_name: str | None = Field(default=None, min_length=1, max_length=128)
+    role: RoleField | None = None
+    atomgit_login: str | None = Field(default=None, max_length=64)
+    is_active: bool | None = None
+
+
+class PasswordChange(BaseModel):
+    current_password: str = Field(min_length=1, max_length=256)
+    new_password: str = Field(min_length=8, max_length=256)