xiaoshu-app/projects/xiaoshu-admin/src/app/admin.models.ts

export interface ParsePointer {
  __type: 'Pointer';
  className: string;
  objectId: string;
}

export interface AdminIdentity {
  objectId: string;
  username: string;
  displayName: string;
  company?: ParsePointer;
  roles: string[];
  isSuperAdmin: boolean;
  operationsRole: OperationsRole;
}

export interface AdminSession {
  objectId: string;
  username: string;
  sessionToken: string;
  company?: ParsePointer;
  displayName?: string;
  roles?: string[];
  isSuperAdmin?: boolean;
  operationsRole?: OperationsRole;
}

export type OperationsRole = 'ops-manager' | 'ops-staff' | 'ops-auditor';

export interface CloudEnvelope<T> {
  success: boolean;
  data: T;
  error?: string;
  message?: string;
}

export interface LegacyCloudEnvelope<T> {
  retcode: number;
  retmsg?: string;
  result: T;
}

export interface AppMigrationStatus {
  implemented: string[];
  blocked: Record<string, string>;
}

export interface AdminResourceCatalogItem {
  className: string;
  label: string;
  writable: boolean;
  route: string;
}

export interface AdminResourceCatalog {
  total: number;
  resources: AdminResourceCatalogItem[];
}

export interface AdminFieldSchema {
  name: string;
  type: string;
  targetClass?: string;
  required?: boolean;
  writable: boolean;
}

export interface AdminClassSchema {
  className: string;
  label: string;
  fields: AdminFieldSchema[];
  writable: boolean;
  creatable?: boolean;
  supportsSoftDelete: boolean;
}

export interface ResourcePage {
  className: string;
  page: number;
  pageSize: number;
  total: number;
  results: Record<string, unknown>[];
}

export interface DashboardMetric {
  className: string;
  label: string;
  count: number;
  route: string;
}

export interface DashboardData {
  identity: AdminIdentity;
  metrics: DashboardMetric[];
  migration: {
    sourceObjects: number;
    migratedClasses: number;
    registeredRecords: number;
    cloudFunctions: number;
  };
}

export interface OperationsPage<T extends Record<string, unknown> = Record<string, unknown>> {
  page: number;
  pageSize: number;
  total: number;
  items: T[];
  refreshedAt?: string;
}

export type LegacySyncHealth = 'healthy' | 'delayed' | 'error' | 'not_configured' | 'never_synced';

export interface LegacySyncDataset extends Record<string, unknown> {
  key: string;
  label: string;
  legacyCount: number | null;
  parseCount: number;
  difference: number | null;
  cursor: string;
  lastSuccessAt: string;
  lastAttemptAt: string;
  lagSeconds: number | null;
  health: LegacySyncHealth;
  healthLabel: string;
  pendingFailures: number;
  conflicts: number;
  checksum?: string;
}

export interface LegacySyncStatus {
  configured: boolean;
  bridgeReachable: boolean;
  bridgeUrl: string;
  manifestTime: string;
  serverTime: string;
  refreshedAt: string;
  overallHealth: LegacySyncHealth;
  overallHealthLabel: string;
  totalFailures: number;
  totalConflicts: number;
  datasets: LegacySyncDataset[];
  message: string;
}

export interface LegacySyncRunResult {
  dataset: string;
  processed: number;
  created: number;
  updated: number;
  deleted: number;
  conflicts: number;
  failures: number;
  hasMore: boolean;
  cursor: string;
  startedAt: string;
  finishedAt: string;
  pages?: number;
}

export interface OperationsSyncIndicator {
  state: 'synced' | 'delayed' | 'not_configured';
  label: string;
  lastSuccessAt: string;
  lagSeconds: number | null;
}

export interface MemberSummary {
  total: number;
  todayNew: number;
  sevenDayNew: number;
  studying: number;
  followUp: number;
}

export interface MemberAgentOption extends Record<string, unknown> {
  objectId: string;
  userId: number;
  displayName: string;
}

