data-overview.service.test.ts 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537
  1. import { describe, it, expect, beforeEach, vi } from 'vitest';
  2. import { DataSource, Repository } from 'typeorm';
  3. import { OrderMt } from '@d8d/orders-module-mt';
  4. import { DataOverviewServiceMt, TimeFilterParams, SummaryStatistics } from '../../src/services/data-overview.service';
  5. // Mock redisUtil and AppDataSource - use hoisted to ensure availability before vi.mock
  6. const { mockRedisUtil, mockAppDataSource } = vi.hoisted(() => {
  7. return {
  8. mockRedisUtil: {
  9. get: vi.fn(),
  10. set: vi.fn(),
  11. keys: vi.fn(),
  12. del: vi.fn()
  13. },
  14. mockAppDataSource: {}
  15. };
  16. });
  17. vi.mock('@d8d/shared-utils', async () => {
  18. const actual = await vi.importActual<typeof import('@d8d/shared-utils')>('@d8d/shared-utils');
  19. return {
  20. ...actual,
  21. redisUtil: mockRedisUtil,
  22. AppDataSource: mockAppDataSource
  23. };
  24. });
  25. describe('DataOverviewServiceMt', () => {
  26. let service: DataOverviewServiceMt;
  27. let mockDataSource: DataSource;
  28. let mockOrderRepository: Repository<OrderMt>;
  29. beforeEach(() => {
  30. // Mock Order Repository
  31. mockOrderRepository = {
  32. createQueryBuilder: vi.fn(() => ({
  33. select: vi.fn().mockReturnThis(),
  34. where: vi.fn().mockReturnThis(),
  35. andWhere: vi.fn().mockReturnThis(),
  36. setParameters: vi.fn().mockReturnThis(),
  37. getRawOne: vi.fn()
  38. }))
  39. } as any;
  40. // Mock DataSource
  41. mockDataSource = {
  42. getRepository: vi.fn((entity) => {
  43. if (entity === OrderMt) {
  44. return mockOrderRepository;
  45. }
  46. return {} as any;
  47. })
  48. } as any;
  49. // Reset redisUtil mocks
  50. mockRedisUtil.get.mockReset();
  51. mockRedisUtil.set.mockReset();
  52. mockRedisUtil.keys.mockReset();
  53. mockRedisUtil.del.mockReset();
  54. service = new DataOverviewServiceMt(mockDataSource);
  55. });
  56. describe('getDateRange', () => {
  57. it('应该返回今天的时间范围(默认)', () => {
  58. const now = new Date('2025-12-26T10:00:00Z');
  59. vi.setSystemTime(now);
  60. const params: TimeFilterParams = {};
  61. const result = service['getDateRange'](params);
  62. const expectedStart = new Date('2025-12-26T00:00:00Z');
  63. const expectedEnd = now; // 对于今天的时间范围,结束时间是当前时间
  64. expect(result.startDate.toISOString()).toBe(expectedStart.toISOString());
  65. expect(result.endDate.toISOString()).toBe(expectedEnd.toISOString());
  66. });
  67. it('应该返回昨天的时间范围', () => {
  68. const now = new Date('2025-12-26T10:00:00Z');
  69. vi.setSystemTime(now);
  70. const params: TimeFilterParams = { timeRange: 'yesterday' };
  71. const result = service['getDateRange'](params);
  72. const expectedStart = new Date('2025-12-25T00:00:00Z');
  73. const expectedEnd = new Date('2025-12-25T23:59:59.999Z');
  74. expect(result.startDate.toISOString()).toBe(expectedStart.toISOString());
  75. expect(result.endDate.toISOString()).toBe(expectedEnd.toISOString());
  76. });
  77. it('应该返回最近7天的时间范围', () => {
  78. const now = new Date('2025-12-26T10:00:00Z');
  79. vi.setSystemTime(now);
  80. const params: TimeFilterParams = { timeRange: 'last7days' };
  81. const result = service['getDateRange'](params);
  82. const expectedStart = new Date('2025-12-19T10:00:00Z'); // 7天前
  83. const expectedEnd = now;
  84. expect(result.startDate.toISOString()).toBe(expectedStart.toISOString());
  85. expect(result.endDate.toISOString()).toBe(expectedEnd.toISOString());
  86. });
  87. it('应该返回最近30天的时间范围', () => {
  88. const now = new Date('2025-12-26T10:00:00Z');
  89. vi.setSystemTime(now);
  90. const params: TimeFilterParams = { timeRange: 'last30days' };
  91. const result = service['getDateRange'](params);
  92. const expectedStart = new Date('2025-11-26T10:00:00Z'); // 30天前
  93. const expectedEnd = now;
  94. expect(result.startDate.toISOString()).toBe(expectedStart.toISOString());
  95. expect(result.endDate.toISOString()).toBe(expectedEnd.toISOString());
  96. });
  97. it('应该返回自定义时间范围', () => {
  98. const params: TimeFilterParams = {
  99. timeRange: 'custom',
  100. startDate: '2025-01-01T00:00:00Z',
  101. endDate: '2025-01-31T23:59:59Z'
  102. };
  103. const result = service['getDateRange'](params);
  104. expect(result.startDate.toISOString()).toBe('2025-01-01T00:00:00.000Z');
  105. expect(result.endDate.toISOString()).toBe('2025-01-31T23:59:59.000Z');
  106. });
  107. it('当自定义时间范围缺少参数时应该使用默认值', () => {
  108. const now = new Date('2025-12-26T10:00:00Z');
  109. vi.setSystemTime(now);
  110. const params: TimeFilterParams = { timeRange: 'custom' }; // 缺少startDate和endDate
  111. const result = service['getDateRange'](params);
  112. const expectedStart = new Date('2025-12-26T00:00:00Z');
  113. const expectedEnd = now; // 当自定义范围缺少参数时,使用默认的今天范围,结束时间为当前时间
  114. expect(result.startDate.toISOString()).toBe(expectedStart.toISOString());
  115. expect(result.endDate.toISOString()).toBe(expectedEnd.toISOString());
  116. });
  117. });
  118. describe('getSummaryStatistics', () => {
  119. it('应该从缓存返回统计数据', async () => {
  120. const tenantId = 1;
  121. const params: TimeFilterParams = { timeRange: 'today' };
  122. const cacheKey = `data_overview:summary:${tenantId}:today::`;
  123. const cachedStats: SummaryStatistics = {
  124. totalSales: 10000,
  125. totalOrders: 50,
  126. wechatSales: 6000,
  127. wechatOrders: 30,
  128. creditSales: 4000,
  129. creditOrders: 20,
  130. todaySales: 500,
  131. todayOrders: 5
  132. };
  133. mockRedisUtil.get.mockResolvedValue(JSON.stringify(cachedStats));
  134. const result = await service.getSummaryStatistics(tenantId, params);
  135. expect(result).toEqual(cachedStats);
  136. expect(mockRedisUtil.get).toHaveBeenCalledWith(cacheKey);
  137. expect(mockRedisUtil.set).not.toHaveBeenCalled();
  138. });
  139. it('当缓存未命中时应该查询数据库并设置缓存', async () => {
  140. const tenantId = 1;
  141. const params: TimeFilterParams = { timeRange: 'today' };
  142. const cacheKey = `data_overview:summary:${tenantId}:today::`;
  143. mockRedisUtil.get.mockResolvedValue(null);
  144. // Mock database query result
  145. const mockQueryBuilder = {
  146. select: vi.fn().mockReturnThis(),
  147. where: vi.fn().mockReturnThis(),
  148. andWhere: vi.fn().mockReturnThis(),
  149. setParameters: vi.fn().mockReturnThis(),
  150. getRawOne: vi.fn().mockResolvedValue({
  151. total_orders: '50',
  152. total_sales: '10000.50',
  153. wechat_sales: '6000.00',
  154. credit_sales: '4000.50',
  155. wechat_orders: '30',
  156. credit_orders: '20'
  157. })
  158. };
  159. const mockTodayQueryBuilder = {
  160. select: vi.fn().mockReturnThis(),
  161. where: vi.fn().mockReturnThis(),
  162. andWhere: vi.fn().mockReturnThis(),
  163. getRawOne: vi.fn().mockResolvedValue({
  164. today_orders: '5',
  165. today_sales: '500.00'
  166. })
  167. };
  168. vi.mocked(mockOrderRepository.createQueryBuilder)
  169. .mockReturnValueOnce(mockQueryBuilder as any)
  170. .mockReturnValueOnce(mockTodayQueryBuilder as any);
  171. const result = await service.getSummaryStatistics(tenantId, params);
  172. expect(result.totalSales).toBe(10000.50);
  173. expect(result.totalOrders).toBe(50);
  174. expect(result.wechatSales).toBe(6000);
  175. expect(result.creditSales).toBe(4000.50);
  176. expect(result.wechatOrders).toBe(30);
  177. expect(result.creditOrders).toBe(20);
  178. expect(result.todaySales).toBe(500);
  179. expect(result.todayOrders).toBe(5);
  180. expect(mockRedisUtil.set).toHaveBeenCalledWith(
  181. cacheKey,
  182. expect.any(String),
  183. 5 * 60 // 5分钟TTL(今日数据)
  184. );
  185. });
  186. it('应该为历史数据设置30分钟缓存', async () => {
  187. const tenantId = 1;
  188. const params: TimeFilterParams = { timeRange: 'last7days' };
  189. const cacheKey = `data_overview:summary:${tenantId}:last7days::`;
  190. mockRedisUtil.get.mockResolvedValue(null);
  191. const mockQueryBuilder = {
  192. select: vi.fn().mockReturnThis(),
  193. where: vi.fn().mockReturnThis(),
  194. andWhere: vi.fn().mockReturnThis(),
  195. setParameters: vi.fn().mockReturnThis(),
  196. getRawOne: vi.fn().mockResolvedValue({
  197. total_orders: '100',
  198. total_sales: '20000.00',
  199. wechat_sales: '12000.00',
  200. credit_sales: '8000.00',
  201. wechat_orders: '60',
  202. credit_orders: '40'
  203. })
  204. };
  205. const mockTodayQueryBuilder = {
  206. select: vi.fn().mockReturnThis(),
  207. where: vi.fn().mockReturnThis(),
  208. andWhere: vi.fn().mockReturnThis(),
  209. getRawOne: vi.fn().mockResolvedValue({
  210. today_orders: '10',
  211. today_sales: '1000.00'
  212. })
  213. };
  214. vi.mocked(mockOrderRepository.createQueryBuilder)
  215. .mockReturnValueOnce(mockQueryBuilder as any)
  216. .mockReturnValueOnce(mockTodayQueryBuilder as any);
  217. await service.getSummaryStatistics(tenantId, params);
  218. expect(mockRedisUtil.set).toHaveBeenCalledWith(
  219. cacheKey,
  220. expect.any(String),
  221. 30 * 60 // 30分钟TTL(历史数据)
  222. );
  223. });
  224. });
  225. describe('getTodayStatistics', () => {
  226. it('应该从缓存返回今日统计数据', async () => {
  227. const tenantId = 1;
  228. const today = new Date().toISOString().split('T')[0];
  229. const cacheKey = `data_overview:today:${tenantId}:${today}`;
  230. const cachedStats = { todaySales: 500, todayOrders: 5 };
  231. mockRedisUtil.get.mockResolvedValue(JSON.stringify(cachedStats));
  232. const result = await service.getTodayStatistics(tenantId);
  233. expect(result).toEqual(cachedStats);
  234. expect(mockRedisUtil.get).toHaveBeenCalledWith(cacheKey);
  235. expect(mockRedisUtil.set).not.toHaveBeenCalled();
  236. });
  237. it('当缓存未命中时应该查询数据库并设置缓存', async () => {
  238. const tenantId = 1;
  239. const today = new Date().toISOString().split('T')[0];
  240. const cacheKey = `data_overview:today:${tenantId}:${today}`;
  241. mockRedisUtil.get.mockResolvedValue(null);
  242. const mockQueryBuilder = {
  243. select: vi.fn().mockReturnThis(),
  244. where: vi.fn().mockReturnThis(),
  245. andWhere: vi.fn().mockReturnThis(),
  246. getRawOne: vi.fn().mockResolvedValue({
  247. today_orders: '5',
  248. today_sales: '500.00'
  249. })
  250. };
  251. vi.mocked(mockOrderRepository.createQueryBuilder).mockReturnValue(mockQueryBuilder as any);
  252. const result = await service.getTodayStatistics(tenantId);
  253. expect(result.todaySales).toBe(500);
  254. expect(result.todayOrders).toBe(5);
  255. expect(mockRedisUtil.set).toHaveBeenCalledWith(cacheKey, expect.any(String), 5 * 60);
  256. });
  257. });
  258. describe('clearCache', () => {
  259. it('应该清理指定租户的所有缓存', async () => {
  260. const tenantId = 1;
  261. const cacheKeys = [
  262. 'data_overview:summary:1:today::',
  263. 'data_overview:today:1:2025-12-26'
  264. ];
  265. mockRedisUtil.keys.mockResolvedValue(cacheKeys);
  266. await service.clearCache(tenantId);
  267. expect(mockRedisUtil.keys).toHaveBeenCalledWith('data_overview:*:1:*');
  268. expect(mockRedisUtil.del).toHaveBeenCalledWith(...cacheKeys);
  269. });
  270. it('当没有缓存键时不应该调用del', async () => {
  271. const tenantId = 1;
  272. mockRedisUtil.keys.mockResolvedValue([]);
  273. await service.clearCache(tenantId);
  274. expect(mockRedisUtil.keys).toHaveBeenCalledWith('data_overview:*:1:*');
  275. expect(mockRedisUtil.del).not.toHaveBeenCalled();
  276. });
  277. });
  278. describe('getUserConsumptionStatistics', () => {
  279. const tenantId = 1;
  280. const mockUsers = [
  281. { userId: 1, userName: '张三', userPhone: '13800138001', totalSpent: 15000.50, orderCount: 15, avgOrderAmount: 1000.03, lastOrderDate: '2025-12-30T10:30:00Z' },
  282. { userId: 2, userName: '李四', userPhone: '13800138002', totalSpent: 12000.75, orderCount: 12, avgOrderAmount: 1000.06, lastOrderDate: '2025-12-29T14:20:00Z' },
  283. { userId: 3, userName: '王五', userPhone: '13800138003', totalSpent: 8000.25, orderCount: 8, avgOrderAmount: 1000.03, lastOrderDate: '2025-12-28T09:15:00Z' }
  284. ];
  285. beforeEach(() => {
  286. vi.clearAllMocks();
  287. });
  288. it('应该从缓存返回用户消费统计数据', async () => {
  289. const params = { timeRange: 'last30days' } as any;
  290. const paginationParams = { page: 1, limit: 10, sortBy: 'totalSpent' as const, sortOrder: 'desc' as const };
  291. const cacheKey = `data_overview:user_consumption:${tenantId}:last30days:::1:10:totalSpent:desc`;
  292. const cachedResponse = {
  293. items: mockUsers,
  294. pagination: { page: 1, limit: 10, total: 3, totalPages: 1 }
  295. };
  296. mockRedisUtil.get.mockResolvedValue(JSON.stringify(cachedResponse));
  297. const result = await service.getUserConsumptionStatistics(tenantId, params, paginationParams);
  298. expect(result).toEqual(cachedResponse);
  299. expect(mockRedisUtil.get).toHaveBeenCalledWith(cacheKey);
  300. expect(mockRedisUtil.set).not.toHaveBeenCalled();
  301. });
  302. it('当缓存未命中时应该查询数据库并设置缓存', async () => {
  303. const params = { timeRange: 'last30days' } as any;
  304. const paginationParams = { page: 1, limit: 10, sortBy: 'totalSpent' as const, sortOrder: 'desc' as const };
  305. const cacheKey = `data_overview:user_consumption:${tenantId}:last30days:::1:10:totalSpent:desc`;
  306. mockRedisUtil.get.mockResolvedValue(null);
  307. // Mock count query builder
  308. const mockCountQueryBuilder = {
  309. select: vi.fn().mockReturnThis(),
  310. where: vi.fn().mockReturnThis(),
  311. andWhere: vi.fn().mockReturnThis(),
  312. getRawOne: vi.fn().mockResolvedValue({ total_users: '3' })
  313. };
  314. // Mock main query builder
  315. const mockQueryBuilder = {
  316. select: vi.fn().mockReturnThis(),
  317. leftJoin: vi.fn().mockReturnThis(),
  318. where: vi.fn().mockReturnThis(),
  319. andWhere: vi.fn().mockReturnThis(),
  320. groupBy: vi.fn().mockReturnThis(),
  321. orderBy: vi.fn().mockReturnThis(),
  322. offset: vi.fn().mockReturnThis(),
  323. limit: vi.fn().mockReturnThis(),
  324. getRawMany: vi.fn().mockResolvedValue(mockUsers.map(user => ({
  325. userId: user.userId,
  326. userName: user.userName,
  327. userPhone: user.userPhone,
  328. totalSpent: user.totalSpent.toString(),
  329. orderCount: user.orderCount.toString(),
  330. avgOrderAmount: user.avgOrderAmount.toString(),
  331. lastOrderDate: user.lastOrderDate
  332. })))
  333. };
  334. vi.mocked(mockOrderRepository.createQueryBuilder)
  335. .mockReturnValueOnce(mockCountQueryBuilder as any)
  336. .mockReturnValueOnce(mockQueryBuilder as any);
  337. const result = await service.getUserConsumptionStatistics(tenantId, params, paginationParams);
  338. expect(result.items).toHaveLength(3);
  339. expect(result.pagination.page).toBe(1);
  340. expect(result.pagination.limit).toBe(10);
  341. expect(result.pagination.total).toBe(3);
  342. expect(result.pagination.totalPages).toBe(1);
  343. expect(result.items[0].userId).toBe(1);
  344. expect(result.items[0].userName).toBe('张三');
  345. expect(result.items[0].totalSpent).toBe(15000.50);
  346. expect(result.items[0].orderCount).toBe(15);
  347. expect(mockRedisUtil.set).toHaveBeenCalledWith(cacheKey, expect.any(String), 30 * 60);
  348. });
  349. it('应该正确处理空结果', async () => {
  350. const params = { timeRange: 'today' } as any;
  351. const paginationParams = { page: 1, limit: 10 };
  352. mockRedisUtil.get.mockResolvedValue(null);
  353. // Mock count query builder with zero results
  354. const mockCountQueryBuilder = {
  355. select: vi.fn().mockReturnThis(),
  356. where: vi.fn().mockReturnThis(),
  357. andWhere: vi.fn().mockReturnThis(),
  358. getRawOne: vi.fn().mockResolvedValue({ total_users: '0' })
  359. };
  360. vi.mocked(mockOrderRepository.createQueryBuilder)
  361. .mockReturnValueOnce(mockCountQueryBuilder as any);
  362. const result = await service.getUserConsumptionStatistics(tenantId, params, paginationParams);
  363. expect(result.items).toHaveLength(0);
  364. expect(result.pagination.total).toBe(0);
  365. expect(result.pagination.totalPages).toBe(0);
  366. });
  367. it('应该支持不同的排序字段和方向', async () => {
  368. const params = { timeRange: 'last30days' } as any;
  369. const paginationParams = { page: 1, limit: 10, sortBy: 'orderCount' as const, sortOrder: 'asc' as const };
  370. mockRedisUtil.get.mockResolvedValue(null);
  371. // Mock count query builder
  372. const mockCountQueryBuilder = {
  373. select: vi.fn().mockReturnThis(),
  374. where: vi.fn().mockReturnThis(),
  375. andWhere: vi.fn().mockReturnThis(),
  376. getRawOne: vi.fn().mockResolvedValue({ total_users: '2' })
  377. };
  378. // Mock main query builder
  379. const mockQueryBuilder = {
  380. select: vi.fn().mockReturnThis(),
  381. leftJoin: vi.fn().mockReturnThis(),
  382. where: vi.fn().mockReturnThis(),
  383. andWhere: vi.fn().mockReturnThis(),
  384. groupBy: vi.fn().mockReturnThis(),
  385. orderBy: vi.fn().mockReturnThis(),
  386. offset: vi.fn().mockReturnThis(),
  387. limit: vi.fn().mockReturnThis(),
  388. getRawMany: vi.fn().mockResolvedValue(mockUsers.slice(0, 2).map(user => ({
  389. userId: user.userId,
  390. userName: user.userName,
  391. userPhone: user.userPhone,
  392. totalSpent: user.totalSpent.toString(),
  393. orderCount: user.orderCount.toString(),
  394. avgOrderAmount: user.avgOrderAmount.toString(),
  395. lastOrderDate: user.lastOrderDate
  396. })))
  397. };
  398. vi.mocked(mockOrderRepository.createQueryBuilder)
  399. .mockReturnValueOnce(mockCountQueryBuilder as any)
  400. .mockReturnValueOnce(mockQueryBuilder as any);
  401. await service.getUserConsumptionStatistics(tenantId, params, paginationParams);
  402. // 验证orderBy被正确调用
  403. expect(mockQueryBuilder.orderBy).toHaveBeenCalled();
  404. });
  405. it('应该支持分页', async () => {
  406. const params = { timeRange: 'last30days' } as any;
  407. const paginationParams = { page: 2, limit: 5 };
  408. mockRedisUtil.get.mockResolvedValue(null);
  409. // Mock count query builder
  410. const mockCountQueryBuilder = {
  411. select: vi.fn().mockReturnThis(),
  412. where: vi.fn().mockReturnThis(),
  413. andWhere: vi.fn().mockReturnThis(),
  414. getRawOne: vi.fn().mockResolvedValue({ total_users: '15' })
  415. };
  416. // Mock main query builder
  417. const mockQueryBuilder = {
  418. select: vi.fn().mockReturnThis(),
  419. leftJoin: vi.fn().mockReturnThis(),
  420. where: vi.fn().mockReturnThis(),
  421. andWhere: vi.fn().mockReturnThis(),
  422. groupBy: vi.fn().mockReturnThis(),
  423. orderBy: vi.fn().mockReturnThis(),
  424. offset: vi.fn().mockReturnThis(),
  425. limit: vi.fn().mockReturnThis(),
  426. getRawMany: vi.fn().mockResolvedValue([])
  427. };
  428. vi.mocked(mockOrderRepository.createQueryBuilder)
  429. .mockReturnValueOnce(mockCountQueryBuilder as any)
  430. .mockReturnValueOnce(mockQueryBuilder as any);
  431. await service.getUserConsumptionStatistics(tenantId, params, paginationParams);
  432. // 验证offset被正确调用(第2页,每页5条 => offset = (2-1)*5 = 5)
  433. expect(mockQueryBuilder.offset).toHaveBeenCalledWith(5);
  434. expect(mockQueryBuilder.limit).toHaveBeenCalledWith(5);
  435. });
  436. });
  437. });