PayrollManagementSystem/frontend/src/api/customers.ts

import { request } from './request'
import type { PageData } from './types'

/**
 * 客户列表项（对应后端 `CustomerOut`）。
 *
 * owner_personnel_name 由联表带出：归属人员不可考（被物理删除）时为 null，
 * owner_personnel_id 仍保留原值供追溯。
 */
export interface CustomerItem {
  id: number
  company_name: string
  /** 客户公司的负责人姓名（非系统内营销人员） */
  owner_name: string
  contact_person: string | null
  contact_phone: string | null
  address: string | null
  industry: string | null
  /** personal 个人户 / manager_personal 经理个人户 / enterprise 企业户（计提规则锚点） */
  customer_type: string
  owner_personnel_id: number | null
  owner_personnel_name: string | null
  remark: string | null
  /** 评级总分（0-100，评级计算器保存；null=未评分） */
  rating_score: number | null
  /** 最近评级时间（评级计算器保存评分时刷新；null=从未评级） */
  rating_time: string | null
}

export interface CustomerQueryParams {
  pageNum?: number
  pageSize?: number
  /** 公司名称或客户负责人，模糊匹配 */
  keyword?: string
  customer_type?: string
  owner_personnel_id?: number
  /** 排序键（后端白名单：id 建档序 / rating_score 评分），默认 id 倒序 */
  order_by?: 'id' | 'rating_score'
  /** 排序方向，默认 desc */
  order?: 'asc' | 'desc'
}

/** 新增客户（owner_personnel_id 为初始归属，可空：先建档后派归属也合法） */
export interface CustomerCreateParams {
  company_name: string
  owner_name: string
  contact_person?: string | null
  contact_phone?: string | null
  address?: string | null
  industry?: string | null
  customer_type: string
  owner_personnel_id?: number | null
  remark?: string | null
}

/**
 * 编辑客户：不含归属字段 —— 归属调整统一走 `PUT /{id}/ownership`
 * （唯一写归属留痕的入口），编辑表单即使提交归属也会被后端忽略。
 */
export type CustomerUpdateParams = Omit<CustomerCreateParams, 'owner_personnel_id'>

/** 归属变更入参（new_owner_personnel_id 空 = 清空归属） */
export interface CustomerOwnershipParams {
  new_owner_personnel_id?: number | null
  reason?: string | null
}

/** 保存评级入参：只存总分（五项明细不落库，评分是档案属性而非审计事件） */
export interface CustomerRatingParams {
  score: number
}

/** 归属变更留痕条目（对应后端 `OwnershipChangeLogOut`；姓名可随人员消失，ID 固化） */
export interface OwnershipLogItem {
  id: number
  customer_id: number
  old_owner_personnel_id: number | null
  new_owner_personnel_id: number | null
  old_owner_name: string | null
  new_owner_name: string | null
  change_reason: string | null
  operator_id: number | null
  operator_name: string
  create_time: string
}

/** 客户分类下拉项（与后端 `core/constants.py` 的值域一致） */
export const CUSTOMER_TYPE_OPTIONS = [
  { label: '个人户', value: 'personal' },
  { label: '经理个人户', value: 'manager_personal' },
  { label: '企业户', value: 'enterprise' },
] as const

/** 分类编码 → 展示名（表格列展示用，未知编码原样回显） */
export function customerTypeLabel(code: string): string {
  return CUSTOMER_TYPE_OPTIONS.find((o) => o.value === code)?.label ?? code
}

/** 分页查询客户（keyword 对公司名称/客户负责人模糊匹配，附归属人员姓名） */
export function listCustomers(params: CustomerQueryParams): Promise<PageData<CustomerItem>> {
  return request({ url: '/v1/base/customers', method: 'get', params })
}

/** 新增客户（公司名称+负责人组合唯一，冲突由后端拦截） */
export function createCustomer(data: CustomerCreateParams): Promise<CustomerItem> {
  return request({ url: '/v1/base/customers', method: 'post', data })
}

/** 编辑客户档案（不含归属；全量提交） */
export function updateCustomer(
  customerId: number,
  data: CustomerUpdateParams,
): Promise<CustomerItem> {
  return request({ url: `/v1/base/customers/${customerId}`, method: 'put', data })
}

/** 删除客户（物理删除） */
export function deleteCustomer(customerId: number): Promise<null> {
  return request({ url: `/v1/base/customers/${customerId}`, method: 'delete' })
}

/** 归属变更（唯一写归属留痕的入口；新旧相同后端报「归属未变化」） */
export function changeOwnership(
  customerId: number,
  data: CustomerOwnershipParams,
): Promise<CustomerItem> {
  return request({ url: `/v1/base/customers/${customerId}/ownership`, method: 'put', data })
}

/** 保存评级（评级计算器「保存评分」；只存总分与评级时间，评分只走本端点） */
export function rateCustomer(
  customerId: number,
  data: CustomerRatingParams,
): Promise<CustomerItem> {
  return request({ url: `/v1/base/customers/${customerId}/rating`, method: 'put', data })
}

/** 查某客户的归属变更留痕（分页，按变更时间倒序） */
export function listOwnershipLogs(
  customerId: number,
  params: { pageNum?: number; pageSize?: number },
): Promise<PageData<OwnershipLogItem>> {
  return request({
    url: `/v1/base/customers/${customerId}/ownership-logs`,
    method: 'get',
    params,
  })
}