@kernel-sig/console 0.1.0

package/frontend/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "kernel-sig-frontend",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@tanstack/react-query": "^5.62.7",
+    "@tanstack/react-router": "^1.92.0",
+    "antd": "^6.6.4",
+    "clsx": "^2.1.1",
+    "echarts": "^6.1.0",
+    "lucide-react": "^0.468.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwind-merge": "^2.5.5"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.0.0",
+    "@types/node": "^22.10.2",
+    "@types/react": "^19.0.2",
+    "@types/react-dom": "^19.0.2",
+    "@vitejs/plugin-react": "^4.3.4",
+    "tailwindcss": "^4.0.0",
+    "typescript": "^5.7.2",
+    "vite": "^6.0.5",
+    "vitest": "^2.1.8"
+  }
+}

package/frontend/src/api/ai.ts

@@ -0,0 +1,124 @@
+import { api } from '@/lib/api-client'
+import type { SubjectType } from '@/api/classification'
+
+export type AITask = 'classify' | 'summarize' | 'risk_review' | 'backport_verify'
+export type AnalysisStatus = 'pending' | 'running' | 'succeeded' | 'failed'
+
+/** 任务的中文名与用途。按任务配模型是本平台成本控制的核心手段。 */
+export const TASK_META: Record<AITask, { label: string; purpose: string }> = {
+  classify: { label: '类型判定', purpose: '规则判不出来时补判 PR/Issue 的类型' },
+  summarize: { label: '变更摘要', purpose: '30 秒内判断是否需要深入阅读' },
+  risk_review: { label: '风险审查', purpose: '查 KABI 兼容性、并发、错误路径等真实缺陷' },
+  backport_verify: { label: 'Backport 核对', purpose: '逐行对照上游补丁，找出实质性差异' },
+}
+
+export const STATUS_META: Record<AnalysisStatus, { label: string; tone: 'neutral' | 'success' | 'warning' | 'danger' | 'info' }> = {
+  pending: { label: '排队中', tone: 'neutral' },
+  running: { label: '进行中', tone: 'info' },
+  succeeded: { label: '已完成', tone: 'success' },
+  failed: { label: '失败', tone: 'danger' },
+}
+
+export interface LLMProvider {
+  id: string
+  name: string
+  kind: 'openai_compatible'
+  base_url: string
+  credential_id: string | null
+  model: string
+  temperature: number
+  max_tokens: number
+  timeout_seconds: number
+  enabled: boolean
+  is_default: boolean
+  last_used_at: string | null
+  last_error: string | null
+  created_at: string
+}
+
+export interface ProviderInput {
+  name: string
+  base_url: string
+  model: string
+  api_key?: string
+  temperature?: number
+  max_tokens?: number
+  timeout_seconds?: number
+  is_default?: boolean
+}
+
+export interface ProviderTestResult {
+  ok: boolean
+  detail: string
+  latency_ms: number | null
+  model: string | null
+}
+
+export interface TaskRouting {
+  id: string
+  task: AITask
+  provider_id: string
+  fallback_provider_id: string | null
+  system_prompt: string | null
+  enabled: boolean
+}
+
+export interface AIAnalysis {
+  id: string
+  task: AITask
+  status: AnalysisStatus
+  provider_name: string | null
+  model: string | null
+  prompt_tokens: number
+  completion_tokens: number
+  result: Record<string, unknown> | null
+  error: string | null
+  started_at: string | null
+  finished_at: string | null
+  created_at: string
+}
+
+export interface AIUsage {
+  analyses: number
+  succeeded: number
+  failed: number
+  prompt_tokens: number
+  completion_tokens: number
+  by_task: Record<string, number>
+}
+
+export const aiApi = {
+  providers: () => api.get<LLMProvider[]>('/ai/providers'),
+
+  createProvider: (payload: ProviderInput) => api.post<LLMProvider>('/ai/providers', payload),
+
+  updateProvider: (id: string, payload: Partial<ProviderInput> & { enabled?: boolean }) =>
+    api.patch<LLMProvider>(`/ai/providers/${id}`, payload),
+
+  deleteProvider: (id: string) => api.delete<void>(`/ai/providers/${id}`),
+
+  /** 发一个最小请求实测端点与凭据。配置错误只有真发一次才能发现。 */
+  testProvider: (id: string) => api.post<ProviderTestResult>(`/ai/providers/${id}/test`),
+
+  routing: () => api.get<TaskRouting[]>('/ai/routing'),
+
+  upsertRouting: (
+    task: AITask,
+    payload: { provider_id: string; system_prompt?: string | null; enabled?: boolean },
+  ) => api.put<TaskRouting>(`/ai/routing/${task}`, payload),
+
+  deleteRouting: (task: AITask) => api.delete<void>(`/ai/routing/${task}`),
+
+  analyses: (subjectType: SubjectType, subjectId: string) =>
+    api.get<AIAnalysis[]>(`/ai/analyses/${subjectType}/${subjectId}`),
+
+  analyzePull: (pullId: string, task: AITask, force = false) =>
+    api.post<AIAnalysis>(`/pulls/${pullId}/ai/analyze?task=${task}&force=${force}`),
+
+  usage: (days = 30) => api.get<AIUsage>(`/ai/usage?days=${days}`),
+
+  classifyMissing: (repositoryId: string, limit = 5) =>
+    api.post<{ message: string }>(
+      `/repositories/${repositoryId}/ai/classify-missing?limit=${limit}`,
+    ),
+}

