@kernel-sig/console 0.1.0

package/frontend/src/api/issues.ts

@@ -0,0 +1,90 @@
+import type { PRKind } from '@/api/classification'
+import { api } from '@/lib/api-client'
+
+export interface IssueSummary {
+  id: string
+  number: number
+  title: string
+  state: string
+  issue_type: string | null
+  issue_state: string | null
+  priority_label: string | null
+  author_login: string | null
+  assignee_login: string | null
+  label_names: string[] | null
+  comments_count: number
+  atomgit_created_at: string | null
+  atomgit_updated_at: string | null
+  html_url: string | null
+}
+
+export interface IssueListItem extends IssueSummary {
+  /** 内容类别。null 表示尚无分类记录。 */
+  kind: PRKind | null
+}
+
+export interface IssueDetail extends IssueSummary {
+  body: string | null
+  finished_at: string | null
+}
+
+export interface FacetValue {
+  value: string
+  count: number
+}
+
+export interface IssueFacets {
+  types: FacetValue[]
+  priorities: FacetValue[]
+  states: FacetValue[]
+}
+
+export interface Page<T> {
+  items: T[]
+  total: number
+  page: number
+  per_page: number
+}
+
+/** AtomGit 的 issue_type 是中文原生值，直接展示即可，无需映射。 */
+export const ISSUE_STATE_TONE: Record<string, 'success' | 'warning' | 'neutral'> = {
+  新建: 'warning',
+  已确认: 'warning',
+  已完成: 'success',
+  已拒绝: 'neutral',
+  已挂起: 'neutral',
+}
+
+export interface IssueFilters {
+  state?: string
+  issue_type?: string
+  kind?: PRKind[]
+  priority?: string
+  author?: string
+  assignee?: string
+  label?: string
+  q?: string
+  sort?: string
+  order?: 'asc' | 'desc'
+  page?: number
+  per_page?: number
+}
+
+function toQuery(filters: IssueFilters): string {
+  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 params.toString()
+}
+
+export const issuesApi = {
+  list: (repositoryId: string, filters: IssueFilters) =>
+    api.get<Page<IssueListItem>>(`/repositories/${repositoryId}/issues?${toQuery(filters)}`),
+
+  detail: (issueId: string) => api.get<IssueDetail>(`/issues/${issueId}`),
+
+  facets: (repositoryId: string) =>
+    api.get<IssueFacets>(`/repositories/${repositoryId}/issues/facets`),
+}

package/frontend/src/api/pulls.ts