export interface MemberPage extends OperationsPage<OperationsUser> {
  summary: MemberSummary;
  agents: MemberAgentOption[];
  sync?: OperationsSyncIndicator;
  sourceStatus?: {
    available: boolean;
    message: string;
    total: number;
    memberCount: number;
    coachEvidenceCount: number;
    storeCount: number;
    unknownCount: number;
    refreshedAt: string;
  };
}

export interface MemberImportPreviewRow {
  rowNumber: number;
  displayName: string;
  nickname: string;
  mobileMasked: string;
  gender: string;
  grade: string;
  parentUserId: number;
  action: 'create' | 'resumed' | 'error';
  issues: string[];
}

export interface MemberImportPreview {
  batchId: string;
  fileName: string;
  expiresAt: string;
  summary: { total: number; create: number; resumed: number; error: number };
  rows: MemberImportPreviewRow[];
}

export interface MemberImportResult {
  batchId: string;
  total: number;
  created: number;
  resumed: number;
  items: Array<{ objectId: string; userId: number; displayName: string; mobileMasked: string; resumed: boolean }>;
}

export interface MemberListSort {
  field: 'registeredAt' | 'lastLoginAt' | 'lastLessonAt' | 'nextAppointmentAt' | 'remainingPeriods';
  direction: 'asc' | 'desc';
}

export interface OperationsDashboardMetric {
  key: string;
  label: string;
  value: number;
  hint: string;
  route: string;
  tone: 'blue' | 'green' | 'amber' | 'rose';
}

export type ScheduleTrendPeriod = 'week' | 'month' | 'year';

export interface ScheduleTrendPoint {
  key: string;
  label: string;
  shortLabel: string;
  courseCount: number;
  studentCount: number;
  completedCount: number;
  isToday: boolean;
}

export interface ScheduleTrendData {
  period: ScheduleTrendPeriod;
  periodLabel: string;
  dateFrom: string;
  dateTo: string;
  points: ScheduleTrendPoint[];
  todayCourseCount: number;
  todayStudentCount: number;
  totalCourseCount: number;
  totalStudentCount: number;
  maxValue: number;
  refreshedAt: string;
  liveSourceAvailable: boolean;
  liveSourceMessage: string;
}

export interface OperationsDashboardData {
  identity: AdminIdentity;
  date: string;
  metrics: OperationsDashboardMetric[];
  alerts: { key: string; label: string; value: number; route: string }[];
  refreshedAt?: string;
  liveSourceAvailable?: boolean;
  liveSourceMessage?: string;
  scheduleTrend?: ScheduleTrendData;
  sync?: OperationsSyncIndicator;
  payroll?: {
    month: string;
    coachCount: number;
    lessonCount: number;
    payableAmount: number;
    sourceStatus: PayrollSourceStatus;
    refreshedAt: string;
  };
}

export interface OperationsUser extends Record<string, unknown> {
  objectId: string;
  userId: number;
  displayName: string;
  username: string;
  mobile: string;
  mobileMasked: string;
  groupId: number;
  groupName: string;
  parentUserId: number;
  parentDisplayName: string;
  periods30: number;
  periods60: number;
  trialPeriods: number;
  activeCourseCount: number;
  completedCourseCount: number;
  studyRecordCount: number;
  appointmentCount: number;
  learningStatus: 'trial' | 'studying' | 'completed' | 'not_started';
  learningStatusLabel: string;
  learningStatusReason: string;
  registeredAt: string;
  lastLoginAt: string;
  loginCount: number;
  status: 'active' | 'disabled';
  statusLabel: string;
  canRevealMobile: boolean;
  updatedAt: string;
  nickname?: string;
  lastLessonAt?: string;
  nextAppointmentAt?: string;
  riskFlags?: string[];
  identityType?: 'member';
  gender?: string;
  grade?: string;
  noteCount?: number;
  liveOnly?: boolean;
  writeReady?: boolean;
  dataSource?: 'parse' | 'legacy-live';
  readOnlyReason?: string;
}

