// Copyright (c) 2025 Huawei Technologies Co., Ltd.
// openUBMC is licensed under Mulan PSL v2.
// You can use this software according to the terms and conditions of the Mulan PSL v2.
// You may obtain a copy of Mulan PSL v2 at:
//         http://license.coscl.org.cn/MulanPSL2
// THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
// EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
// MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
// See the Mulan PSL v2 for more details.
export type WorkbenchRole = 'maintainer' | 'committer' | 'contributor';
export type WorkbenchStatus = 'loading' | 'ready' | 'needs-config' | 'error';

// 统一的角色状态模型
export type RoleMode = 'primary' | 'manual' | 'function';

export interface ActiveRoleState {
  mode: RoleMode;
  role: WorkbenchRole;
  functionTag?: 'RM' | 'QA';
}

export interface UserRoleSnapshot {
  gitcodeId: string;
  userName: string;
  displayName: string;
  primaryRole: WorkbenchRole;
  isTcMember: boolean;
  maintainerSigs: string[];
  committerRepos: string[];
  sigRepos: Record<string, string[]>;
  allSigs: Array<{ name: string; isMaintainer: boolean; isCommitter: boolean; repos: string[] }>;
}

export type WorkflowStage =
  | 'todo'
  | 'in-progress'
  | 'review'
  | 'blocked'
  | 'waiting-acceptance'
  | 'done';

export type QueueId =
  | 'my-queue'
  | 'ready-for-coding'
  | 'waiting-on-review'
  | 'needs-triage'
  | 'needs-review'
  | 'blocked'
  | 'waiting-on-contributor';

export interface LinkedPr {
  number: number;
  title: string;
  status: 'none' | 'draft' | 'open' | 'needs-review' | 'merged' | 'closed';
  url?: string;
  updatedAt?: string;
}

export interface LocalWorkspaceState {
  hasLocalBranch: boolean;
  branchName?: string;
  hasUncommittedChanges: boolean;
  diffSummary?: string;
  suggestedFile?: string;
}

export interface WorkItem {
  id: string;
  role: WorkbenchRole;
  repo: string;
  queueId: QueueId;
  itemType: 'issue' | 'pr';
  issueNumber: number;
  issueTitle: string;
  issueUrl?: string;
  issueLabels: string[];
  /** 标签名(小写,与 issueLabels 同键)→ GitCode 平台配置的标签颜色(#RRGGBB)。
   *  供 PR 卡非门禁标签按平台配色渲染;无色标签/未采集时为 undefined。 */
  labelColors?: Record<string, string>;
  issueAssignees: string[];
  workflowStage: WorkflowStage;
  issueState: string;
  issueType: string;
  progressLabel: string;
  ageLabel: string;
  /** 创建人显示名(登录名或昵称),用于「创建人」列与卡片署名。 */
  author: string;
  /** 创建人 GitCode 登录名:行动分组据此区分「我的 Issue」(我创建)与「我负责的」(指派给我)。 */
  authorLogin?: string;
  /** PR 专属:我是该 PR 的评审人/测试人(非作者,来自 /user/pulls?scope=assigned_to_me)。
   *  行动分组据此进「我负责的 PR」(reviewPr)而非「我提交的 PR」。 */
  prAssigned?: boolean;
  /** 创建时间的短标签(如「06-20」或「3 天前」),用于「创建」列。 */
  createdLabel: string;
  /** 原始创建/更新时间(ISO 字符串),供排序用;ISO 8601 可直接字典序比较。 */
  createdAt?: string;
  updatedAt?: string;
  reason: string;
  nextAction: string;
  aiPrompt: string;
  linkedPr?: LinkedPr;
  isUnread?: boolean;
  unreadReason?: 'new' | 'updated';
  localState: LocalWorkspaceState;
  /** 由「一键拉取全部 issue」批量拉入的浏览项:进入侧栏浏览树与表格,但不进
   *  角色过滤的「今日」/行动视图,避免组织级海量 issue 淹没个人工作流。 */
  isBrowse?: boolean;
  /** 来源为「关注仓库」的条目(侧栏仓库行星标收藏):进「我关注的」分组,阻塞中升级「需要我处理」。
   *  归属判断(我提交的 Issue/PR)不受关注影响——自己的单子永远走个人归属分组。 */
  source?: 'followed';
  /** 该 issue 关联到的社区看板名称(一个 issue 可能在多个看板)。
   *  全量拉取时由看板倒排索引填充,单条刷新时由 issue 详情的 kanban_values 填充;未关联则为 undefined。 */
  kanbanNames?: string[];
}

/** 社区组织看板(版本看板,如「openUBMC 26.06 需求看板」)。 */
export interface KanbanBoard {
  id: string;
  name: string;
  status: number;
}

/** 看板上的一个条目(issue/PR),state 取自看板的 issueStatus 字段。 */
export interface KanbanCard {
  number: number;
  title: string;
  url?: string;
  repo: string;
  sourceType: 'issue' | 'pr';
  state: string;
  itype: string;
  sig?: string;
  assignee?: string;
  priority?: string;
  createdAt?: string;
  updatedAt?: string;
  /** 卡片所属看板名(仅在多选合并泳道时由 KanbanManager 打标,用于卡片上的来源徽标)。 */
  boardName?: string;
}