@@ -0,0 +1,233 @@
+import type { PRKind } from '@/api/classification'
+import { api } from '@/lib/api-client'
+
+export type GateStage =
+  | 'draft'
+  | 'cla_pending'
+  | 'cla_denied'
+  | 'ci_pending'
+  | 'ci_running'
+  | 'ci_failed'
+  | 'needs_issue'
+  | 'review_pending'
+  | 'rejected'
+  | 'ready_to_merge'
+  | 'merged'
+  | 'closed'
+
+/** 门禁阶段的中文标签与语义色。集中定义，避免各处硬编码。 */
+export const GATE_STAGE_META: Record<GateStage, { label: string; tone: BadgeTone }> = {
+  draft: { label: '草稿', tone: 'neutral' },
+  cla_pending: { label: '待 CLA', tone: 'warning' },
+  cla_denied: { label: 'CLA 未通过', tone: 'danger' },
+  ci_pending: { label: 'CI 未完成', tone: 'neutral' },
+  ci_running: { label: 'CI 进行中', tone: 'info' },
+  ci_failed: { label: 'CI 失败', tone: 'danger' },
+  needs_issue: { label: '缺关联 Issue', tone: 'warning' },
+  review_pending: { label: '待评审', tone: 'warning' },
+  rejected: { label: '已被 NACK', tone: 'danger' },
+  ready_to_merge: { label: '可合入', tone: 'success' },
+  merged: { label: '已合并', tone: 'accent' },
+  closed: { label: '已关闭', tone: 'neutral' },
+}
+
+type BadgeTone = 'neutral' | 'success' | 'warning' | 'danger' | 'info' | 'accent'
+
+export interface PullSummary {
+  id: string
+  repository_id: string
+  number: number
+  title: string
+  state: string
+  draft: boolean
+  author_login: string | null
+  author_avatar_url: string | null
+  target_branch: string | null
+  label_names: string[] | null
+  added_lines: number
+  removed_lines: number
+  changed_files: number
+  comments_count: number
+  gate_stage: GateStage
+  merge_conflict: boolean
+  atomgit_created_at: string | null
+  atomgit_updated_at: string | null
+  merged_at: string | null
+  html_url: string | null
+  /** 内容类别。null 表示尚无分类记录，与 'unknown'（已分类但判不出来）不同。 */
+  kind: PRKind | null
+}
+
+export interface PRCommit {
+  sha: string
+  sequence: number
+  subject: string
+  author_name: string | null
+  author_email: string | null
+  committed_at: string | null
+  signed_off_bys: string[] | null
+}
+
+export interface PRFile {
+  filename: string
+  status: string | null
+  additions: number
+  deletions: number
+  is_binary: boolean
+  too_large: boolean
+  diff: string | null
+}
+
+export interface ReviewEvent {
+  event_type: string
+  actor_login: string
+  source: string
+  occurred_at: string
+}
+
+/**
+ * 上游标签。
+ *
+ * `color` 是 AtomGit 的十六进制字面量，可能缺失或非法 ——
+ * 上游该字段是自由文本，不能假设它一定可解析。
+ */
+export interface PRLabel {
+  name: string
+  color: string | null
+}
+
+/**
+ * 上游评论原文。
+ *
+ * `body` 是 AtomGit 返回的原始文本，其中可能含 HTML 表格与裸链接 ——
+ * 渲染时必须按纯文本处理，不能交给 innerHTML。
+ * `is_bot` 由服务端判定，前端不重复实现机器人识别。
+ */
+export interface PRComment {
+  comment_id: string
+  comment_type: string | null
+  author_login: string
+  author_avatar_url: string | null
+  body: string
+  atomgit_created_at: string | null
+  is_bot: boolean
+}
+
+export interface PullDetail extends PullSummary {
+  body: string | null
+  source_branch: string | null
+  mergeable: boolean | null
+  mergeable_detail: Record<string, unknown> | null
+  blocking_reasons: string[]
+  ready_to_merge: boolean
+  lgtm_actors: string[]
+  labels: PRLabel[]
+  commits: PRCommit[]
+  files: PRFile[]
+  review_events: ReviewEvent[]
+  comments: PRComment[]
+}
+
+export interface StageCount {
+  stage: GateStage
+  count: number
+}
+
+export interface Page<T> {
+  items: T[]
+  total: number
+  page: number
+  per_page: number
+}
+
+export interface PullFilters {
+  state?: string
+  stage?: string[]
+  branch?: string[]
+  author?: string[]
+  label?: string
+  kind?: PRKind[]
+  attention?: string[]
+  draft?: boolean
+  has_conflict?: boolean
+  q?: string
+  /** 只看等待超过 N 天的（按创建时间算）。首页「超 30 天未评审」用它。 */
+  waiting_days_gte?: number
+  sort?: string
+  order?: 'asc' | 'desc'
+  page?: number
+  per_page?: number
+}
+
+export interface FacetValue {
+  value: string
+  /** 原始值。展示名由前端按维度查表得到，避免两处各维护一份标签。 */
+  label: string
+  count: number
+  selected: boolean
+}
+
+export interface Facet {
+  key: string
+  label: string
+  values: FacetValue[]
+}
+
+export interface FacetResponse {
+  total: number
+  facets: Facet[]
+}
+
+/** 分面筛选维度。与后端 `pull_query.DIMENSIONS` 一致。 */
+export const FACET_KEYS = ['stage', 'kind', 'branch', 'author', 'attention'] as const
+export type FacetKey = (typeof FACET_KEYS)[number]
+
+function toQuery(filters: PullFilters): string {
+  const params = new URLSearchParams()
+  for (const [key, value] of Object.entries(filters)) {
+    if (value === undefined || value === null || value === '') continue
+    if (Array.isArray(value)) {
+      // 数组参数重复出现，与 FastAPI 的 list[str] 查询参数约定一致
+      for (const item of value) params.append(key, item)
+    } else {
+      params.set(key, String(value))
+    }
+  }
+  return params.toString()
+}
+
+export const pullsApi = {
+  list: (repositoryId: string, filters: PullFilters) =>
+    api.get<Page<PullSummary>>(
+      `/repositories/${repositoryId}/pulls?${toQuery(filters)}`,
+    ),
+
+  detail: (pullId: string) => api.get<PullDetail>(`/pulls/${pullId}`),
+
+  /**
+   * 各维度的取值与计数。
+   *
+   * 计数不含该维度自身的筛选，因此勾选之后其余各栏仍然可用 ——
+   * 这是分面浏览与普通筛选器的分界。
+   */
+  facets: (repositoryId: string, filters: PullFilters) =>
+    api.get<FacetResponse>(
+      `/repositories/${repositoryId}/pulls/facets?${toQuery(filters)}`,
+    ),
+
+  stageCounts: (repositoryId: string, state = 'open') =>
+    api.get<StageCount[]>(
+      `/repositories/${repositoryId}/pulls/stage-counts?state=${state}`,
+    ),
+
+  branches: (repositoryId: string) =>
+    api.get<string[]>(`/repositories/${repositoryId}/pulls/branches`),
+
+  authors: (repositoryId: string) =>
+    api.get<string[]>(`/repositories/${repositoryId}/pulls/authors`),
+
+  stale: (repositoryId: string, days = 30) =>
+    api.get<PullSummary[]>(
+      `/repositories/${repositoryId}/pulls/stale?days=${days}&limit=50`,
+    ),
+}

