/** * OmniCard AI (CRMmp) - 用户端面向微官网与名片的核心 API 客户端 * 严格遵循 AGENTS.md 规范与 uts 强类型约束 */ import { AiChatReply, AiChatRequest, CardArticle, CardCase, CardContact, CardEvent, CardEventJoinResult, CardProfile, CardPortalDetail, LeadEntity, LeadStatus, NFCRecord, NfcBindParams, NfcUidParams, OwnerPageData, OwnerPageQuery, QuotaCheckResult, RadarHotInbox, RadarTrack, TeamRankItem, SubmitLeadParams, RecordRadarTrackParams, WorkplaceOverviewResult, } from './types.uts'; import { httpGet, httpPost } from './request.uts'; /** * 获取商务概览工作台数据 (包含今日KPI与雷达高光Feed) * 对齐后端 POST /admin/crm/radar/workplace */ export function fetchWorkplaceOverview(feedLimit?: number): Promise { const query: Record = {}; if (feedLimit != null) { query.feedLimit = feedLimit; } return httpPost('/admin/crm/radar/workplace', query); } /** * 获取微官网与名片公开聚合详情 (包含 Hero、Bento 块、多语言与品牌 VI) * 对齐后端 GET /open/card/portal/detail?id= | ?slug= | ?slugOrId= * * @param slugOrId 名片主键 ID 或自定义短链标识 */ export function fetchPortalCard(slugOrId: string): Promise { if (/^\d+$/.test(slugOrId)) { return httpGet('/open/card/portal/detail', { slugOrId: slugOrId, id: slugOrId, }); } return httpGet('/open/card/portal/detail', { slugOrId: slugOrId, slug: slugOrId, }); } /** * 提交无摩擦潜客留资 / 互换名片数据 * 对齐后端 POST /open/crm/lead/exchange * * @param leadData 潜客留资信息 */ export function submitLead(leadData: SubmitLeadParams): Promise { return httpPost('/open/crm/lead/exchange', leadData); } /** * 记录访客实时雷达轨迹足迹 (停留时长、滚动深度、浏览块等) * 对齐后端 POST /open/crm/radar/track * * @param trackData 轨迹行为数据 */ export function recordRadarTrack(trackData: RecordRadarTrackParams): Promise { return httpPost('/open/crm/radar/track', trackData); } /** * 查询名片最近访客足迹流水 * 对齐后端 GET /open/crm/radar/recent?cardId= * * @param cardId 名片主键 * @param limit 返回条数上限 */ export function getRecentTracks(cardId: string | number, limit?: number): Promise { const query: Record = { cardId }; if (limit != null) { query.limit = limit; } return httpGet('/open/crm/radar/recent', query); } export function bindNfcDevice(params: NfcBindParams): Promise { return httpPost('/admin/nfc/bind/bind', params); } export function activateNfcDevice(params: NfcUidParams): Promise { return httpPost('/admin/nfc/bind/activate', params); } export function switchNfcCard(params: NfcBindParams): Promise { return httpPost('/admin/nfc/bind/switchCard', params); } export function unbindNfcDevice(params: NfcUidParams): Promise { return httpPost('/admin/nfc/bind/unbind', params); } export function updateNfcDevice( payload: NFCRecord & { id: string | number } ): Promise { return httpPost('/admin/nfc/device/update', payload); } export function freezeNfcDevice( params: { id?: number | string; uid?: string } ): Promise { return httpPost('/admin/nfc/security/freeze', params); } export function unfreezeNfcDevice( params: { id?: number | string; uid?: string } ): Promise { return httpPost('/admin/nfc/security/unfreeze', params); } export function fetchOwnerLeadPage( query: OwnerPageQuery ): Promise> { return httpPost>('/admin/crm/lead/page', query); } export function fetchOwnerLeadInfo(id: string | number): Promise { return httpGet('/admin/crm/lead/info', { id }); } export function updateOwnerLeadStatus( id: string | number, status: LeadStatus ): Promise { return httpPost('/admin/crm/lead/updateStatus', { id, status }); } export function fetchOwnerRadarPage( query: OwnerPageQuery ): Promise> { return httpPost>('/admin/crm/radar/page', query); } export function askAiChat(req: AiChatRequest): Promise { return httpPost('/open/ai/chat/ask', req); } export function fetchOwnerCardPage( query: OwnerPageQuery ): Promise> { return httpPost>('/admin/card/info/page', query); } export function fetchOwnerCardInfo(id: string | number): Promise { return httpGet('/admin/card/info/info', { id }); } export function updateOwnerCard( payload: CardProfile & { id: string | number } ): Promise { return httpPost('/admin/card/info/update', payload); } export function fetchCardQrcodeSvg( slugOrId: string ): Promise<{ svg: string; url: string }> { return httpGet<{ svg: string; url: string }>('/open/card/qrcode/svg', { slugOrId, }); } export function fetchHallContactPage( query: OwnerPageQuery ): Promise> { return httpPost>('/admin/card/contact/hallPage', query); } export function collectHallContact( peerCardId: string | number, ownerCardId?: string | number ): Promise { const payload: Record = { peerCardId }; if (ownerCardId != null) { payload.ownerCardId = ownerCardId; } return httpPost('/admin/card/contact/collect', payload); } export function fetchTeamWallPage( query: OwnerPageQuery ): Promise> { return httpPost>('/admin/card/contact/teamWall', query); } export function fetchEventFloorPage( query: OwnerPageQuery ): Promise> { return httpPost>('/admin/card/event/floorPage', query); } export function joinHallEvent( code: string, cardId?: string | number ): Promise { const payload: Record = { code }; if (cardId != null) { payload.cardId = cardId; } return httpPost('/admin/card/event/join', payload); } export function fetchCurrentEvent(): Promise { return httpPost('/admin/card/event/current', {}); } export function fetchRadarHotInbox(): Promise { return httpPost('/admin/crm/radar/hotInbox', {}); } export function fetchTeamLiveRank( eventId?: string ): Promise { const payload: Record = {}; if (eventId != null && eventId !== '') { payload.eventId = eventId; } return httpPost('/admin/team/members/live-rank', payload); } export function fetchCardQuota( tenantId?: string | number ): Promise { const payload: Record = { resourceType: 'cards' }; if (tenantId != null && String(tenantId) !== '') { payload.tenantId = tenantId; } return httpPost('/admin/team/billing/quota', payload); } export function confirmHallExchange( exchangeCode: string, actingCardId?: string | number ): Promise<{ status: string; isDualSynced: boolean }> { const payload: Record = { exchangeCode }; if (actingCardId != null) { payload.actingCardId = actingCardId; } return httpPost<{ status: string; isDualSynced: boolean }>( '/admin/card/exchange/confirm', payload ); } export function fetchCardCasesPage( query: OwnerPageQuery ): Promise> { return httpPost>('/admin/card/cases/page', query); } export function fetchCardCaseInfo(id: string | number): Promise { return httpGet('/admin/card/cases/info', { id }); } export function addCardCase(data: Partial): Promise { return httpPost('/admin/card/cases/add', data); } export function updateCardCase( data: Partial & { id: string | number } ): Promise { return httpPost('/admin/card/cases/update', data); } export function deleteCardCase(id: string | number): Promise { return httpPost('/admin/card/cases/delete', { ids: [id] }); } export function fetchCardArticlesPage( query: OwnerPageQuery ): Promise> { return httpPost>('/admin/card/article/page', query); } export function fetchCardArticleInfo(id: string | number): Promise { return httpGet('/admin/card/article/info', { id }); } export function addCardArticle(data: Partial): Promise { return httpPost('/admin/card/article/add', data); } export function updateCardArticle( data: Partial & { id: string | number } ): Promise { return httpPost('/admin/card/article/update', data); } export function deleteCardArticle(id: string | number): Promise { return httpPost('/admin/card/article/delete', { ids: [id] }); } export * from './types.uts'; export * from './request.uts';