add chart api

src/main/java/com/imyeyu/api/modules/gao/controller/GaoCustomerChartController.java

@@ -0,0 +1,47 @@
+package com.imyeyu.api.modules.gao.controller;
+
+import com.imyeyu.api.modules.gao.annotation.RequireGaoPermission;
+import com.imyeyu.api.modules.gao.bean.GaoPermissionCode;
+import com.imyeyu.api.modules.gao.service.GaoCustomerChartService;
+import com.imyeyu.api.modules.gao.vo.GaoCustomerChartReq;
+import com.imyeyu.api.modules.gao.vo.GaoEventRecordCalendarView;
+import com.imyeyu.api.modules.gao.vo.GaoEventRecordDailyStatView;
+import com.imyeyu.spring.annotation.AOPLog;
+import com.imyeyu.spring.annotation.RequestRateLimit;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+/// GAO 客户报表接口
+///
+/// @author Codex
+/// @since 2026-08-11
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/gao/customer/chart")
+public class GaoCustomerChartController {
+
+	private final GaoCustomerChartService service;
+
+	/// 查询客户登记每日统计，可同时支撑登记趋势和登记事件结构图表
+	@AOPLog
+	@RequestRateLimit
+	@RequireGaoPermission(GaoPermissionCode.STAT_READ)
+	@PostMapping("/event/record/daily")
+	public List<GaoEventRecordDailyStatView> eventRecordDaily(@RequestBody GaoCustomerChartReq req) {
+		return service.eventRecordDailyStat(req);
+	}
+
+	/// 查询客户登记日历记录
+	@AOPLog
+	@RequestRateLimit
+	@RequireGaoPermission(GaoPermissionCode.STAT_READ)
+	@PostMapping("/event/record/calendar")
+	public List<GaoEventRecordCalendarView> eventRecordCalendar(@RequestBody GaoCustomerChartReq req) {
+		return service.eventRecordCalendar(req);
+	}
+}

src/main/java/com/imyeyu/api/modules/gao/controller/GaoStoreChartController.java

@@ -0,0 +1,68 @@
+package com.imyeyu.api.modules.gao.controller;
+
+import com.imyeyu.api.modules.gao.annotation.RequireGaoPermission;
+import com.imyeyu.api.modules.gao.bean.GaoPermissionCode;
+import com.imyeyu.api.modules.gao.service.GaoStoreChartService;
+import com.imyeyu.api.modules.gao.vo.GaoCustomerDailyStateView;
+import com.imyeyu.api.modules.gao.vo.GaoCustomerGenderStatView;
+import com.imyeyu.api.modules.gao.vo.GaoEventRecordCalendarView;
+import com.imyeyu.api.modules.gao.vo.GaoEventRecordDailyStatView;
+import com.imyeyu.api.modules.gao.vo.GaoStoreChartReq;
+import com.imyeyu.spring.annotation.AOPLog;
+import com.imyeyu.spring.annotation.RequestRateLimit;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+/// GAO 门店报表接口
+///
+/// @author Codex
+/// @since 2026-08-11
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/gao/store/chart")
+public class GaoStoreChartController {
+
+	private final GaoStoreChartService service;
+
+	/// 查询客户增长趋势
+	@AOPLog
+	@RequestRateLimit
+	@RequireGaoPermission(GaoPermissionCode.STAT_READ)
+	@PostMapping("/customer/daily")
+	public List<GaoCustomerDailyStateView> customerDaily(@RequestBody GaoStoreChartReq req) {
+		return service.customerDailyTrend(req);
+	}
+
+	/// 查询客户性别统计
+	@AOPLog
+	@RequestRateLimit
+	@RequireGaoPermission(GaoPermissionCode.STAT_READ)
+	@PostMapping("/customer/gender")
+	public List<GaoCustomerGenderStatView> customerGender(@RequestParam String storeId) {
+		return service.customerGender(storeId);
+	}
+
+	/// 查询登记事件每日统计，可同时支撑登记趋势和事件结构图表
+	@AOPLog
+	@RequestRateLimit
+	@RequireGaoPermission(GaoPermissionCode.STAT_READ)
+	@PostMapping("/event/record/daily")
+	public List<GaoEventRecordDailyStatView> eventRecordDaily(@RequestBody GaoStoreChartReq req) {
+		return service.eventRecordDailyStat(req);
+	}
+
+	/// 查询登记事件日历记录
+	@AOPLog
+	@RequestRateLimit
+	@RequireGaoPermission(GaoPermissionCode.STAT_READ)
+	@PostMapping("/event/record/calendar")
+	public List<GaoEventRecordCalendarView> eventRecordCalendar(@RequestBody GaoStoreChartReq req) {
+		return service.eventRecordCalendar(req);
+	}
+}