package/frontend/src/api/repositories.ts

@@ -0,0 +1,95 @@
+import { api } from '@/lib/api-client'
+
+export type CredentialKind = 'atomgit_token' | 'llm_api_key'
+
+/** 凭据对外视图。**不含明文**，只有指纹。 */
+export interface Credential {
+  id: string
+  name: string
+  kind: CredentialKind
+  fingerprint: string
+  meta: Record<string, unknown> | null
+  last_verified_at: string | null
+  last_verify_error: string | null
+  created_at: string
+}
+
+/**
+ * 仓库在地址栏与界面里的标识。
+ *
+ * 用 `owner/name` 而不是展示名或 id：它稳定、唯一、可读，而且是仓库在任何
+ * 地方的正式名字 —— 展示名可以改，id 没法看。
+ */
+export function repoKey(repo: { owner: string; name: string }): string {
+  return `${repo.owner}/${repo.name}`
+}
+
+export interface Repository {
+  id: string
+  owner: string
+  name: string
+  display_name: string | null
+  api_base_url: string
+  credential_id: string | null
+  default_branch: string | null
+  tracked_branches: string[] | null
+  sync_enabled: boolean
+  sync_interval_seconds: number
+  backfill_days: number
+  last_sync_at: string | null
+  last_sync_error: string | null
+  created_at: string
+  webhook_path: string | null
+  pull_count: number | null
+  issue_count: number | null
+}
+
+export interface SyncRun {
+  id: number
+  resource: string
+  trigger: string
+  status: string
+  started_at: string
+  finished_at: string | null
+  api_calls: number
+  items_fetched: number
+  items_created: number
+  items_updated: number
+  items_failed: number
+  error: string | null
+}
+
+export const repositoriesApi = {
+  list: () => api.get<Repository[]>('/repositories'),
+
+  create: (payload: {
+    owner: string
+    name: string
+    credential_id: string
+    display_name?: string
+    api_base_url?: string
+  }) => api.post<Repository>('/repositories', payload),
+
+  sync: (repositoryId: string, detailLimit = 50) =>
+    api.post<SyncRun[]>(
+      `/repositories/${repositoryId}/sync?detail_limit=${detailLimit}`,
+    ),
+
+  syncRuns: (repositoryId: string) =>
+    api.get<{ items: SyncRun[] }>(`/repositories/${repositoryId}/sync-runs`),
+}
+
+export const credentialsApi = {
+  list: () => api.get<Credential[]>('/credentials'),
+
+  create: (payload: { name: string; kind: CredentialKind; value: string }) =>
+    api.post<Credential>('/credentials', payload),
+
+  verify: (credentialId: string) =>
+    api.post<Credential>(`/credentials/${credentialId}/verify`),
+
+  rotate: (credentialId: string, value: string) =>
+    api.post<Credential>(`/credentials/${credentialId}/rotate`, { value }),
+
+  remove: (credentialId: string) => api.delete<void>(`/credentials/${credentialId}`),
+}