export interface OperationsUserDetail extends OperationsUser {
  email: string;
  balances: {
    purse: number;
    silverCoin: number;
    userExp: number;
    userPoint: number;
    dummyPurse: number;
    credit: number;
  };
  relation: { parentUserId: number; parentDisplayName: string };
  permissions: { canManage: boolean; canEdit: boolean; canAdjustBalance: boolean; canResetPassword: boolean; canRevealMobile: boolean };
  agents: MemberAgentOption[];
}

export interface CoachSummary extends Record<string, unknown> {
  objectId: string;
  userId: number;
  username: string;
  displayName: string;
  mobile: string;
  mobileMasked: string;
  parentUserId: number;
  storeName: string;
  status: 'active' | 'disabled';
  statusLabel: string;
  todayAppointments: number;
  pendingAppointments: number;
  totalAppointments: number;
  lastAppointmentAt: string;
  nextAppointmentAt?: string;
  monthLessons: number;
  monthHours: number;
  estimatedPay: number;
  averageScore: number;
  lastLessonAt: string;
  availabilityConfigured: boolean;
  updatedAt: string;
  source?: 'hybrid' | 'legacy-live';
  sourceLabel?: string;
  readOnly?: boolean;
  registeredAt?: string;
  hasCurrentBusiness?: boolean;
}

export interface CoachPageSummary extends Record<string, unknown> {
  total: number;
  active: number;
  disabled: number;
  monthActive: number;
  liveOnly: number;
}

export interface StoreSummary extends Record<string, unknown> {
  objectId: string;
  userId: number;
  username: string;
  storeName: string;
  contactName: string;
  mobile: string;
  mobileMasked: string;
  parentStoreId: number;
  parentStoreName: string;
  memberCount: number;
  coachCount: number;
  todayAppointments: number;
  totalAppointments: number;
  lastAppointmentAt: string;
  registeredAt: string;
  lastLoginAt: string;
  loginCount: number;
  status: 'active' | 'disabled';
  statusLabel: string;
  updatedAt: string;
  source?: 'parse' | 'hybrid' | 'legacy-live';
  sourceLabel?: string;
  readOnly?: boolean;
}

export interface StoreOption extends Record<string, unknown> {
  objectId: string;
  userId: number;
  displayName: string;
}

export interface StorePage extends OperationsPage<StoreSummary> {
  canManage: boolean;
  summary: {
    total: number;
    active: number;
    disabled: number;
    members: number;
    coaches: number;
    todayAppointments: number;
    liveOnly?: number;
  };
  parents: StoreOption[];
  liveSourceAvailable?: boolean;
  liveSourceMessage?: string;
  legacyStoreCount?: number;
  sync?: OperationsSyncIndicator;
}

export interface StoreCourseSummary extends Record<string, unknown> {
  courseId: number;
  courseName: string;
  appointmentCount: number;
  completedCount: number;
  studentCount: number;
  completionRate: number;
  lastAppointmentAt: string;
}

export interface StoreDetailData extends Record<string, unknown> {
  store: StoreSummary;
  month: string;
  summary: {
    memberCount: number;
    coachCount: number;
    monthAppointments: number;
    completedAppointments: number;
    activeStudents: number;
    lessonCount: number;
    totalHours: number;
    estimatedCoachPay: number;
  };
  members: OperationsUser[];
  coaches: CoachSummary[];
  appointments: ScheduleAppointment[];
  courses: StoreCourseSummary[];
  commissionStatus: {
    available: boolean;
    message: string;
  };
  payrollSourceStatus: PayrollSourceStatus;
  refreshedAt: string;
  sync?: OperationsSyncIndicator;
}

export interface CoachStoreOption extends Record<string, unknown> {
  objectId: string;
  userId: number;
  displayName: string;
}