src/main/java/com/imyeyu/api/modules/gao/mapper/GaoEventRecordMapper.java

@@ -1,9 +1,13 @@
 package com.imyeyu.api.modules.gao.mapper;
 
 import com.imyeyu.api.modules.gao.entity.GaoEventRecord;
+import com.imyeyu.api.modules.gao.vo.GaoCustomerChartReq;
 import com.imyeyu.api.modules.gao.vo.GaoCustomerEventRankView;
+import com.imyeyu.api.modules.gao.vo.GaoEventRecordCalendarView;
+import com.imyeyu.api.modules.gao.vo.GaoEventRecordDailyStatView;
 import com.imyeyu.api.modules.gao.vo.GaoEventRecordPage;
 import com.imyeyu.api.modules.gao.vo.GaoEventRecordRankPage;
+import com.imyeyu.api.modules.gao.vo.GaoStoreChartReq;
 import com.imyeyu.spring.mapper.BaseMapper;
 import org.apache.ibatis.annotations.Param;
 
@@ -49,4 +53,28 @@ public interface GaoEventRecordMapper extends BaseMapper<GaoEventRecord, String>
 	/// @param page 排行榜分页请求
 	/// @return 客户登记排行榜
 	List<GaoCustomerEventRankView> selectRankByRange(GaoEventRecordRankPage page);
+
+	/// 按时间范围和事件批量统计每日登记数
+	///
+	/// @param req 门店报表查询请求
+	/// @return 每日登记数
+	List<GaoEventRecordDailyStatView> stateDailyByRange(GaoStoreChartReq req);
+
+	/// 按时间范围查询登记日历记录
+	///
+	/// @param req 门店报表查询请求
+	/// @return 日历记录列表
+	List<GaoEventRecordCalendarView> selectCalendarByRange(GaoStoreChartReq req);
+
+	/// 按客户、时间范围和事件批量统计每日登记数
+	///
+	/// @param req 客户报表查询请求
+	/// @return 每日登记数
+	List<GaoEventRecordDailyStatView> stateCustomerDailyByRange(GaoCustomerChartReq req);
+
+	/// 按客户和时间范围查询登记日历记录
+	///
+	/// @param req 客户报表查询请求
+	/// @return 日历记录列表
+	List<GaoEventRecordCalendarView> selectCustomerCalendarByRange(GaoCustomerChartReq req);
 }

src/main/java/com/imyeyu/api/modules/gao/service/GaoCustomerChartService.java

@@ -0,0 +1,20 @@
+package com.imyeyu.api.modules.gao.service;
+
+import com.imyeyu.api.modules.gao.vo.GaoCustomerChartReq;
+import com.imyeyu.api.modules.gao.vo.GaoEventRecordCalendarView;
+import com.imyeyu.api.modules.gao.vo.GaoEventRecordDailyStatView;
+
+import java.util.List;
+
+/// 客户报表服务
+///
+/// @author Codex
+/// @since 2026-08-11
+public interface GaoCustomerChartService {
+
+	/// 查询客户登记每日统计
+	List<GaoEventRecordDailyStatView> eventRecordDailyStat(GaoCustomerChartReq req);
+
+	/// 查询客户登记日历记录
+	List<GaoEventRecordCalendarView> eventRecordCalendar(GaoCustomerChartReq req);
+}

src/main/java/com/imyeyu/api/modules/gao/service/GaoStoreChartService.java

