feat(platform): add vehicle data management console

vehicle-data-platform/apps/api/internal/platform/mysql_queries.go

@@ -0,0 +1,81 @@
+package platform
+
+import (
+	"net/url"
+	"strconv"
+	"strings"
+)
+
+type SQLQuery struct {
+	Text string
+	Args []any
+}
+
+func buildVehicleListSQL(query url.Values) SQLQuery {
+	limit := parsePositive(query.Get("limit"), 20)
+	offset := parsePositive(query.Get("offset"), 0)
+	args := []any{}
+	where := []string{"1 = 1"}
+	if keyword := strings.TrimSpace(query.Get("keyword")); keyword != "" {
+		where = append(where, "(b.vin LIKE ? OR b.plate LIKE ? OR b.phone LIKE ? OR b.oem LIKE ?)")
+		like := "%" + keyword + "%"
+		args = append(args, like, like, like, like)
+	}
+	if protocol := strings.TrimSpace(query.Get("protocol")); protocol != "" {
+		where = append(where, "s.protocol = ?")
+		args = append(args, protocol)
+	}
+	args = append(args, limit, offset)
+	return SQLQuery{
+		Text: `SELECT b.vin, b.plate, b.phone, b.oem, COALESCE(s.protocol, '') AS protocol, ` +
+			`CASE WHEN s.updated_at >= DATE_SUB(NOW(), INTERVAL 1 MINUTE) THEN 1 ELSE 0 END AS online, ` +
+			`COALESCE(DATE_FORMAT(s.updated_at, '%Y-%m-%d %H:%i:%s'), '') AS last_seen, ` +
+			`COALESCE(CONCAT(l.longitude, ',', l.latitude), '') AS location_text, ` +
+			`CASE WHEN b.vin IS NOT NULL AND b.vin <> '' THEN 100 ELSE 0 END AS binding_score ` +
+			`FROM vehicle_identity_binding b ` +
+			`LEFT JOIN vehicle_realtime_snapshot s ON s.vin = b.vin ` +
+			`LEFT JOIN vehicle_realtime_location l ON l.vin = b.vin ` +
+			`WHERE ` + strings.Join(where, " AND ") + ` ORDER BY s.updated_at DESC LIMIT ? OFFSET ?`,
+		Args: args,
+	}
+}
+
+func buildDailyMileageSQL(query url.Values) SQLQuery {
+	limit := parsePositive(query.Get("limit"), 20)
+	offset := parsePositive(query.Get("offset"), 0)
+	args := []any{}
+	where := []string{"1 = 1"}
+	if vin := strings.TrimSpace(query.Get("vin")); vin != "" {
+		where = append(where, "m.vin = ?")
+		args = append(args, vin)
+	}
+	if dateFrom := strings.TrimSpace(query.Get("dateFrom")); dateFrom != "" {
+		where = append(where, "m.stat_date >= ?")
+		args = append(args, dateFrom)
+	}
+	if dateTo := strings.TrimSpace(query.Get("dateTo")); dateTo != "" {
+		where = append(where, "m.stat_date <= ?")
+		args = append(args, dateTo)
+	}
+	args = append(args, limit, offset)
+	return SQLQuery{
+		Text: `SELECT m.vin, COALESCE(b.plate, '') AS plate, DATE_FORMAT(m.stat_date, '%Y-%m-%d') AS stat_date, ` +
+			`m.first_total_mileage_km, m.latest_total_mileage_km, m.daily_mileage_km, m.protocol ` +
+			`FROM vehicle_daily_mileage m LEFT JOIN vehicle_identity_binding b ON b.vin = m.vin ` +
+			`WHERE ` + strings.Join(where, " AND ") + ` ORDER BY m.stat_date DESC LIMIT ? OFFSET ?`,
+		Args: args,
+	}
+}
+
+func buildLimitOffset(query url.Values) (int, int) {
+	return parsePositive(query.Get("limit"), 20), parsePositive(query.Get("offset"), 0)
+}
+
+func parseLimitOffset(rawLimit, rawOffset string) (int, int) {
+	return parsePositive(rawLimit, 20), parsePositive(rawOffset, 0)
+}
+
+func mustInt(value string) int {
+	n, _ := strconv.Atoi(value)
+	return n
+}