package/frontend/src/api/analytics.ts

@@ -0,0 +1,66 @@
+import { api } from '@/lib/api-client'
+import type { GateStage } from '@/api/pulls'
+
+export interface Overview {
+  pulls: {
+    open: number
+    merged: number
+    closed: number
+    created_last_7d: number
+    created_last_30d: number
+    merged_last_7d: number
+    ready_to_merge: number
+    blocked: number
+  }
+  issues: { open: number; closed: number }
+}
+
+export interface WaitingStats {
+  pending_review_count: number
+  avg_waiting_days: number
+  median_waiting_days: number
+  max_waiting_days: number
+  over_30_days: number
+}
+
+export interface IntervalStats {
+  merged_count: number
+  avg_merge_days: number
+  median_merge_days: number
+  merged_last_30d: number
+}
+
+export interface QualitySignals {
+  binary_files: number
+  merge_conflicts: number
+  drafts: number
+}
+
+export interface ReviewerStat {
+  actor_login: string
+  lgtm_count: number
+  approve_count: number
+  ack_count: number
+  total: number
+}
+
+export interface AnalyticsSummary {
+  overview: Overview
+  waiting: WaitingStats
+  intervals: IntervalStats
+  quality: QualitySignals
+  stages: { stage: GateStage; count: number }[]
+  branches: { branch: string; count: number }[]
+  authors: { author: string; count: number; is_bot?: boolean }[]
+  reviewers: ReviewerStat[]
+}
+
+export const analyticsApi = {
+  summary: (repositoryId: string) =>
+    api.get<AnalyticsSummary>(`/repositories/${repositoryId}/analytics/summary`),
+
+  reviewers: (repositoryId: string, days = 90) =>
+    api.get<ReviewerStat[]>(
+      `/repositories/${repositoryId}/analytics/reviewers?days=${days}`,
+    ),
+}

package/frontend/src/api/attention.ts