export interface CoachPage extends OperationsPage<CoachSummary> {
  summary: CoachPageSummary;
  canManage: boolean;
  stores: CoachStoreOption[];
  liveSourceAvailable?: boolean;
  liveSourceMessage?: string;
  liveSourceCount?: number;
  dataDateFrom?: string;
  dataDateTo?: string;
  payrollMonth?: string;
  payrollSourceStatus?: PayrollSourceStatus;
  payrollRefreshedAt?: string;
  sync?: OperationsSyncIndicator;
}

export interface ScheduleAppointment extends Record<string, unknown> {
  targetId: string;
  generalId: number;
  studentObjectId: string;
  studentId: number;
  studentName: string;
  coachObjectId: string;
  coachId: number;
  coachName: string;
  courseId: number;
  courseName: string;
  classType: number;
  classTypeLabel: string;
  deliveryMethod: string;
  startsAt: string;
  endsAt: string;
  statusCode: number;
  statusLabel: string;
  cancelled: boolean;
  cancellationReason: string;
  coachAccountMissing: boolean;
  availabilityWarning: boolean;
  source: 'parse' | 'legacy-live';
  sourceLabel: string;
  readOnly: boolean;
  updatedAt: string;
}

export interface ScheduleCalendarData {
  dateFrom: string;
  dateTo: string;
  refreshedAt: string;
  totalAppointments: number;
  dataDateFrom: string;
  dataDateTo: string;
  liveSourceAvailable: boolean;
  liveSourceMessage: string;
  liveSourceCount: number;
  coaches: CoachSummary[];
  appointments: ScheduleAppointment[];
  unassigned: ScheduleAppointment[];
  members: Array<{ objectId: string; userId: number; displayName: string; mobileMasked: string; periods30: number; periods60: number; trialPeriods: number; userPoint: number; learningStatusLabel: string; liveOnly?: boolean; writeReady?: boolean; readOnly?: boolean; readOnlyReason?: string }>;
  courses: Array<{ courseId: number; courseName: string; memberIds: number[]; availableToAll?: boolean }>;
  sync?: OperationsSyncIndicator;
}

export interface CoachAvailability extends Record<string, unknown> {
  objectId: string;
  coachId: number;
  ruleType: 'weekly' | 'date';
  weekday: number;
  date: string;
  startTime: string;
  endTime: string;
  available: boolean;
  reason: string;
  updatedAt: string;
}

export interface CoachDetailData {
  coach: CoachSummary;
  profile: {
    username: string;
    mobile: string;
    storeName: string;
    statusLabel: string;
    sourceLabel: string;
  };
  currentPayroll: PayrollCoachSummary;
  availability: CoachAvailability[];
  appointments: ScheduleAppointment[];
  lessons: PayrollLine[];
  reviews: PayrollLine[];
  payrolls: PayrollSummary[];
  reviewTaskCount: number;
  payrollMonth: string;
  payrollSourceStatus: PayrollSourceStatus;
  refreshedAt: string;
  dataDateFrom: string;
  dataDateTo: string;
}

export interface PayRate extends Record<string, unknown> {
  objectId: string;
  classType: number;
  classTypeLabel: string;
  amount: number;
  durationHours: number;
  effectiveFrom: string;
  active: boolean;
  isDefault?: boolean;
  updatedAt: string;
}

export type PayrollStatus = 'draft' | 'reviewed' | 'paid';

export interface PayrollSummary extends Record<string, unknown> {
  objectId: string;
  month: string;
  status: PayrollStatus;
  statusLabel: string;
  coachCount: number;
  lessonCount: number;
  totalHours: number;
  baseAmount: number;
  adjustmentAmount: number;
  payableAmount: number;
  exceptionCount: number;
  type4Count?: number;
  reviewedAt: string;
  paidAt: string;
  paymentMethod: string;
  paymentReference: string;
  updatedAt: string;
}