package/frontend/src/api/sig.ts

@@ -0,0 +1,232 @@
+import type { PRKind } from '@/api/classification'
+import { api } from '@/lib/api-client'
+
+/** 分支/版本的产品线。与后端 `domain.release.BranchKind` 一致。 */
+export type BranchKind = 'olk' | 'lts' | 'innovation' | 'other'
+
+export const BRANCH_KIND_META: Record<BranchKind, { label: string; hint: string }> = {
+  olk: {
+    label: 'OLK 长期维护',
+    hint: 'openEuler Long-term support Kernel，维护期最长，KABI 有白名单约束',
+  },
+  lts: { label: '发行版 LTS', hint: '随 openEuler LTS 发行版交付，按 SP 迭代' },
+  innovation: { label: '创新版本', hint: '新技术验证，维护期短，不用于生产' },
+  other: { label: '其他分支', hint: '临时分支或尚未归类' },
+}
+
+/** 分支生命周期。来自登记表，未登记的一律按 active 展示。 */
+export const BRANCH_STATE_META: Record<string, { label: string; tone: string }> = {
+  active: { label: '维护中', tone: 'success' },
+  maintenance: { label: '仅安全修复', tone: 'warning' },
+  eol: { label: '已停止维护', tone: 'neutral' },
+}
+
+export interface BranchSummary {
+  name: string
+  /** 库中实际出现过的写法。构造 PR 列表链接时用它做筛选值。 */
+  raw_names: string[]
+  kind: BranchKind
+  series: string | null
+  sp: number | null
+  upstream_base: string | null
+  state: string
+  note: string | null
+  /** 分支负责人账号，来自 openeuler/community 的 sig-info.yaml。 */
+  keepers: string[]
+  open_count: number
+  merged_count: number
+  merged_recent: number
+  last_merged_at: string | null
+  latest_tag: string | null
+  last_report_on: string | null
+}
+
+export interface MergeBucket {
+  label: string
+  start: string
+  end: string
+  total: number
+  by_kind: Record<string, number>
+}
+
+export interface PeriodSummary {
+  label: string
+  start: string
+  end: string
+  total: number
+  cve_count: number
+  by_branch: Record<string, number>
+  by_kind: Record<string, number>
+  top_contributors: [string, number][]
+}
+
+export interface ReleaseReport {
+  id: string
+  branch: string
+  from_tag: string | null
+  to_tag: string | null
+  patch_count: number | null
+  listed_count: number
+  iso_urls: string[] | null
+  cve_ids: string[] | null
+  groups: { name: string; count: number | null }[] | null
+  meeting_held_on: string | null
+}
+
+export interface ReleasePatch {
+  sequence: number
+  group_name: string | null
+  title: string
+  pull_number: number | null
+  url: string | null
+}
+
+export type MeetingStatus = 'scheduled' | 'done' | 'cancelled'
+
+export const MEETING_STATUS_META: Record<MeetingStatus, { label: string; tone: string }> = {
+  scheduled: { label: '待召开', tone: 'info' },
+  done: { label: '已召开', tone: 'success' },
+  cancelled: { label: '已取消', tone: 'neutral' },
+}
+
+export interface MeetingSummary {
+  id: string
+  held_on: string
+  start_time: string | null
+  title: string
+  host: string | null
+  next_host: string | null
+  host_order: string[] | null
+  meeting_url: string | null
+  minutes_url: string | null
+  status: MeetingStatus
+  agenda_count: number
+  report_count: number
+}
+
+/** 议题里引用的 PR。`id` 为 null 表示本地库里没有这条 PR（编号可能来自别处）。 */
+export interface PullRef {
+  number: number
+  id: string | null
+  title: string | null
+  state: string | null
+  kind: PRKind | null
+}
+
+export interface MeetingAgenda {
+  id: string
+  sequence: number
+  num: string | null
+  title: string
+  owner: string | null
+  body: string | null
+  pull_numbers: number[] | null
+  issue_numbers: number[] | null
+  pull_refs: PullRef[]
+}
+
+export interface MeetingDetail extends MeetingSummary {
+  legacy: string | null
+  agendas: MeetingAgenda[]
+  reports: ReleaseReport[]
+}
+
+export interface Member {
+  id: string
+  name: string
+  role: 'maintainer' | 'committer' | 'contributor'
+  atomgit_id: string | null
+  gitee_id: string | null
+  github_id: string | null
+  email: string | null
+  org: string | null
+  is_active: boolean
+}
+
+export const MEMBER_ROLE_META: Record<string, { label: string; hint: string }> = {
+  maintainer: { label: 'Maintainer', hint: '负责版本方向与最终合入决策' },
+  committer: { label: 'Committer', hint: '负责所辖模块的补丁评审与合入' },
+  contributor: { label: 'Contributor', hint: '参与贡献' },
+}
+
+export interface MemberStats {
+  login: string
+  name: string | null
+  role: string | null
+  authored: number
+  merged: number
+  reviews: number
+  subsystems: string[]
+}
+
+export interface SubsystemOwner {
+  id: string
+  module: string
+  section: string | null
+  paths: string[] | null
+  committer_logins: string[] | null
+}
+
+export const sigApi = {
+  branches: (repositoryId: string) =>
+    api.get<BranchSummary[]>(`/repositories/${repositoryId}/branches`),
+
+  branchTimeline: (
+    repositoryId: string,
+    branch: string,
+    granularity: 'month' | 'biweek' = 'month',
+    buckets = 12,
+  ) =>
+    api.get<MergeBucket[]>(
+      `/repositories/${repositoryId}/branches/${encodeURIComponent(branch)}/timeline` +
+        `?granularity=${granularity}&buckets=${buckets}`,
+    ),
+
+  /**
+   * 最近若干期的合入总结，新的在前。只含已结束的周期 ——
+   * 当前周期还没过完，拿它做总结会得到一个每刷新一次就变大的数字。
+   */
+  branchPeriods: (
+    repositoryId: string,
+    branch: string,
+    granularity: 'month' | 'biweek' = 'month',
+    count = 6,
+  ) =>
+    api.get<PeriodSummary[]>(
+      `/repositories/${repositoryId}/branches/${encodeURIComponent(branch)}/periods` +
+        `?granularity=${granularity}&count=${count}`,
+    ),
+
+  releaseNotes: (repositoryId: string, branch?: string, limit = 20) => {
+    const params = new URLSearchParams({ limit: String(limit) })
+    if (branch) params.set('branch', branch)
+    return api.get<ReleaseReport[]>(`/repositories/${repositoryId}/releases/notes?${params}`)
+  },
+
+  reportPatches: (reportId: string) => api.get<ReleasePatch[]>(`/releases/reports/${reportId}/patches`),
+
+  meetings: (status?: MeetingStatus, limit = 50) => {
+    const params = new URLSearchParams({ limit: String(limit) })
+    if (status) params.set('status', status)
+    return api.get<MeetingSummary[]>(`/meetings?${params}`)
+  },
+
+  meeting: (meetingId: string) => api.get<MeetingDetail>(`/meetings/${meetingId}`),
+
+  syncMeetings: () => api.post<{ message: string }>('/meetings/sync'),
+
+  members: (role?: string) => {
+    const params = role ? `?role=${role}` : ''
+    return api.get<Member[]>(`/members${params}`)
+  },
+
+  memberStats: (repositoryId?: string, limit = 50) => {
+    const params = new URLSearchParams({ limit: String(limit) })
+    if (repositoryId) params.set('repository_id', repositoryId)
+    return api.get<MemberStats[]>(`/members/stats?${params}`)
+  },
+
+  subsystemOwners: () => api.get<SubsystemOwner[]>('/subsystem-owners'),
+}
+
+export type { PRKind }