@@ -0,0 +1,28 @@
+package com.imyeyu.api.modules.gao.service;
+
+import com.imyeyu.api.modules.gao.vo.GaoCustomerDailyStateView;
+import com.imyeyu.api.modules.gao.vo.GaoCustomerGenderStatView;
+import com.imyeyu.api.modules.gao.vo.GaoEventRecordCalendarView;
+import com.imyeyu.api.modules.gao.vo.GaoEventRecordDailyStatView;
+import com.imyeyu.api.modules.gao.vo.GaoStoreChartReq;
+
+import java.util.List;
+
+/// 门店报表服务
+///
+/// @author Codex
+/// @since 2026-08-11
+public interface GaoStoreChartService {
+
+	/// 查询客户每日趋势
+	List<GaoCustomerDailyStateView> customerDailyTrend(GaoStoreChartReq req);
+
+	/// 查询客户性别统计
+	List<GaoCustomerGenderStatView> customerGender(String storeId);
+
+	/// 查询登记事件每日统计
+	List<GaoEventRecordDailyStatView> eventRecordDailyStat(GaoStoreChartReq req);
+
+	/// 查询登记事件日历记录
+	List<GaoEventRecordCalendarView> eventRecordCalendar(GaoStoreChartReq req);
+}

src/main/java/com/imyeyu/api/modules/gao/service/implement/GaoCustomerChartServiceImplement.java

@@ -0,0 +1,44 @@
+package com.imyeyu.api.modules.gao.service.implement;
+
+import com.imyeyu.api.modules.gao.mapper.GaoEventRecordMapper;
+import com.imyeyu.api.modules.gao.service.GaoCustomerChartService;
+import com.imyeyu.api.modules.gao.vo.GaoCustomerChartReq;
+import com.imyeyu.api.modules.gao.vo.GaoEventRecordCalendarView;
+import com.imyeyu.api.modules.gao.vo.GaoEventRecordDailyStatView;
+import com.imyeyu.java.bean.timi.TimiException;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+/// 客户报表服务实现
+///
+/// @author Codex
+/// @since 2026-08-11
+@Service
+@RequiredArgsConstructor
+public class GaoCustomerChartServiceImplement implements GaoCustomerChartService {
+
+	private final GaoEventRecordMapper eventRecordMapper;
+
+	@Override
+	public List<GaoEventRecordDailyStatView> eventRecordDailyStat(GaoCustomerChartReq req) {
+		checkRangeReq(req);
+		return eventRecordMapper.stateCustomerDailyByRange(req);
+	}
+
+	@Override
+	public List<GaoEventRecordCalendarView> eventRecordCalendar(GaoCustomerChartReq req) {
+		checkRangeReq(req);
+		return eventRecordMapper.selectCustomerCalendarByRange(req);
+	}
+
+	private void checkRangeReq(GaoCustomerChartReq req) {
+		TimiException.required(req, "not found req");
+		TimiException.required(req.getStoreId(), "not found req.storeId");
+		TimiException.required(req.getCustomerId(), "not found req.customerId");
+		TimiException.required(req.getBeginAt(), "not found req.beginAt");
+		TimiException.required(req.getEndAt(), "not found req.endAt");
+		TimiException.requiredTrue(req.getBeginAt() <= req.getEndAt(), "req.endAt lt req.beginAt");
+	}
+}

src/main/java/com/imyeyu/api/modules/gao/service/implement/GaoStoreChartServiceImplement.java