export interface PayrollLine extends Record<string, unknown> {
  objectId: string;
  kind: 'lesson' | 'adjustment';
  coachId: number;
  coachName: string;
  coachObjectId?: string;
  storeId: number;
  storeName: string;
  studentName: string;
  courseName: string;
  legacyGeneralId: number;
  lessonId: string;
  lessonAt: string;
  originalMonth: string;
  settlementMonth: string;
  classType: number;
  classTypeLabel: string;
  durationHours: number;
  rateAmount: number;
  amount: number;
  score?: number;
  comment?: string;
  description: string;
  exception: string;
  excluded?: boolean;
}

export interface PayrollDetail extends PayrollSummary {
  lines: PayrollLine[];
  exceptions: PayrollLine[];
  coachItems?: PayrollCoachSummary[];
  sourceStatus?: PayrollSourceStatus;
  refreshedAt?: string;
}

export interface PayrollCoachSummary extends Record<string, unknown> {
  coachId: number;
  coachName: string;
  coachObjectId?: string;
  storeId: number;
  storeName: string;
  type30Count: number;
  type60Count: number;
  trialCount: number;
  type4Count: number;
  lessonCount: number;
  totalHours: number;
  baseAmount: number;
  adjustmentAmount: number;
  payableAmount: number;
  averageScore?: number;
  latestLessonAt: string;
}

export interface PayrollSourceStatus extends Record<string, unknown> {
  available: boolean;
  mode: 'live' | 'cache';
  message: string;
  total: number;
  refreshedAt: string;
}

export interface PayrollOverview extends PayrollDetail {
  coachItems: PayrollCoachSummary[];
  sourceStatus: PayrollSourceStatus;
  batches: PayrollSummary[];
  stores: Array<{ storeId: number; storeName: string }>;
}

export interface PayrollExportData extends Record<string, unknown> {
  fileName: string;
  summary: PayrollSummary;
  coachItems: PayrollCoachSummary[];
  lines: PayrollLine[];
  exceptions: PayrollLine[];
}

export interface VocabularyNode extends Record<string, unknown> {
  objectId: string;
  nodeId: number;
  name: string;
  parentId: number;
  depth: number;
  orderId: number;
  directWordCount: number;
  wordCount: number;
  childCount: number;
  status: number;
  canContainWords: boolean;
}

export interface VocabularyWord extends Record<string, unknown> {
  targetId: string;
  generalId: number;
  itemId: number;
  word: string;
  meaning: string;
  phonetic: string;
  example: string;
  audioUrl: string;
  nodeId: number;
  unitName: string;
  bookName: string;
  stageName: string;
  orderId: number;
  status: number;
  statusLabel: string;
  createdAt: string;
  updatedAt: string;
}

export interface VocabularyTree {
  items: VocabularyNode[];
  total: number;
  totalWords: number;
  refreshedAt: string;
}

export interface VocabularyImportPreview {
  batchId: string;
  status: string;
  summary: { total: number; create: number; update: number; unchanged: number; duplicate: number; error: number; missingMedia: number };
  items: Array<Record<string, unknown>>;
  createdAt: string;
}

export interface SpecialTrainingItem extends Record<string, unknown> {
  targetId: string;
  generalId: number;
  itemId: number;
  title: string;
  synopsis: string;
  coverUrl: string;
  tags: string[];
  contentHtml: string;
  videoUrl: string;
  author: string;
  source: string;
  orderId: number;
  hits: number;
  status: number;
  statusLabel: string;
  createdAt: string;
  updatedAt: string;
}

export interface SpecialTrainingPage extends OperationsPage<SpecialTrainingItem> {
  sourceStatus?: {
    available: boolean;
    message: string;
    legacyTotal: number;
    created: number;
    updated: number;
    refreshedAt: string;
  } | null;
}

export interface MediaUploadTicket {
  ticketId: string;
  method: 'PUT';
  uploadUrl: string;
  publicUrl: string;
  objectKey: string;
  headers: Record<string, string>;
  expiresAt: string;
}