// ── Phase 2 日报对比类型 ──────────────────────────────────────

export interface DailyComparison {
  yesterdayDate: string;
  todayDate: string;
  summary: {
    yesterdayTotal: number;
    todayTotal: number;
    change: number;
    newCount: number;
    removedCount: number;
    statusChangedCount: number;
  };
  byDomain: Array<{ domain: string; yesterday: number; today: number; change: number }>;
  byDomainState?: Array<{
    domain: string;
    states: Array<{ state: string; today: number }>;
    yesterdayTotal: number;
    todayTotal: number;
    change: number;
  }>;
  stateDistribution: Array<{ state: string; yesterday: number; today: number; change: number }>;
  typeDistribution: Array<{ itype: string; yesterday: number; today: number; change: number }>;
  newItems: ChangeItem[];
  removedItems: ChangeItem[];
  changes: DetailChange[];
}

export interface ChangeItem {
  number: number;
  title: string;
  url: string;
  domain: string;
  assignee: string;
  state: string;
  itype: string;
  repo: string;
}

export interface DetailChange {
  number: number;
  title: string;
  url: string;
  type: 'state' | 'itype';
  from: string;
  to: string;
  domain: string;
  assignee: string;
  repo: string;
  itype: string;
}

// ── ─────────────────────────────────────────────────────────

export interface QueueDefinition {
  id: QueueId;
  title: string;
  description: string;
}

export interface QueueSection {
  queue: QueueDefinition;
  items: WorkItem[];
}

export interface RoleDashboard {
  role: WorkbenchRole;
  status: WorkbenchStatus;
  title: string;
  summary: string;
  currentUser?: string;
  organization?: string;
  remoteRepos: string[];
  remoteRepoError?: string;
  configuredRepos: string[];
  message?: string;
  lastUpdated?: string;
  totals: {
    totalItems: number;
    blockedItems: number;
    itemsWithPr: number;
    localWorkInProgress: number;
  };
  sections: QueueSection[];
}

export type LocalRepositoryRelation = 'official' | 'fork' | 'external';
export type ContributorTaskSectionId = 'continue' | 'start' | 'review' | 'blocked';

export interface LocalRepositoryInfo {
  folderName: string;
  repoFullName: string;
  officialRepoFullName?: string;
  localPath: string;
  remoteUrl: string;
  relation: LocalRepositoryRelation;
  isWorktree: boolean;
  localState: LocalWorkspaceState;
}

export interface CommunityOverview {
  organization: string;
  remoteRepoCount: number;
  monitoredRepoCount: number;
  configuredRepoCount: number;
  localRepoCount: number;
  officialLocalRepoCount: number;
  forkLocalRepoCount: number;
  externalLocalRepoCount: number;
  remoteOnlyRepoCount: number;
}

export interface CurrentWorkspaceContext {
  folderName: string;
  repoFullName: string;
  officialRepoFullName?: string;
  relation: LocalRepositoryRelation;
  isWorktree: boolean;
  localPath: string;
  localState: LocalWorkspaceState;
  summary: string;
  nextAction: string;
  relatedTaskCount: number;
  topTask?: WorkItem;
}

export interface ContributorTaskSection {
  id: ContributorTaskSectionId;
  title: string;
  description: string;
  items: WorkItem[];
}

export interface ContributorWorkbenchSnapshot {
  status: WorkbenchStatus;
  title: string;
  summary: string;
  currentUser?: string;
  message?: string;
  lastUpdated?: string;
  tokenConfigured: boolean;
  roles?: UserRoleSnapshot;
  demoRole?: string;
  /** 当前角色视角(维护者/审核者/贡献者);undefined = 由 UI 取默认视角。 */
  viewRole?: WorkbenchRole;
  overview: CommunityOverview;
  currentRepo?: CurrentWorkspaceContext;
  taskSections: ContributorTaskSection[];
  activeSigs: string[];
  monitoredRepos: string[];
  configuredRepos: string[];
  remoteRepos: string[];
  remoteRepoError?: string;
  localRepositories: LocalRepositoryInfo[];
  aiAssistant?: string;
  /** 建单表单用:按 Issue 类型(需求/缺陷/任务)提供来自 openUBMC/.gitcode 的模板。 */
  issueTemplates?: Record<string, { titlePrefix: string; labels: string[]; body: string }>;
  /** 按编号搜索态:taskSections 为搜索结果,UI 显示"搜索 #id 结果 + 清除"。 */
  searchActive?: boolean;
  searchIds?: number[];
  /** 全量 issue 是否正在拉取中(表格按钮显示加载态)。 */
  loadingAllOrgIssues?: boolean;
  /** 「拉取全部 issue」进度(按仓计数):按钮显示 拉取中(done/total)。拉取结束即清除。 */
  allOrgIssuesProgress?: { done: number; total: number };
  /** 是否已执行过「拉取全部 issue」(按钮文案显示「重新拉取」)。 */
  pulledAllOrgIssues?: boolean;
  /** 刷新或拉取全部进行中:二者互斥,UI 据此禁用对方按钮。 */
  syncing?: boolean;
  /** 最近一次全量刷新的完成汇总(去重后的 issue/PR 数量;at 为完成时间戳,webview 据此去重弹 toast)。 */
  refreshSummary?: { issues: number; prs: number; at: string };
}