data-overview.service.test.ts 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533
  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. };
  131. mockRedisUtil.get.mockResolvedValue(JSON.stringify(cachedStats));
  132. const result = await service.getSummaryStatistics(tenantId, params);
  133. expect(result).toEqual(cachedStats);
  134. expect(mockRedisUtil.get).toHaveBeenCalledWith(cacheKey);
  135. expect(mockRedisUtil.set).not.toHaveBeenCalled();
  136. });
  137. it('当缓存未命中时应该查询数据库并设置缓存', async () => {
  138. const tenantId = 1;
  139. const params: TimeFilterParams = { timeRange: 'today' };
  140. const cacheKey = `data_overview:summary:${tenantId}:today::`;
  141. mockRedisUtil.get.mockResolvedValue(null);
  142. // Mock database query result
  143. const mockQueryBuilder = {
  144. select: vi.fn().mockReturnThis(),
  145. where: vi.fn().mockReturnThis(),
  146. andWhere: vi.fn().mockReturnThis(),
  147. setParameters: vi.fn().mockReturnThis(),
  148. getRawOne: vi.fn().mockResolvedValue({
  149. total_orders: '50',
  150. total_sales: '10000.50',
  151. wechat_sales: '6000.00',
  152. credit_sales: '4000.50',
  153. wechat_orders: '30',
  154. credit_orders: '20'
  155. })
  156. };
  157. const mockTodayQueryBuilder = {
  158. select: vi.fn().mockReturnThis(),
  159. where: vi.fn().mockReturnThis(),
  160. andWhere: vi.fn().mockReturnThis(),
  161. getRawOne: vi.fn().mockResolvedValue({
  162. today_orders: '5',
  163. today_sales: '500.00'
  164. })
  165. };
  166. vi.mocked(mockOrderRepository.createQueryBuilder)
  167. .mockReturnValueOnce(mockQueryBuilder as any)
  168. .mockReturnValueOnce(mockTodayQueryBuilder as any);
  169. const result = await service.getSummaryStatistics(tenantId, params);
  170. expect(result.totalSales).toBe(10000.50);
  171. expect(result.totalOrders).toBe(50);
  172. expect(result.wechatSales).toBe(6000);
  173. expect(result.creditSales).toBe(4000.50);
  174. expect(result.wechatOrders).toBe(30);
  175. expect(result.creditOrders).toBe(20);
  176. expect(mockRedisUtil.set).toHaveBeenCalledWith(
  177. cacheKey,
  178. expect.any(String),
  179. 5 * 60 // 5分钟TTL(今日数据)
  180. );
  181. });
  182. it('应该为历史数据设置30分钟缓存', async () => {
  183. const tenantId = 1;
  184. const params: TimeFilterParams = { timeRange: 'last7days' };
  185. const cacheKey = `data_overview:summary:${tenantId}:last7days::`;
  186. mockRedisUtil.get.mockResolvedValue(null);
  187. const mockQueryBuilder = {
  188. select: vi.fn().mockReturnThis(),
  189. where: vi.fn().mockReturnThis(),
  190. andWhere: vi.fn().mockReturnThis(),
  191. setParameters: vi.fn().mockReturnThis(),
  192. getRawOne: vi.fn().mockResolvedValue({
  193. total_orders: '100',
  194. total_sales: '20000.00',
  195. wechat_sales: '12000.00',
  196. credit_sales: '8000.00',
  197. wechat_orders: '60',
  198. credit_orders: '40'
  199. })
  200. };
  201. const mockTodayQueryBuilder = {
  202. select: vi.fn().mockReturnThis(),
  203. where: vi.fn().mockReturnThis(),
  204. andWhere: vi.fn().mockReturnThis(),
  205. getRawOne: vi.fn().mockResolvedValue({
  206. today_orders: '10',
  207. today_sales: '1000.00'
  208. })
  209. };
  210. vi.mocked(mockOrderRepository.createQueryBuilder)
  211. .mockReturnValueOnce(mockQueryBuilder as any)
  212. .mockReturnValueOnce(mockTodayQueryBuilder as any);
  213. await service.getSummaryStatistics(tenantId, params);
  214. expect(mockRedisUtil.set).toHaveBeenCalledWith(
  215. cacheKey,
  216. expect.any(String),
  217. 30 * 60 // 30分钟TTL(历史数据)
  218. );
  219. });
  220. });
  221. describe('getTodayStatistics', () => {
  222. it('应该从缓存返回今日统计数据', async () => {
  223. const tenantId = 1;
  224. const today = new Date().toISOString().split('T')[0];
  225. const cacheKey = `data_overview:today:${tenantId}:${today}`;
  226. const cachedStats = { todaySales: 500, todayOrders: 5 };
  227. mockRedisUtil.get.mockResolvedValue(JSON.stringify(cachedStats));
  228. const result = await service.getTodayStatistics(tenantId);
  229. expect(result).toEqual(cachedStats);
  230. expect(mockRedisUtil.get).toHaveBeenCalledWith(cacheKey);
  231. expect(mockRedisUtil.set).not.toHaveBeenCalled();
  232. });
  233. it('当缓存未命中时应该查询数据库并设置缓存', async () => {
  234. const tenantId = 1;
  235. const today = new Date().toISOString().split('T')[0];
  236. const cacheKey = `data_overview:today:${tenantId}:${today}`;
  237. mockRedisUtil.get.mockResolvedValue(null);
  238. const mockQueryBuilder = {
  239. select: vi.fn().mockReturnThis(),
  240. where: vi.fn().mockReturnThis(),
  241. andWhere: vi.fn().mockReturnThis(),
  242. getRawOne: vi.fn().mockResolvedValue({
  243. today_orders: '5',
  244. today_sales: '500.00'
  245. })
  246. };
  247. vi.mocked(mockOrderRepository.createQueryBuilder).mockReturnValue(mockQueryBuilder as any);
  248. const result = await service.getTodayStatistics(tenantId);
  249. expect(result.todaySales).toBe(500);
  250. expect(result.todayOrders).toBe(5);
  251. expect(mockRedisUtil.set).toHaveBeenCalledWith(cacheKey, expect.any(String), 5 * 60);
  252. });
  253. });
  254. describe('clearCache', () => {
  255. it('应该清理指定租户的所有缓存', async () => {
  256. const tenantId = 1;
  257. const cacheKeys = [
  258. 'data_overview:summary:1:today::',
  259. 'data_overview:today:1:2025-12-26'
  260. ];
  261. mockRedisUtil.keys.mockResolvedValue(cacheKeys);
  262. await service.clearCache(tenantId);
  263. expect(mockRedisUtil.keys).toHaveBeenCalledWith('data_overview:*:1:*');
  264. expect(mockRedisUtil.del).toHaveBeenCalledWith(...cacheKeys);
  265. });
  266. it('当没有缓存键时不应该调用del', async () => {
  267. const tenantId = 1;
  268. mockRedisUtil.keys.mockResolvedValue([]);
  269. await service.clearCache(tenantId);
  270. expect(mockRedisUtil.keys).toHaveBeenCalledWith('data_overview:*:1:*');
  271. expect(mockRedisUtil.del).not.toHaveBeenCalled();
  272. });
  273. });
  274. describe('getUserConsumptionStatistics', () => {
  275. const tenantId = 1;
  276. const mockUsers = [
  277. { userId: 1, userName: '张三', userPhone: '13800138001', totalSpent: 15000.50, orderCount: 15, avgOrderAmount: 1000.03, lastOrderDate: '2025-12-30T10:30:00Z' },
  278. { userId: 2, userName: '李四', userPhone: '13800138002', totalSpent: 12000.75, orderCount: 12, avgOrderAmount: 1000.06, lastOrderDate: '2025-12-29T14:20:00Z' },
  279. { userId: 3, userName: '王五', userPhone: '13800138003', totalSpent: 8000.25, orderCount: 8, avgOrderAmount: 1000.03, lastOrderDate: '2025-12-28T09:15:00Z' }
  280. ];
  281. beforeEach(() => {
  282. vi.clearAllMocks();
  283. });
  284. it('应该从缓存返回用户消费统计数据', async () => {
  285. const params = { timeRange: 'last30days' } as any;
  286. const paginationParams = { page: 1, limit: 10, sortBy: 'totalSpent' as const, sortOrder: 'desc' as const };
  287. const cacheKey = `data_overview:user_consumption:${tenantId}:last30days:::1:10:totalSpent:desc`;
  288. const cachedResponse = {
  289. items: mockUsers,
  290. pagination: { page: 1, limit: 10, total: 3, totalPages: 1 }
  291. };
  292. mockRedisUtil.get.mockResolvedValue(JSON.stringify(cachedResponse));
  293. const result = await service.getUserConsumptionStatistics(tenantId, params, paginationParams);
  294. expect(result).toEqual(cachedResponse);
  295. expect(mockRedisUtil.get).toHaveBeenCalledWith(cacheKey);
  296. expect(mockRedisUtil.set).not.toHaveBeenCalled();
  297. });
  298. it('当缓存未命中时应该查询数据库并设置缓存', async () => {
  299. const params = { timeRange: 'last30days' } as any;
  300. const paginationParams = { page: 1, limit: 10, sortBy: 'totalSpent' as const, sortOrder: 'desc' as const };
  301. const cacheKey = `data_overview:user_consumption:${tenantId}:last30days:::1:10:totalSpent:desc`;
  302. mockRedisUtil.get.mockResolvedValue(null);
  303. // Mock count query builder
  304. const mockCountQueryBuilder = {
  305. select: vi.fn().mockReturnThis(),
  306. where: vi.fn().mockReturnThis(),
  307. andWhere: vi.fn().mockReturnThis(),
  308. getRawOne: vi.fn().mockResolvedValue({ total_users: '3' })
  309. };
  310. // Mock main query builder
  311. const mockQueryBuilder = {
  312. select: vi.fn().mockReturnThis(),
  313. leftJoin: vi.fn().mockReturnThis(),
  314. where: vi.fn().mockReturnThis(),
  315. andWhere: vi.fn().mockReturnThis(),
  316. groupBy: vi.fn().mockReturnThis(),
  317. orderBy: vi.fn().mockReturnThis(),
  318. offset: vi.fn().mockReturnThis(),
  319. limit: vi.fn().mockReturnThis(),
  320. getRawMany: vi.fn().mockResolvedValue(mockUsers.map(user => ({
  321. userId: user.userId,
  322. userName: user.userName,
  323. userPhone: user.userPhone,
  324. totalSpent: user.totalSpent.toString(),
  325. orderCount: user.orderCount.toString(),
  326. avgOrderAmount: user.avgOrderAmount.toString(),
  327. lastOrderDate: user.lastOrderDate
  328. })))
  329. };
  330. vi.mocked(mockOrderRepository.createQueryBuilder)
  331. .mockReturnValueOnce(mockCountQueryBuilder as any)
  332. .mockReturnValueOnce(mockQueryBuilder as any);
  333. const result = await service.getUserConsumptionStatistics(tenantId, params, paginationParams);
  334. expect(result.items).toHaveLength(3);
  335. expect(result.pagination.page).toBe(1);
  336. expect(result.pagination.limit).toBe(10);
  337. expect(result.pagination.total).toBe(3);
  338. expect(result.pagination.totalPages).toBe(1);
  339. expect(result.items[0].userId).toBe(1);
  340. expect(result.items[0].userName).toBe('张三');
  341. expect(result.items[0].totalSpent).toBe(15000.50);
  342. expect(result.items[0].orderCount).toBe(15);
  343. expect(mockRedisUtil.set).toHaveBeenCalledWith(cacheKey, expect.any(String), 30 * 60);
  344. });
  345. it('应该正确处理空结果', async () => {
  346. const params = { timeRange: 'today' } as any;
  347. const paginationParams = { page: 1, limit: 10 };
  348. mockRedisUtil.get.mockResolvedValue(null);
  349. // Mock count query builder with zero results
  350. const mockCountQueryBuilder = {
  351. select: vi.fn().mockReturnThis(),
  352. where: vi.fn().mockReturnThis(),
  353. andWhere: vi.fn().mockReturnThis(),
  354. getRawOne: vi.fn().mockResolvedValue({ total_users: '0' })
  355. };
  356. vi.mocked(mockOrderRepository.createQueryBuilder)
  357. .mockReturnValueOnce(mockCountQueryBuilder as any);
  358. const result = await service.getUserConsumptionStatistics(tenantId, params, paginationParams);
  359. expect(result.items).toHaveLength(0);
  360. expect(result.pagination.total).toBe(0);
  361. expect(result.pagination.totalPages).toBe(0);
  362. });
  363. it('应该支持不同的排序字段和方向', async () => {
  364. const params = { timeRange: 'last30days' } as any;
  365. const paginationParams = { page: 1, limit: 10, sortBy: 'orderCount' as const, sortOrder: 'asc' as const };
  366. mockRedisUtil.get.mockResolvedValue(null);
  367. // Mock count query builder
  368. const mockCountQueryBuilder = {
  369. select: vi.fn().mockReturnThis(),
  370. where: vi.fn().mockReturnThis(),
  371. andWhere: vi.fn().mockReturnThis(),
  372. getRawOne: vi.fn().mockResolvedValue({ total_users: '2' })
  373. };
  374. // Mock main query builder
  375. const mockQueryBuilder = {
  376. select: vi.fn().mockReturnThis(),
  377. leftJoin: vi.fn().mockReturnThis(),
  378. where: vi.fn().mockReturnThis(),
  379. andWhere: vi.fn().mockReturnThis(),
  380. groupBy: vi.fn().mockReturnThis(),
  381. orderBy: vi.fn().mockReturnThis(),
  382. offset: vi.fn().mockReturnThis(),
  383. limit: vi.fn().mockReturnThis(),
  384. getRawMany: vi.fn().mockResolvedValue(mockUsers.slice(0, 2).map(user => ({
  385. userId: user.userId,
  386. userName: user.userName,
  387. userPhone: user.userPhone,
  388. totalSpent: user.totalSpent.toString(),
  389. orderCount: user.orderCount.toString(),
  390. avgOrderAmount: user.avgOrderAmount.toString(),
  391. lastOrderDate: user.lastOrderDate
  392. })))
  393. };
  394. vi.mocked(mockOrderRepository.createQueryBuilder)
  395. .mockReturnValueOnce(mockCountQueryBuilder as any)
  396. .mockReturnValueOnce(mockQueryBuilder as any);
  397. await service.getUserConsumptionStatistics(tenantId, params, paginationParams);
  398. // 验证orderBy被正确调用
  399. expect(mockQueryBuilder.orderBy).toHaveBeenCalled();
  400. });
  401. it('应该支持分页', async () => {
  402. const params = { timeRange: 'last30days' } as any;
  403. const paginationParams = { page: 2, limit: 5 };
  404. mockRedisUtil.get.mockResolvedValue(null);
  405. // Mock count query builder
  406. const mockCountQueryBuilder = {
  407. select: vi.fn().mockReturnThis(),
  408. where: vi.fn().mockReturnThis(),
  409. andWhere: vi.fn().mockReturnThis(),
  410. getRawOne: vi.fn().mockResolvedValue({ total_users: '15' })
  411. };
  412. // Mock main query builder
  413. const mockQueryBuilder = {
  414. select: vi.fn().mockReturnThis(),
  415. leftJoin: vi.fn().mockReturnThis(),
  416. where: vi.fn().mockReturnThis(),
  417. andWhere: vi.fn().mockReturnThis(),
  418. groupBy: vi.fn().mockReturnThis(),
  419. orderBy: vi.fn().mockReturnThis(),
  420. offset: vi.fn().mockReturnThis(),
  421. limit: vi.fn().mockReturnThis(),
  422. getRawMany: vi.fn().mockResolvedValue([])
  423. };
  424. vi.mocked(mockOrderRepository.createQueryBuilder)
  425. .mockReturnValueOnce(mockCountQueryBuilder as any)
  426. .mockReturnValueOnce(mockQueryBuilder as any);
  427. await service.getUserConsumptionStatistics(tenantId, params, paginationParams);
  428. // 验证offset被正确调用(第2页,每页5条 => offset = (2-1)*5 = 5)
  429. expect(mockQueryBuilder.offset).toHaveBeenCalledWith(5);
  430. expect(mockQueryBuilder.limit).toHaveBeenCalledWith(5);
  431. });
  432. });
  433. });