@@ -0,0 +1,181 @@
+import { api } from '@/lib/api-client'
+import type { BadgeTone } from '@/components/ui/badge'
+import type { SubjectType } from '@/api/classification'
+
+export type AttentionSeverity = 'blocker' | 'critical' | 'warning' | 'info'
+
+export type AttentionRule =
+  | 'stale'
+  | 'review_sla_breach'
+  | 'ci_failed'
+  | 'merge_conflict'
+  | 'needs_issue'
+  | 'cla_denied'
+  | 'cla_pending_long'
+  | 'rejected'
+  | 'binary_file'
+  | 'missing_signed_off'
+  | 'cve_aging'
+  | 'issue_unassigned'
+  | 'issue_stale'
+
+/** 严重程度的中文名与语义色，与领域层 SEVERITY_ORDER 的顺序一致。 */
+export const SEVERITY_META: Record<AttentionSeverity, { label: string; tone: BadgeTone }> = {
+  blocker: { label: '阻塞', tone: 'danger' },
+  critical: { label: '严重', tone: 'danger' },
+  warning: { label: '警告', tone: 'warning' },
+  info: { label: '提示', tone: 'info' },
+}
+
+/** 严重程度的展示顺序：让筛选栏和列表都按同一顺序排列。 */
+export const SEVERITY_ORDER: AttentionSeverity[] = ['blocker', 'critical', 'warning', 'info']
+
+/** 规则的中文名。规则含义由后端 /attention/rules 下发，此处只做短标签。 */
+export const RULE_LABELS: Record<AttentionRule, string> = {
+  stale: '长期无活动',
+  review_sla_breach: '评审超期',
+  ci_failed: 'CI 失败',
+  merge_conflict: '合并冲突',
+  needs_issue: '缺关联 Issue',
+  cla_denied: 'CLA 未通过',
+  cla_pending_long: 'CLA 停滞',
+  rejected: '已被 NACK',
+  binary_file: '二进制文件',
+  missing_signed_off: '缺签名',
+  cve_aging: 'CVE 未推进',
+  issue_unassigned: 'Issue 未指派',
+  issue_stale: 'Issue 停滞',
+}
+
+export interface AttentionItem {
+  id: string
+  repository_id: string
+  subject_type: SubjectType
+  subject_id: string
+  subject_number: number
+  subject_title: string
+  subject_url: string | null
+  rule: AttentionRule
+  severity: AttentionSeverity
+  title: string
+  detail: string | null
+  evidence: Record<string, unknown> | null
+  first_detected_at: string
+  last_evaluated_at: string
+  acknowledged_by: string | null
+  acknowledged_at: string | null
+}
+
+/**
+ * 逐条接口。
+ *
+ * 只有这两处需要逐条：PR 详情要知道"这个 PR 为何在待办里"，
+ * 队列的样例行要能认领/交还。列表与计数走分组队列 —— 逐条罗列的
+ * 那一套已经在收敛设计里被替换掉了，留着就是没人调的代码。
+ */
+export const attentionApi = {
+  /** 某个 PR 当前命中的关注项。详情页据此说明"它为何在待办里"。 */
+  forPull: (pullId: string) => api.get<AttentionItem[]>(`/pulls/${pullId}/attention`),
+
+  acknowledge: (itemId: string) => api.post<AttentionItem>(`/attention/${itemId}/acknowledge`),
+
+  release: (itemId: string) => api.delete<AttentionItem>(`/attention/${itemId}/acknowledge`),
+
+  /** 立即重算。规则设置改完之后，不必等后台那 15 分钟一次的重算。 */
+  recompute: (repositoryId: string) =>
+    api.post<{ open_items: number; hits: number }>(
+      `/repositories/${repositoryId}/attention/recompute`,
+    ),
+}
+
+// ---------------------------------------------------------------------------
+// 分组队列与订阅设置
+//
+// 队列此前是逐条罗列：每个命中对象一行，实测 4780 条（其中 63% 是陈旧
+// Issue）。逐条显示等于把"需要关注"变成"全部清单"，翻两页就会被放弃。
+// 现在按规则收敛成分组，说明与处置建议由后端下发 —— 只说问题不给出路，
+// 队列就只是噪音来源。
+// ---------------------------------------------------------------------------
+
+export interface AttentionSample {
+  number: number
+  title: string
+  subject_type: string
+  subject_id: string
+  url: string | null
+  severity: AttentionSeverity
+  detail: string | null
+  /** 对象等待了多久。null 表示该规则不带时间信息（如"缺关联 Issue"）。 */
+  age_days: number | null
+  /** 关注项自身的 id。认领作用于它，不是作用于被关注的对象。 */
+  item_id: string
+  /** 认领人的 user id，与当前用户比对即可判断是不是自己认领的。 */
+  acknowledged_by: string | null
+}
+
+export interface AttentionTheme {
+  name: string
+  count: number
+  samples: AttentionSample[]
+}
+
+export interface AttentionGroup {
+  rule: AttentionRule
+  label: string
+  /** 这条规则在提醒什么。 */
+  meaning: string
+  /** 看到之后该做什么。 */
+  action: string
+  subject: 'pull_request' | 'issue'
+  count: number
+  severity: AttentionSeverity
+  oldest_days: number | null
+  samples: AttentionSample[]
+  themes: AttentionTheme[]
+  high_volume: boolean
+  /** 已被认领的条数。被认领的那条未必落在样例里，所以由后端单独统计。 */
+  acknowledged_count: number
+}
+
+export interface AttentionRuleSetting {
+  rule: AttentionRule
+  label: string
+  meaning: string
+  action: string
+  subject: 'pull_request' | 'issue'
+  enabled: boolean
+  days: number
+  default_days: number
+  subject_scope: 'all' | 'pull_request' | 'issue'
+  high_volume: boolean
+  /** 该规则当前未解决的条数。关掉之前应知道它拦下了多少。 */
+  open_count: number
+}
+
+export interface AttentionSummary {
+  total: number
+  group_count: number
+  by_severity: Record<string, number>
+  /** 必须动手的组数。 */
+  blocking: number
+  top: AttentionGroup[]
+}
+
+export const attentionQueueApi = {
+  /** 分组队列。返回的是分组而非逐条。 */
+  queue: (repositoryId: string, scope?: 'pull_request' | 'issue') =>
+    api.get<AttentionGroup[]>(
+      `/repositories/${repositoryId}/attention/queue${scope ? `?scope=${scope}` : ''}`,
+    ),
+
+  /** 首页摘要。与队列同源，数字不会与队列页矛盾。 */
+  summary: (repositoryId: string) =>
+    api.get<AttentionSummary>(`/repositories/${repositoryId}/attention/summary`),
+
+  ruleSettings: () => api.get<AttentionRuleSetting[]>('/attention/rule-settings'),
+
+  updateRuleSetting: (
+    rule: AttentionRule,
+    patch: { enabled?: boolean; days?: number; subject_scope?: string },
+  ) => api.put<AttentionRuleSetting>(`/attention/rule-settings/${rule}`, patch),
+}