@@ -0,0 +1,64 @@
+package com.imyeyu.api.modules.gao.service.implement;
+
+import com.imyeyu.api.modules.gao.mapper.GaoEventRecordMapper;
+import com.imyeyu.api.modules.gao.service.GaoCustomerService;
+import com.imyeyu.api.modules.gao.service.GaoStoreChartService;
+import com.imyeyu.api.modules.gao.vo.GaoCustomerDailyStateView;
+import com.imyeyu.api.modules.gao.vo.GaoCustomerGenderStatView;
+import com.imyeyu.api.modules.gao.vo.GaoCustomerTrendStateReq;
+import com.imyeyu.api.modules.gao.vo.GaoEventRecordCalendarView;
+import com.imyeyu.api.modules.gao.vo.GaoEventRecordDailyStatView;
+import com.imyeyu.api.modules.gao.vo.GaoStoreChartReq;
+import com.imyeyu.java.bean.timi.TimiException;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+/// 门店报表服务实现
+///
+/// @author Codex
+/// @since 2026-08-11
+@Service
+@RequiredArgsConstructor
+public class GaoStoreChartServiceImplement implements GaoStoreChartService {
+
+	private final GaoCustomerService customerService;
+	private final GaoEventRecordMapper eventRecordMapper;
+
+	@Override
+	public List<GaoCustomerDailyStateView> customerDailyTrend(GaoStoreChartReq req) {
+		checkRangeReq(req);
+		GaoCustomerTrendStateReq statReq = new GaoCustomerTrendStateReq();
+		statReq.setStoreId(req.getStoreId());
+		statReq.setBeginCreatedAt(req.getBeginAt());
+		statReq.setEndCreatedAt(req.getEndAt());
+		return customerService.stateDailyTrend(statReq);
+	}
+
+	@Override
+	public List<GaoCustomerGenderStatView> customerGender(String storeId) {
+		TimiException.required(storeId, "not found storeId");
+		return customerService.stateGender(storeId);
+	}
+
+	@Override
+	public List<GaoEventRecordDailyStatView> eventRecordDailyStat(GaoStoreChartReq req) {
+		checkRangeReq(req);
+		return eventRecordMapper.stateDailyByRange(req);
+	}
+
+	@Override
+	public List<GaoEventRecordCalendarView> eventRecordCalendar(GaoStoreChartReq req) {
+		checkRangeReq(req);
+		return eventRecordMapper.selectCalendarByRange(req);
+	}
+
+	private void checkRangeReq(GaoStoreChartReq req) {
+		TimiException.required(req, "not found req");
+		TimiException.required(req.getStoreId(), "not found req.storeId");
+		TimiException.required(req.getBeginAt(), "not found req.beginAt");
+		TimiException.required(req.getEndAt(), "not found req.endAt");
+		TimiException.requiredTrue(req.getBeginAt() <= req.getEndAt(), "req.endAt lt req.beginAt");
+	}
+}

src/main/java/com/imyeyu/api/modules/gao/vo/GaoCustomerChartReq.java

@@ -0,0 +1,28 @@
+package com.imyeyu.api.modules.gao.vo;
+
+import lombok.Data;
+
+import java.util.List;
+
+/// 客户报表查询请求
+///
+/// @author Codex
+/// @since 2026-08-11
+@Data
+public class GaoCustomerChartReq {
+
+	/// 门店 ID
+	private String storeId;
+
+	/// 客户 ID
+	private String customerId;
+
+	/// 开始时间
+	private Long beginAt;
+
+	/// 结束时间
+	private Long endAt;
+
+	/// 登记事件 ID 列表
+	private List<String> eventIdList;
+}

src/main/java/com/imyeyu/api/modules/gao/vo/GaoEventRecordCalendarView.java

@@ -0,0 +1,29 @@
+package com.imyeyu.api.modules.gao.vo;
+
+import lombok.Data;
+
+/// 登记事件日历记录视图
+///
+/// @author Codex
+/// @since 2026-08-11
+@Data
+public class GaoEventRecordCalendarView {
+
+	/// 登记记录 ID
+	private String id;
+
+	/// 客户 ID
+	private String customerId;
+
+	/// 客户编码
+	private String customerCode;
+
+	/// 客户姓名
+	private String customerName;
+
+	/// 登记事件 ID
+	private String eventId;
+
+	/// 登记时间
+	private Long registeredAt;
+}

src/main/java/com/imyeyu/api/modules/gao/vo/GaoEventRecordDailyStatView.java

@@ -0,0 +1,20 @@
+package com.imyeyu.api.modules.gao.vo;
+
+import lombok.Data;
+
+/// 登记事件每日统计视图
+///
+/// @author Codex
+/// @since 2026-08-11
+@Data
+public class GaoEventRecordDailyStatView {
+
+	/// 登记事件 ID
+	private String eventId;
+
+	/// 日期值，格式为 yyyyMMdd
+	private Integer dateValue;
+
+	/// 当日登记数
+	private Long dailyCount;
+}

src/main/java/com/imyeyu/api/modules/gao/vo/GaoStoreChartReq.java

@@ -0,0 +1,25 @@
+package com.imyeyu.api.modules.gao.vo;
+
+import lombok.Data;
+
+import java.util.List;
+
+/// 门店报表查询请求
+///
+/// @author Codex
+/// @since 2026-08-11
+@Data
+public class GaoStoreChartReq {
+
+	/// 门店 ID
+	private String storeId;
+
+	/// 开始时间
+	private Long beginAt;
+
+	/// 结束时间
+	private Long endAt;
+
+	/// 登记事件 ID 列表
+	private List<String> eventIdList;
+}