package/frontend/src/api/auth.ts

@@ -0,0 +1,74 @@
+import { api } from '@/lib/api-client'
+
+export type Role = 'VIEWER' | 'REVIEWER' | 'COMMITTER' | 'MAINTAINER' | 'ADMIN'
+
+export type Permission =
+  | 'view'
+  | 'trigger_analysis'
+  | 'classify'
+  | 'write_back'
+  | 'manage_repository'
+  | 'manage_prompts'
+  | 'manage_credentials'
+  | 'manage_users'
+  | 'view_audit_log'
+
+export interface CurrentUser {
+  id: string
+  username: string
+  display_name: string
+  email: string
+  role: Role
+  atomgit_login: string | null
+  is_active: boolean
+  last_login_at: string | null
+  created_at: string
+  permissions: Permission[]
+}
+
+export interface UserRead {
+  id: string
+  username: string
+  display_name: string
+  email: string
+  role: Role
+  atomgit_login: string | null
+  is_active: boolean
+  last_login_at: string | null
+  created_at: string
+}
+
+export interface SetupStatus {
+  needs_setup: boolean
+}
+
+export interface Page<T> {
+  items: T[]
+  total: number
+  page: number
+  per_page: number
+}
+
+export const authApi = {
+  setupStatus: () => api.get<SetupStatus>('/auth/setup-status'),
+
+  setup: (payload: {
+    username: string
+    display_name: string
+    email: string
+    password: string
+  }) => api.post<UserRead>('/auth/setup', payload),
+
+  login: (payload: { username: string; password: string }) =>
+    api.post<{ access_token: string; token_type: string }>('/auth/login', payload),
+
+  logout: () => api.post<void>('/auth/logout'),
+
+  me: () => api.get<CurrentUser>('/auth/me'),
+
+  listUsers: (page = 1, perPage = 50) =>
+    api.get<Page<UserRead>>(`/users?page=${page}&per_page=${perPage}`),
+
+  changePassword: (payload: { current_password: string; new_password: string }) =>
+    api.post<void>('/users/me/password', payload),
+}

package/frontend/src/api/classification.ts

@@ -0,0 +1,170 @@
+import { api } from '@/lib/api-client'
+import type { Page } from '@/api/pulls'
+
+export type PRKind =
+  | 'cve'
+  | 'release'
+  | 'backport'
+  | 'driver_new'
+  | 'driver_update'
+  | 'soc_support'
+  | 'out_of_tree'
+  | 'bugfix'
+  | 'feature'
+  | 'perf'
+  | 'refactor'
+  | 'docs'
+  | 'cleanup'
+  | 'unknown'
+
+export type ClassificationSource = 'rule' | 'ai' | 'manual'
+export type SubjectType = 'pull_request' | 'issue'
+
+/**
+ * 类别元数据。
+ *
+ * `color` 是 globals.css 里的令牌名而非具体色值：色板集中在一处维护，
+ * 改主题时不必回来翻组件。
+ *
+ * 十几种类别无法都塞进几个语义色里 —— 那样"这是 CVE"会和"这是危险"
+ * 长得一模一样。因此另开一组 kind 专用色相，语义色仍然只表达状态。
+ */
+export const KIND_META: Record<PRKind, { label: string; color: string; hint: string }> = {
+  cve: {
+    label: 'CVE',
+    color: 'var(--color-kind-cve)',
+    hint: '安全漏洞修复，有明确时限',
+  },
+  release: {
+    label: '版本发布',
+    // 与其它类别共用一套色相：它是"一次发布动作"，不是风险等级
+    color: 'var(--color-kind-backport)',
+    hint: '版本发布（release X.Y.Z），源码包仓的主要工作',
+  },
+  backport: {
+    label: '回合补丁',
+    color: 'var(--color-kind-backport)',
+    hint: '来自上游主线或 stable 分支，需逐行对照原补丁',
+  },
+  driver_new: {
+    label: '新增驱动',
+    color: 'var(--color-kind-driver)',
+    hint: '新增驱动或控制器支持，需评估与上游的重叠范围',
+  },
+  driver_update: {
+    label: '驱动更新',
+    color: 'var(--color-kind-driver)',
+    hint: '驱动版本升级，通常改动量大',
+  },
+  soc_support: {
+    label: '处理器支持',
+    color: 'var(--color-kind-soc)',
+    hint: '针对某家 SoC 厂商的支持改动',
+  },
+  out_of_tree: {
+    label: '自研特性',
+    color: 'var(--color-kind-out-of-tree)',
+    hint: '不在上游主线中的 openEuler 自研代码，需过 KABI',
+  },
+  bugfix: { label: '缺陷修复', color: 'var(--color-kind-fix)', hint: '修复功能缺陷' },
+  feature: { label: '新功能', color: 'var(--color-kind-feature)', hint: '新增功能' },
+  perf: { label: '性能优化', color: 'var(--color-kind-feature)', hint: '性能优化' },
+  refactor: { label: '重构', color: 'var(--color-text-muted)', hint: '重构，不改变外部行为' },
+  docs: { label: '文档', color: 'var(--color-text-muted)', hint: '文档改动' },
+  cleanup: { label: '清理', color: 'var(--color-text-muted)', hint: '清理死代码、修正拼写等' },
+  unknown: { label: '未判定', color: 'var(--color-text-muted)', hint: '规则与 AI 均未给出结论' },
+}
+
+/** 类别的展示顺序：按维护者关心的优先级排，不按字母序。 */
+export const KIND_ORDER: PRKind[] = [
+  'cve',
+  'release',
+  'backport',
+  'driver_new',
+  'driver_update',
+  'soc_support',
+  'out_of_tree',
+  'bugfix',
+  'feature',
+  'perf',
+  'refactor',
+  'docs',
+  'cleanup',
+  'unknown',
+]
+
+/** 判定来源的说明。让使用者知道该不该信这个结果。 */
+export const SOURCE_META: Record<ClassificationSource, { label: string; hint: string }> = {
+  rule: { label: '规则', hint: '由确定性规则判定，可复现' },
+  ai: { label: 'AI 补判', hint: '规则未命中，由模型判定' },
+  manual: { label: '人工指定', hint: '维护者手动指定，自动任务不再改写' },
+}
+
+export interface Classification {
+  id: string
+  subject_type: SubjectType
+  subject_id: string
+  kind: PRKind
+  subsystem: string | null
+  /** 子系统的展示名，由后端下发（译名表只在领域层维护一份）。 */
+  subsystem_label: string | null
+  related_subsystems: string[] | null
+  cve_ids: string[] | null
+  linked_issues: number[] | null
+  confidence: number
+  source: ClassificationSource
+  rule_name: string | null
+  reason: string | null
+  is_override: boolean
+  updated_at: string
+}
+
+export interface KindCount {
+  kind: PRKind
+  count: number
+}
+
+export interface SubsystemCount {
+  subsystem: string
+  label: string
+  count: number
+}
+
+export const classificationApi = {
+  /** 单个 PR 的分类。详情页拿到的只有 PR id，没有仓库 id。 */
+  forPull: (pullId: string) =>
+    api.get<Classification | null>(`/pulls/${pullId}/classification`),
+
+  list: (repositoryId: string, filters: Record<string, string | number | boolean> = {}) => {
+    const params = new URLSearchParams()
+    for (const [key, value] of Object.entries(filters)) {
+      if (value === undefined || value === null || value === '') continue
+      params.set(key, String(value))
+    }
+    return api.get<Page<Classification>>(
+      `/repositories/${repositoryId}/classifications?${params.toString()}`,
+    )
+  },
+
+  kinds: (repositoryId: string, subjectType: SubjectType = 'pull_request') =>
+    api.get<KindCount[]>(
+      `/repositories/${repositoryId}/classifications/kinds?subject_type=${subjectType}`,
+    ),
+
+  subsystems: (repositoryId: string, limit = 15) =>
+    api.get<SubsystemCount[]>(
+      `/repositories/${repositoryId}/classifications/subsystems?limit=${limit}`,
+    ),
+
+  recompute: (repositoryId: string) =>
+    api.post<{ message: string }>(
+      `/repositories/${repositoryId}/classifications/recompute`,
+    ),
+
+  /** 人工指定分类。此后规则重算与 AI 补判都不会再改写这条记录。 */
+  override: (classificationId: string, kind: PRKind, subsystem?: string | null) =>
+    api.put<Classification>(`/classifications/${classificationId}`, { kind, subsystem }),
+
+  clearOverride: (classificationId: string) =>
+    api.delete<Classification>(`/classifications/${classificationId}/override`),
+}