src/main/resources/mapper/timi-server/GaoEventRecordMapper.xml

@@ -203,4 +203,93 @@
 			ORDER BY `rank`
 			LIMIT #{offset}, #{limit}
 	</select>
+
+	<sql id="storeChartRangeWhere">
+		r.`store_id` = #{storeId}
+		AND r.`registered_at` &gt;= #{beginAt}
+		AND r.`registered_at` &lt;= #{endAt}
+		AND r.`deleted_at` IS NULL
+		<if test="eventIdList != null and eventIdList.size() > 0">
+			AND r.`event_id` IN
+			<foreach collection="eventIdList" item="eventId" open="(" separator="," close=")">
+				#{eventId}
+			</foreach>
+		</if>
+	</sql>
+	<select id="stateDailyByRange" resultType="com.imyeyu.api.modules.gao.vo.GaoEventRecordDailyStatView">
+		SELECT
+			r.`event_id` AS `eventId`,
+			r.`registered_date_value` AS `dateValue`,
+			COUNT(1) AS `dailyCount`
+		FROM `gao_event_record` r
+		WHERE
+			<include refid="storeChartRangeWhere"/>
+		GROUP BY
+			r.`event_id`,
+			r.`registered_date_value`
+		ORDER BY
+			r.`registered_date_value` ASC,
+			r.`event_id` ASC
+	</select>
+	<select id="selectCalendarByRange" resultType="com.imyeyu.api.modules.gao.vo.GaoEventRecordCalendarView">
+		SELECT
+			r.`id`,
+			r.`customer_id` AS `customerId`,
+			c.`code` AS `customerCode`,
+			c.`name` AS `customerName`,
+			r.`event_id` AS `eventId`,
+			r.`registered_at` AS `registeredAt`
+		FROM `gao_event_record` r
+		LEFT JOIN `gao_customer` c ON r.`customer_id` = c.`id` AND c.`deleted_at` IS NULL
+		WHERE
+			<include refid="storeChartRangeWhere"/>
+		ORDER BY
+			r.`registered_at` ASC,
+			r.`created_at` ASC
+	</select>
+
+	<sql id="customerChartRangeWhere">
+		r.`store_id` = #{storeId}
+		AND r.`customer_id` = #{customerId}
+		AND r.`registered_at` &gt;= #{beginAt}
+		AND r.`registered_at` &lt;= #{endAt}
+		AND r.`deleted_at` IS NULL
+		<if test="eventIdList != null and eventIdList.size() > 0">
+			AND r.`event_id` IN
+			<foreach collection="eventIdList" item="eventId" open="(" separator="," close=")">
+				#{eventId}
+			</foreach>
+		</if>
+	</sql>
+	<select id="stateCustomerDailyByRange" resultType="com.imyeyu.api.modules.gao.vo.GaoEventRecordDailyStatView">
+		SELECT
+			r.`event_id` AS `eventId`,
+			r.`registered_date_value` AS `dateValue`,
+			COUNT(1) AS `dailyCount`
+		FROM `gao_event_record` r
+		WHERE
+			<include refid="customerChartRangeWhere"/>
+		GROUP BY
+			r.`event_id`,
+			r.`registered_date_value`
+		ORDER BY
+			r.`registered_date_value` ASC,
+			r.`event_id` ASC
+	</select>
+	<select id="selectCustomerCalendarByRange" resultType="com.imyeyu.api.modules.gao.vo.GaoEventRecordCalendarView">
+		SELECT
+			r.`id`,
+			r.`customer_id` AS `customerId`,
+			c.`code` AS `customerCode`,
+			c.`name` AS `customerName`,
+			r.`event_id` AS `eventId`,
+			r.`registered_at` AS `registeredAt`
+		FROM `gao_event_record` r
+		LEFT JOIN `gao_customer` c ON r.`customer_id` = c.`id` AND c.`deleted_at` IS NULL
+		WHERE
+			<include refid="customerChartRangeWhere"/>
+		ORDER BY
+			r.`registered_at` DESC,
+			r.`created_at` DESC
+	</select>
 </mapper>