Subversion Repositories SmartDukaan

package com.spice.profitmandi.dao.service;

import org.hibernate.Session;

import org.hibernate.SessionFactory;

import org.hibernate.query.NativeQuery;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.stereotype.Service;

import java.util.*;

/**

 * Period analytics for the Beat Journey console — read-only native SQL, scoped to

 * the caller's downline via the auth-id / dtr-id sets, with {@code IN (:ids)} scope

 * filters and blocks for KPIs, funnel, scorecard, coverage, utilization, deferrals,

 * travel, outcomes, and findings.

 *

 * Empty scope is handled by substituting a sentinel id (-1) so every {@code IN}

 * clause is valid and simply returns zeros rather than throwing.

 */

@Service

public class BeatJourneyServiceImpl implements BeatJourneyService {

    @Autowired

    private SessionFactory sessionFactory;

    @Override

    public Map<String, Object> periodAnalytics(String start, String end, String today,

                                               List<Integer> authIds, List<Integer> dtrIds) {

        Session s = sessionFactory.getCurrentSession();

        List<Integer> auth = safeIds(authIds);

        List<Integer> dtr = safeIds(dtrIds);

        Map<String, Object> out = new LinkedHashMap<>();

        Map<String, Object> range = new LinkedHashMap<>();

        range.put("start", start);

        range.put("end", end);

        range.put("today", today);

        out.put("range", range);

        out.put("scopeCount", authIds == null ? 0 : authIds.size());

        List<Map<String, Object>> coverage = coverageByLevel(s, start, end, auth);

        Map<String, Object> funnel = funnel(s, start, end, auth, dtr);

        Map<String, Object> summary = journeySummary(s, start, end, dtr, funnel);

        Map<String, Object> deferral = deferral(s, start, end, auth);

        Map<String, Object> utilization = utilization(s, start, end, dtr);

        Map<String, Object> travel = travel(s, start, end, auth, dtr);

        Map<String, Object> outcomes = outcomes(s, start, end, auth);

        List<Map<String, Object>> scorecard = scorecard(s, start, end, auth, dtr);

        Map<String, Object> kpis = kpis(s, start, end, auth, dtr, coverage, funnel, deferral);

        out.put("kpis", kpis);

        out.put("funnel", funnel);

        out.put("summary", summary);

        out.put("coverageByLevel", coverage);

        out.put("scorecard", scorecard);

        out.put("utilization", utilization);

        out.put("deferral", deferral);

        out.put("travel", travel);

        out.put("outcomes", outcomes);

        out.put("findings", findings(kpis, funnel, deferral, utilization, travel, outcomes, coverage, scorecard));

        // drill-down lists

        out.put("coverageDetail", coverageDetail(s, start, end, auth));

        out.put("deferralsList", deferralsList(s, start, end, auth));

        out.put("leadsList", leadsList(s, start, end, auth));

        return out;

    }

    // ---- KPIs ---------------------------------------------------------------

    private Map<String, Object> kpis(Session s, String ms, String me, List<Integer> auth, List<Integer> dtr,

                                     List<Map<String, Object>> coverage, Map<String, Object> funnel, Map<String, Object> deferral) {

        Map<String, Object> m = new LinkedHashMap<>();

        long planned = asLong(funnel.get("plannedStops"));

        // Adherence is planned-visit completion: the numerator counts only completed

        // PLANNED visits (partner franchisee + approved leads), not every check-out

        // (ad-hoc office/warehouse stops don't count toward planned-visit adherence).

        // Self-assigned stops are excluded: task_name is pipe-delimited and ends with

        // a "… | SELF" marker for self-assigned visits, which aren't part of the plan.

        long done = countVisits(s, ms, me, dtr, "task_type IN ('franchisee-visit','lead') AND COALESCE(task_name,'') NOT LIKE '%SELF%' AND mark_type LIKE '%CHECKOUT%'");

        m.put("plannedStops", planned);

        m.put("doneStops", done);

        m.put("adherencePct", planned == 0 ? 0 : Math.round(100.0 * done / planned));

        // L1 coverage row

        long l1With = 0, l1Total = 0;

        for (Map<String, Object> c : coverage) {

            if ("L1".equalsIgnoreCase(asStr(c.get("level")))) {

                l1With = asLong(c.get("withPjp"));

                l1Total = asLong(c.get("totalUsers"));

            }

        }

        m.put("coverageL1With", l1With);

        m.put("coverageL1Total", l1Total);

        m.put("coverageL1Pct", l1Total == 0 ? 0 : Math.round(100.0 * l1With / l1Total));

        // avg visits / active (punched-in) day, and total punch-in days (journeys)

        // A "punch-in day" is the attendance row (task_id=0) with a real check-in

        // time, matching the Today lens. (Literal mark_type='PUNCHIN' rows barely

        // exist in the data, so relying on them under-counts drastically.)

        NativeQuery<?> q = s.createNativeQuery(

            "SELECT COUNT(DISTINCT CONCAT(user_id,'-',task_date)) FROM auth.location_tracking" +

            " WHERE task_date>=:ms AND task_date<=:me AND user_id IN (:dtr)" +

            "   AND (mark_type='PUNCHIN' OR (task_id=0 AND check_in_time IS NOT NULL AND check_in_time<>'00:00:00'))");

        q.setParameter("ms", ms).setParameter("me", me).setParameterList("dtr", dtr);

        long journeys = asLong(q.uniqueResult());

        m.put("journeys", journeys);

        m.put("avgVisitsPerActiveDay", journeys == 0 ? 0 : round1((double) asLong(funnel.get("checkedIn")) / journeys));

        // partner (franchisee) visits per active day — the subset that are partner

        // store visits, shown alongside the all-types visit average.

        long partnerCheckins = countVisits(s, ms, me, dtr, "task_type='franchisee-visit' AND mark_type LIKE 'CHECKIN%'");

        m.put("avgPartnersPerActiveDay", journeys == 0 ? 0 : round1((double) partnerCheckins / journeys));

        // lead visits per active day — planned (on the PJP / lead_route) and unplanned

        // (self-assigned ad-hoc) leads combined.

        long leadCheckins = countVisits(s, ms, me, dtr, "task_type='lead' AND mark_type LIKE 'CHECKIN%'");

        m.put("avgLeadsPerActiveDay", journeys == 0 ? 0 : round1((double) leadCheckins / journeys));

        // avg in-store discussion minutes — overall, plus partner (franchisee) and

        // lead split so the card can show each separately.

        m.put("avgDiscussionMin", avgDiscussionMin(s, ms, me, dtr, null));

        m.put("avgDiscussionPartnerMin", avgDiscussionMin(s, ms, me, dtr, "franchisee-visit"));

        m.put("avgDiscussionLeadMin", avgDiscussionMin(s, ms, me, dtr, "lead"));

        // Auto "missed" = situations where planned execution broke down, split into

        // three causes: execs with no PJP at all, scheduled beat-days with the agenda

        // left unfilled, and scheduled beat-days the owner never punched in on.

        Map<String, Object> mb = missedBreakdown(s, ms, me, auth, coverage);

        m.put("autoMissedUnscheduled", mb.get("unscheduled"));

        m.put("autoMissedUnfilledAgenda", mb.get("unfilledAgenda"));

        m.put("autoMissedMissedPunchin", mb.get("missedPunchin"));

        m.put("autoMissed", mb.get("total"));

        m.put("autoMissedSystemPct", asLong(deferral.get("systemPct")));

        // leads created on route

        NativeQuery<?> lq = s.createNativeQuery(

            "SELECT COUNT(*) FROM `user`.lead WHERE created_timestamp>=:ms AND created_timestamp<=CONCAT(:me,' 23:59:59') AND auth_id IN (:auth)");

        lq.setParameter("ms", ms).setParameter("me", me).setParameterList("auth", auth);

        m.put("leadsCreated", asLong(lq.uniqueResult()));

        return m;

    }

    // ---- Funnel -------------------------------------------------------------

    private Map<String, Object> funnel(Session s, String ms, String me, List<Integer> auth, List<Integer> dtr) {

        Map<String, Object> m = new LinkedHashMap<>();

        // Planned stops = partner stops (beat_route) + lead stops (lead_route, APPROVED)

        // on each scheduled beat-day, over active beats — exactly how the Today lens

        // (getAllScheduledBeats) counts, so Period reconciles with the day views.

        long planned = plannedCount(s, ms, me, auth, dtr, false, false)

                     + plannedCount(s, ms, me, auth, dtr, true, false);

        // ...of those, the planned stops that fall on a day the owner punched in

        long punchedIn = plannedCount(s, ms, me, auth, dtr, false, true)

                       + plannedCount(s, ms, me, auth, dtr, true, true);

        long checkedIn = countVisits(s, ms, me, dtr, "mark_type LIKE 'CHECKIN%'");

        long checkedOut = countVisits(s, ms, me, dtr, "(mark_type LIKE '%CHECKOUT%')");

        m.put("plannedStops", planned);

        m.put("punchedIn", punchedIn);

        m.put("checkedIn", checkedIn);

        m.put("checkedOut", checkedOut);

        m.put("dropPunch", planned == 0 ? 0 : Math.round(100.0 * (planned - punchedIn) / planned));

        m.put("dropCheckin", punchedIn == 0 ? 0 : Math.round(100.0 * (punchedIn - checkedIn) / punchedIn));

        m.put("dropCheckout", checkedIn == 0 ? 0 : Math.round(100.0 * (checkedIn - checkedOut) / checkedIn));

        return m;

    }

    // Planned stop count over scheduled beat-days of active beats. lead=false counts

    // partner stops (beat_route by day_number); lead=true counts approved lead stops

    // (lead_route by schedule_date). onlyPunchInDays restricts to days the owner

    // actually punched in (the funnel's "planned on punch-in days" stage).

    private long plannedCount(Session s, String ms, String me, List<Integer> auth,

                              List<Integer> dtr, boolean lead, boolean onlyPunchInDays) {

        String stopJoin = lead

            ? " JOIN `user`.lead_route x ON x.beat_id=sc.beat_id AND x.schedule_date=sc.start_date AND x.status='APPROVED'"

            : " JOIN `user`.beat_route x ON x.beat_id=sc.beat_id AND x.day_number=sc.day_number";

        String punchJoin = onlyPunchInDays

            ? " JOIN auth.auth_user au ON au.id=b.auth_user_id" +

              " JOIN dtr.users du ON du.email=au.email_id" +

              " JOIN (SELECT DISTINCT user_id, task_date FROM auth.location_tracking" +

              "        WHERE task_date>=:ms AND task_date<=:me AND user_id IN (:dtr)" +

              "          AND (mark_type='PUNCHIN' OR (task_id=0 AND check_in_time IS NOT NULL AND check_in_time<>'00:00:00'))) p" +

              "   ON p.user_id=du.id AND p.task_date=sc.start_date"

            : "";

        NativeQuery<?> q = s.createNativeQuery(

            "SELECT COUNT(*) FROM `user`.beat_schedule sc" +

            " JOIN `user`.beat b ON b.id=sc.beat_id AND b.active=1 AND b.auth_user_id IN (:auth)" +

            stopJoin + punchJoin +

            " WHERE sc.start_date>=:ms AND sc.start_date<=:me");

        q.setParameter("ms", ms).setParameter("me", me).setParameterList("auth", auth);

        if (onlyPunchInDays) q.setParameterList("dtr", dtr);

        return asLong(q.uniqueResult());

    }

    // Counts visits across ALL task types (franchisee + lead + office) — task_id<>0

    // excludes the attendance/punch row — matching the Today lens, which tallies

    // every check-in/out regardless of type.

    private long countVisits(Session s, String ms, String me, List<Integer> dtr, String markPredicate) {

        NativeQuery<?> q = s.createNativeQuery(

            "SELECT COUNT(*) FROM auth.location_tracking" +

            " WHERE task_date>=:ms AND task_date<=:me AND task_id<>0 AND " + markPredicate +

            " AND user_id IN (:dtr)");

        q.setParameter("ms", ms).setParameter("me", me).setParameterList("dtr", dtr);

        return asLong(q.uniqueResult());

    }

    // Avg in-store discussion minutes over checked-out visits. taskType null =

    // all visit types; otherwise restricted to that task_type (e.g. franchisee / lead).

    private long avgDiscussionMin(Session s, String ms, String me, List<Integer> dtr, String taskType) {

        NativeQuery<?> q = s.createNativeQuery(

            "SELECT ROUND(AVG(TIME_TO_SEC(check_out_time)-TIME_TO_SEC(check_in_time))/60,0) FROM auth.location_tracking" +

            " WHERE task_date>=:ms AND task_date<=:me AND task_id<>0 AND mark_type LIKE '%CHECKOUT%'" +

            " AND check_in_time IS NOT NULL AND check_in_time<>'00:00:00'" +

            " AND check_out_time IS NOT NULL AND check_out_time<>'00:00:00'" +

            " AND TIME_TO_SEC(check_out_time) > TIME_TO_SEC(check_in_time)" +

            (taskType != null ? " AND task_type=:tt" : "") +

            " AND user_id IN (:dtr)");

        q.setParameter("ms", ms).setParameter("me", me).setParameterList("dtr", dtr);

        if (taskType != null) q.setParameter("tt", taskType);

        return asLong(q.uniqueResult());

    }

    // ---- Journey summary table ---------------------------------------------

    // A flat per-period scorecard split into Planned (on the PJP / lead_route, no

    // SELF marker) vs Self Assigned (the ad-hoc "… | SELF" visits the exec added):

    //   Total Visits   — planned = scheduled planned stops; self = self-assigned check-ins

    //   Avg Time Spent — avg (check-out − check-in) minutes, each side

    //   Idle/Break     — average idle minutes per active day (single value)

    //   Deferred       — total − completed, each side (what was never closed out)

    //   Completed      — checkouts, each side

    private Map<String, Object> journeySummary(Session s, String ms, String me, List<Integer> dtr,

                                               Map<String, Object> funnel) {

        long plannedVisits   = asLong(funnel.get("plannedStops"));

        long completedPlanned = countVisits(s, ms, me, dtr, "task_type IN ('franchisee-visit','lead') AND COALESCE(task_name,'') NOT LIKE '%SELF%' AND mark_type LIKE '%CHECKOUT%'");

        long selfVisits      = countVisits(s, ms, me, dtr, "COALESCE(task_name,'') LIKE '%SELF%' AND mark_type LIKE 'CHECKIN%'");

        long completedSelf   = countVisits(s, ms, me, dtr, "COALESCE(task_name,'') LIKE '%SELF%' AND mark_type LIKE '%CHECKOUT%'");

        // idle = working − in-store − travel, averaged over active (punch-in) days

        NativeQuery<?> uq = s.createNativeQuery(

            "SELECT" +

            " (SELECT COALESCE(SUM(TIME_TO_SEC(time_spent)),0) FROM auth.location_tracking WHERE task_date>=:ms AND task_date<=:me AND task_id<>0 AND user_id IN (:dtr)) instore," +

            " (SELECT COALESCE(SUM(TIME_TO_SEC(transit_time)),0) FROM auth.location_tracking WHERE task_date>=:ms AND task_date<=:me AND task_id<>0 AND user_id IN (:dtr)) travel," +

            " (SELECT COALESCE(SUM(GREATEST(TIME_TO_SEC(check_out_time)-TIME_TO_SEC(check_in_time),0)),0) FROM auth.location_tracking WHERE task_date>=:ms AND task_date<=:me AND task_id=0 AND check_out_time IS NOT NULL AND check_out_time<>'00:00:00' AND check_in_time IS NOT NULL AND check_in_time<>'00:00:00' AND user_id IN (:dtr)) working," +

            " (SELECT COUNT(DISTINCT CONCAT(user_id,'-',task_date)) FROM auth.location_tracking WHERE task_date>=:ms AND task_date<=:me AND user_id IN (:dtr) AND (mark_type='PUNCHIN' OR (task_id=0 AND check_in_time IS NOT NULL AND check_in_time<>'00:00:00'))) journeys");

        uq.setParameter("ms", ms).setParameter("me", me).setParameterList("dtr", dtr);

        Object[] ur = (Object[]) uq.uniqueResult();

        double instore = asDouble(ur[0]), travel = asDouble(ur[1]), working = asDouble(ur[2]);

        long journeys = asLong(ur[3]);

        if (working < instore + travel) working = instore + travel;

        double idle = Math.max(working - instore - travel, 0);

        long idleAvgMin = journeys == 0 ? 0 : Math.round(idle / journeys / 60.0);

        Map<String, Object> m = new LinkedHashMap<>();

        m.put("plannedVisits", plannedVisits);

        m.put("selfVisits", selfVisits);

        m.put("avgTimeAllMin", avgTimeSpentMin(s, ms, me, dtr, null));   // planned + self combined

        m.put("idleAvgMin", idleAvgMin);

        m.put("deferredPlanned", Math.max(plannedVisits - completedPlanned, 0));

        m.put("deferredSelf", Math.max(selfVisits - completedSelf, 0));

        m.put("completedPlanned", completedPlanned);

        m.put("completedSelf", completedSelf);

        return m;

    }

    // Avg (check-out − check-in) minutes over checked-out visits. self==null covers

    // all visits (planned + self); true/false restricts to the pipe-delimited

    // "… | SELF" self-assigned visits or the planned ones respectively.

    private long avgTimeSpentMin(Session s, String ms, String me, List<Integer> dtr, Boolean self) {

        NativeQuery<?> q = s.createNativeQuery(

            "SELECT ROUND(AVG(TIME_TO_SEC(check_out_time)-TIME_TO_SEC(check_in_time))/60,0) FROM auth.location_tracking" +

            " WHERE task_date>=:ms AND task_date<=:me AND task_id<>0 AND mark_type LIKE '%CHECKOUT%'" +

            " AND check_in_time IS NOT NULL AND check_in_time<>'00:00:00'" +

            " AND check_out_time IS NOT NULL AND check_out_time<>'00:00:00'" +

            " AND TIME_TO_SEC(check_out_time) > TIME_TO_SEC(check_in_time)" +

            (self == null ? "" : self ? " AND COALESCE(task_name,'') LIKE '%SELF%'" : " AND COALESCE(task_name,'') NOT LIKE '%SELF%'") +

            " AND user_id IN (:dtr)");

        q.setParameter("ms", ms).setParameter("me", me).setParameterList("dtr", dtr);

        return asLong(q.uniqueResult());

    }

    // ---- Coverage by level --------------------------------------------------

    private List<Map<String, Object>> coverageByLevel(Session s, String ms, String me, List<Integer> auth) {

        NativeQuery<?> q = s.createNativeQuery(

            "SELECT p.escalation_type lvl, COUNT(DISTINCT p.auth_user_id) total_users," +

            " COUNT(DISTINCT CASE WHEN sc.id IS NOT NULL THEN p.auth_user_id END) with_pjp" +

            " FROM cs.position p" +

            " LEFT JOIN `user`.beat b ON b.auth_user_id=p.auth_user_id AND b.active=1" +

            " LEFT JOIN `user`.beat_schedule sc ON sc.beat_id=b.id AND sc.start_date>=:ms AND sc.start_date<=:me" +

            " WHERE p.category_id=4 AND p.auth_user_id IN (:auth) AND LOWER(p.escalation_type) NOT IN ('l4','l5','final') GROUP BY p.escalation_type ORDER BY p.escalation_type");

        q.setParameter("ms", ms).setParameter("me", me).setParameterList("auth", auth);

        List<Map<String, Object>> list = new ArrayList<>();

        for (Object o : q.getResultList()) {

            Object[] r = (Object[]) o;

            long total = asLong(r[1]), with = asLong(r[2]);

            Map<String, Object> m = new LinkedHashMap<>();

            m.put("level", asStr(r[0]));

            m.put("totalUsers", total);

            m.put("withPjp", with);

            m.put("coveragePct", total == 0 ? 0 : Math.round(100.0 * with / total));

            list.add(m);

        }

        return list;

    }

    // ---- Per-executive scorecard -------------------------------------------

    private List<Map<String, Object>> scorecard(Session s, String ms, String me, List<Integer> auth, List<Integer> dtr) {

        NativeQuery<?> q = s.createNativeQuery(

            "SELECT au.id uid, TRIM(CONCAT(au.first_name,' ',COALESCE(au.last_name,''))) nm, lvl.lvl," +

            " COALESCE(pl.planned,0)+COALESCE(plL.planned,0) planned, COALESCE(ac.done,0) done," +

            " COALESCE(ds.disc_min,0) disc_min, COALESCE(wk.work_sec,0) work_sec," +

            " COALESCE(ld.leads,0) leads, du.id duid, COALESCE(acp.donep,0) donep," +

            // Active days + lead / franchisee check-ins, for the per-active-day

            // visit averages (same definitions as the Period KPI cards).

            " COALESCE(ad.days,0) act_days, COALESCE(lv.lvis,0) lvis, COALESCE(fv.fvis,0) fvis" +

            " FROM (SELECT DISTINCT auth_user_id FROM `user`.beat WHERE active=1 AND auth_user_id IN (:auth)) o" +

            " JOIN auth.auth_user au ON au.id=o.auth_user_id" +

            " LEFT JOIN dtr.users du ON du.email=au.email_id" +

            " LEFT JOIN (SELECT auth_user_id, MIN(escalation_type) lvl FROM cs.position WHERE category_id=4 AND LOWER(escalation_type) NOT IN ('l4','l5','final') GROUP BY auth_user_id) lvl ON lvl.auth_user_id=au.id" +

            " LEFT JOIN (SELECT b.auth_user_id uid, COUNT(*) planned FROM `user`.beat_schedule sc" +

            "   JOIN `user`.beat b ON b.id=sc.beat_id AND b.active=1 JOIN `user`.beat_route r ON r.beat_id=sc.beat_id AND r.day_number=sc.day_number" +

            "   WHERE sc.start_date>=:ms AND sc.start_date<=:me GROUP BY b.auth_user_id) pl ON pl.uid=au.id" +

            " LEFT JOIN (SELECT b.auth_user_id uid, COUNT(*) planned FROM `user`.beat_schedule sc" +

            "   JOIN `user`.beat b ON b.id=sc.beat_id AND b.active=1 JOIN `user`.lead_route lr ON lr.beat_id=sc.beat_id AND lr.schedule_date=sc.start_date AND lr.status='APPROVED'" +

            "   WHERE sc.start_date>=:ms AND sc.start_date<=:me GROUP BY b.auth_user_id) plL ON plL.uid=au.id" +

            " LEFT JOIN (SELECT user_id uid, COUNT(*) done FROM auth.location_tracking" +

            "   WHERE task_date>=:ms AND task_date<=:me AND task_id<>0 AND mark_type LIKE 'CHECKIN%' GROUP BY user_id) ac ON ac.uid=du.id" +

            // Adherence numerator: completed PLANNED visits only (partner franchisee +

            // approved leads), excluding ad-hoc office/warehouse stops and self-assigned

            // stops (task_name carries a "… | SELF" marker, which aren't part of the plan).

            " LEFT JOIN (SELECT user_id uid, COUNT(*) donep FROM auth.location_tracking" +

            "   WHERE task_date>=:ms AND task_date<=:me AND task_id<>0 AND task_type IN ('franchisee-visit','lead') AND COALESCE(task_name,'') NOT LIKE '%SELF%' AND mark_type LIKE '%CHECKOUT%' GROUP BY user_id) acp ON acp.uid=du.id" +

            " LEFT JOIN (SELECT user_id uid, ROUND(AVG(NULLIF(TIME_TO_SEC(time_spent),0))/60,0) disc_min FROM auth.location_tracking" +

            "   WHERE task_date>=:ms AND task_date<=:me AND task_id<>0 AND mark_type LIKE '%CHECKOUT%' GROUP BY user_id) ds ON ds.uid=du.id" +

            " LEFT JOIN (SELECT user_id uid, SUM(GREATEST(TIME_TO_SEC(check_out_time)-TIME_TO_SEC(check_in_time),0)) work_sec FROM auth.location_tracking" +

            "   WHERE task_date>=:ms AND task_date<=:me AND task_id=0 AND check_out_time IS NOT NULL AND check_out_time<>'00:00:00' AND check_in_time IS NOT NULL AND check_in_time<>'00:00:00' GROUP BY user_id) wk ON wk.uid=du.id" +

            " LEFT JOIN (SELECT auth_id uid, COUNT(*) leads FROM `user`.lead WHERE created_timestamp>=:ms AND created_timestamp<=CONCAT(:me,' 23:59:59') GROUP BY auth_id) ld ON ld.uid=au.id" +

            // active (punched-in) days — same rule as the KPI 'journeys' count.

            " LEFT JOIN (SELECT user_id uid, COUNT(DISTINCT task_date) days FROM auth.location_tracking" +

            "   WHERE task_date>=:ms AND task_date<=:me AND (mark_type='PUNCHIN' OR (task_id=0 AND check_in_time IS NOT NULL AND check_in_time<>'00:00:00')) GROUP BY user_id) ad ON ad.uid=du.id" +

            " LEFT JOIN (SELECT user_id uid, COUNT(*) lvis FROM auth.location_tracking" +

            "   WHERE task_date>=:ms AND task_date<=:me AND task_id<>0 AND task_type='lead' AND mark_type LIKE 'CHECKIN%' GROUP BY user_id) lv ON lv.uid=du.id" +

            " LEFT JOIN (SELECT user_id uid, COUNT(*) fvis FROM auth.location_tracking" +

            "   WHERE task_date>=:ms AND task_date<=:me AND task_id<>0 AND task_type='franchisee-visit' AND mark_type LIKE 'CHECKIN%' GROUP BY user_id) fv ON fv.uid=du.id" +

            " ORDER BY done DESC, planned DESC");

        q.setParameter("ms", ms).setParameter("me", me).setParameterList("auth", auth);

        // Geofence-offsite check-ins per user are computed in Java (not SQL): the

        // coords are stored as "lat,lng" strings, and the inline parsing/haversine

        // expression trips Hibernate's native-query parameter parser.

        Map<Integer, Integer> geoByUser = geoOffsiteByUser(s, ms, me, dtr);

        List<Map<String, Object>> list = new ArrayList<>();

        for (Object o : q.getResultList()) {

            Object[] r = (Object[]) o;

            long planned = asLong(r[3]), done = asLong(r[4]), donePlanned = asLong(r[9]);

            Integer duid = (r[8] == null) ? null : ((Number) r[8]).intValue();

            Map<String, Object> m = new LinkedHashMap<>();

            m.put("authUserId", asLong(r[0]));

            m.put("userId", duid == null ? 0 : duid);

            m.put("name", asStr(r[1]));

            m.put("level", r[2] == null ? "-" : asStr(r[2]));

            m.put("planned", planned);

            m.put("done", done);

            // Adherence = completed PLANNED visits ÷ planned visits (not all visits).

            m.put("adherencePct", planned == 0 ? 0 : Math.round(100.0 * donePlanned / planned));

            m.put("discussionMin", asLong(r[5]));

            m.put("workingHrs", round1(asDouble(r[6]) / 3600.0));

            m.put("leads", asLong(r[7]));

            // avg lead / franchisee visits per active (punched-in) day

            long actDays = asLong(r[10]);

            m.put("avgLeadVisitsPerDay", actDays == 0 ? 0 : round1((double) asLong(r[11]) / actDays));

            m.put("avgFranchiseeVisitsPerDay", actDays == 0 ? 0 : round1((double) asLong(r[12]) / actDays));

            m.put("geoFlags", duid == null ? 0 : geoByUser.getOrDefault(duid, 0));

            list.add(m);

        }

        return list;

    }

    // Per dtr-user count of check-ins recorded >50 m from the partner's saved

    // location. Pulls the raw "lat,lng" strings and does the haversine in Java.

    private Map<Integer, Integer> geoOffsiteByUser(Session s, String ms, String me, List<Integer> dtr) {

        NativeQuery<?> q = s.createNativeQuery(

            "SELECT user_id, checkin_lat_lng, visit_location FROM auth.location_tracking" +

            " WHERE task_date>=:ms AND task_date<=:me AND task_type='franchisee-visit' AND mark_type LIKE 'CHECKIN%'" +

            " AND checkin_lat_lng LIKE '%,%' AND visit_location LIKE '%,%' AND user_id IN (:dtr)");

        q.setParameter("ms", ms).setParameter("me", me).setParameterList("dtr", dtr);

        Map<Integer, Integer> out = new HashMap<>();

        for (Object o : q.getResultList()) {

            Object[] r = (Object[]) o;

            if (r[0] == null) continue;

            double[] cin = parseLatLng(asStr(r[1]));

            double[] vis = parseLatLng(asStr(r[2]));

            if (cin == null || vis == null) continue;

            if (haversineMeters(cin[0], cin[1], vis[0], vis[1]) > 50.0) {

                int uid = ((Number) r[0]).intValue();

                out.merge(uid, 1, Integer::sum);

            }

        }

        return out;

    }

    private static double[] parseLatLng(String s) {

        if (s == null || !s.contains(",")) return null;

        String[] parts = s.split(",");

        if (parts.length != 2) return null;

        try {

            double a = Double.parseDouble(parts[0].trim());

            double b = Double.parseDouble(parts[1].trim());

            if (a == 0 && b == 0) return null;

            return new double[]{a, b};

        } catch (NumberFormatException e) {

            return null;

        }

    }

    private static double haversineMeters(double lat1, double lng1, double lat2, double lng2) {

        double R = 6371000d;

        double dLat = Math.toRadians(lat2 - lat1);

        double dLng = Math.toRadians(lng2 - lng1);

        double a = Math.sin(dLat / 2) * Math.sin(dLat / 2)

                + Math.cos(Math.toRadians(lat1)) * Math.cos(Math.toRadians(lat2))

                * Math.sin(dLng / 2) * Math.sin(dLng / 2);

        return 2 * R * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));

    }

    // ---- Working-hour utilization ------------------------------------------

    private Map<String, Object> utilization(Session s, String ms, String me, List<Integer> dtr) {

        NativeQuery<?> q = s.createNativeQuery(

            "SELECT" +

            " (SELECT COALESCE(SUM(TIME_TO_SEC(time_spent)),0) FROM auth.location_tracking WHERE task_date>=:ms AND task_date<=:me AND task_id<>0 AND user_id IN (:dtr)) instore," +

            " (SELECT COALESCE(SUM(TIME_TO_SEC(transit_time)),0) FROM auth.location_tracking WHERE task_date>=:ms AND task_date<=:me AND task_id<>0 AND user_id IN (:dtr)) travel," +

            " (SELECT COALESCE(SUM(GREATEST(TIME_TO_SEC(check_out_time)-TIME_TO_SEC(check_in_time),0)),0) FROM auth.location_tracking WHERE task_date>=:ms AND task_date<=:me AND task_id=0 AND check_out_time IS NOT NULL AND check_out_time<>'00:00:00' AND check_in_time IS NOT NULL AND check_in_time<>'00:00:00' AND user_id IN (:dtr)) working");

        q.setParameter("ms", ms).setParameter("me", me).setParameterList("dtr", dtr);

        Object[] r = (Object[]) q.uniqueResult();

        double instore = asDouble(r[0]), travel = asDouble(r[1]), working = asDouble(r[2]);

        if (working < instore + travel) working = instore + travel; // guard: working must cover its parts

        double idle = Math.max(working - instore - travel, 0);

        Map<String, Object> m = new LinkedHashMap<>();

        m.put("inStoreHrs", round1(instore / 3600.0));

        m.put("travelHrs", round1(travel / 3600.0));

        m.put("idleHrs", round1(idle / 3600.0));

        m.put("workingHrs", round1(working / 3600.0));

        m.put("inStorePct", working == 0 ? 0 : (int) Math.round(100.0 * instore / working));

        m.put("travelPct", working == 0 ? 0 : (int) Math.round(100.0 * travel / working));

        m.put("idlePct", working == 0 ? 0 : (int) Math.round(100.0 * idle / working));

        return m;

    }

    // ---- Deferrals & SLA ----------------------------------------------------

    private Map<String, Object> deferral(Session s, String ms, String me, List<Integer> auth) {

        NativeQuery<?> q = s.createNativeQuery(

            "SELECT COUNT(*) total," +

            " SUM(status='RESCHEDULED') rescheduled, SUM(status='CANCELLED') cancelled," +

            " SUM(action_by IS NOT NULL) actioned," +

            " SUM(reason LIKE 'Beat missed%' OR reason LIKE 'Not marked%') system_gen," +

            " ROUND(AVG(CASE WHEN action_by IS NOT NULL THEN TIMESTAMPDIFF(HOUR, created_timestamp, updated_timestamp)/24.0 END),1) avg_days" +

            " FROM `user`.beat_deferred_visit WHERE deferred_date>=:ms AND deferred_date<=:me AND auth_user_id IN (:auth)");

        q.setParameter("ms", ms).setParameter("me", me).setParameterList("auth", auth);

        Object[] r = (Object[]) q.uniqueResult();

        long total = asLong(r[0]), system = asLong(r[4]);

        long human = total - system;

        Map<String, Object> m = new LinkedHashMap<>();

        m.put("total", total);

        m.put("rescheduled", asLong(r[1]));

        m.put("cancelled", asLong(r[2]));

        m.put("actioned", asLong(r[3]));

        m.put("systemGenerated", system);

        m.put("human", human);

        m.put("avgDaysToAction", asDouble(r[5]));

        m.put("systemPct", total == 0 ? 0 : Math.round(100.0 * system / total));

        m.put("humanPct", total == 0 ? 0 : Math.round(100.0 * human / total));

        return m;

    }

    // ---- Auto "missed" breakdown -------------------------------------------

    // Three distinct execution gaps behind the "Auto missed" card:

    //   unscheduled    — executives (sales positions) with no PJP at all in range

    //   unfilledAgenda — scheduled beat-days whose agenda was never filled

    //   missedPunchin  — scheduled beat-days the owner never punched in on

    private Map<String, Object> missedBreakdown(Session s, String ms, String me,

                                                List<Integer> auth, List<Map<String, Object>> coverage) {

        // unscheduled execs: total at each level minus those with a plan (reuse coverage)

        long unscheduled = 0;

        for (Map<String, Object> c : coverage) {

            unscheduled += Math.max(asLong(c.get("totalUsers")) - asLong(c.get("withPjp")), 0);

        }

        NativeQuery<?> ua = s.createNativeQuery(

            "SELECT COUNT(*) FROM `user`.beat_schedule sc" +

            " JOIN `user`.beat b ON b.id=sc.beat_id AND b.active=1 AND b.auth_user_id IN (:auth)" +

            " WHERE sc.start_date>=:ms AND sc.start_date<=:me AND sc.agenda_filled_timestamp IS NULL");

        ua.setParameter("ms", ms).setParameter("me", me).setParameterList("auth", auth);

        long unfilledAgenda = asLong(ua.uniqueResult());

        NativeQuery<?> mp = s.createNativeQuery(

            "SELECT COUNT(*) FROM `user`.beat_schedule sc" +

            " JOIN `user`.beat b ON b.id=sc.beat_id AND b.active=1 AND b.auth_user_id IN (:auth)" +

            " JOIN auth.auth_user au ON au.id=b.auth_user_id" +

            " JOIN dtr.users du ON du.email=au.email_id" +

            " WHERE sc.start_date>=:ms AND sc.start_date<=:me AND NOT EXISTS (" +

            "   SELECT 1 FROM auth.location_tracking lt WHERE lt.user_id=du.id AND lt.task_date=sc.start_date" +

            "     AND (lt.mark_type='PUNCHIN' OR (lt.task_id=0 AND lt.check_in_time IS NOT NULL AND lt.check_in_time<>'00:00:00')))");

        mp.setParameter("ms", ms).setParameter("me", me).setParameterList("auth", auth);

        long missedPunchin = asLong(mp.uniqueResult());

        Map<String, Object> m = new LinkedHashMap<>();

        m.put("unscheduled", unscheduled);

        m.put("unfilledAgenda", unfilledAgenda);

        m.put("missedPunchin", missedPunchin);

        m.put("total", unscheduled + unfilledAgenda + missedPunchin);

        return m;

    }

    // ---- Drill-down lists ---------------------------------------------------

    // Per-executive PJP coverage (with/without a plan in range) — powers the

    // PJP coverage KPI and the coverage-by-level bar drill-downs.

    private List<Map<String, Object>> coverageDetail(Session s, String ms, String me, List<Integer> auth) {

        NativeQuery<?> q = s.createNativeQuery(

            "SELECT au.id uid, TRIM(CONCAT(au.first_name,' ',COALESCE(au.last_name,''))) nm, p.lvl," +

            " MAX(CASE WHEN sc.id IS NOT NULL THEN 1 ELSE 0 END) has_plan" +

            " FROM (SELECT auth_user_id, MIN(escalation_type) lvl FROM cs.position WHERE category_id=4 AND auth_user_id IN (:auth) AND LOWER(escalation_type) NOT IN ('l4','l5','final') GROUP BY auth_user_id) p" +

            " JOIN auth.auth_user au ON au.id=p.auth_user_id" +

            " LEFT JOIN `user`.beat b ON b.auth_user_id=p.auth_user_id AND b.active=1" +

            " LEFT JOIN `user`.beat_schedule sc ON sc.beat_id=b.id AND sc.start_date>=:ms AND sc.start_date<=:me" +

            " GROUP BY au.id, nm, p.lvl ORDER BY p.lvl, nm");

        q.setParameter("ms", ms).setParameter("me", me).setParameterList("auth", auth);

        List<Map<String, Object>> list = new ArrayList<>();

        for (Object o : q.getResultList()) {

            Object[] r = (Object[]) o;

            Map<String, Object> m = new LinkedHashMap<>();

            m.put("authUserId", asLong(r[0]));

            m.put("name", asStr(r[1]));

            m.put("level", asStr(r[2]));

            m.put("hasPlan", asLong(r[3]) > 0);

            list.add(m);

        }

        return list;

    }

    // Every deferral in range (exec, partner, reason, date, status, system flag).

    private List<Map<String, Object>> deferralsList(Session s, String ms, String me, List<Integer> auth) {

        NativeQuery<?> q = s.createNativeQuery(

            "SELECT TRIM(CONCAT(au.first_name,' ',COALESCE(au.last_name,''))) nm, d.display_name, d.reason," +

            " d.deferred_date, d.status, d.task_type," +

            " (d.reason LIKE 'Beat missed%' OR d.reason LIKE 'Not marked%') sys" +

            " FROM `user`.beat_deferred_visit d JOIN auth.auth_user au ON au.id=d.auth_user_id" +

            " WHERE d.deferred_date>=:ms AND d.deferred_date<=:me AND d.auth_user_id IN (:auth)" +

            " ORDER BY d.deferred_date, nm");

        q.setParameter("ms", ms).setParameter("me", me).setParameterList("auth", auth);

        List<Map<String, Object>> list = new ArrayList<>();

        for (Object o : q.getResultList()) {

            Object[] r = (Object[]) o;

            Map<String, Object> m = new LinkedHashMap<>();

            m.put("exec", asStr(r[0]));

            m.put("partner", asStr(r[1]));

            m.put("reason", asStr(r[2]));

            m.put("date", asStr(r[3]));

            m.put("status", asStr(r[4]));

            m.put("taskType", asStr(r[5]));

            m.put("system", asLong(r[6]) > 0);

            list.add(m);

        }

        return list;

    }

    // Every lead created in range (exec, outlet, city, date, status).

    private List<Map<String, Object>> leadsList(Session s, String ms, String me, List<Integer> auth) {

        NativeQuery<?> q = s.createNativeQuery(

            "SELECT TRIM(CONCAT(au.first_name,' ',COALESCE(au.last_name,''))) nm," +

            " COALESCE(NULLIF(l.outlet_name,''), TRIM(CONCAT(COALESCE(l.first_name,''),' ',COALESCE(l.last_name,'')))) lead," +

            " l.city, DATE(l.created_timestamp) dt, l.status" +

            " FROM `user`.lead l JOIN auth.auth_user au ON au.id=l.auth_id" +

            " WHERE l.created_timestamp>=:ms AND l.created_timestamp<=CONCAT(:me,' 23:59:59') AND l.auth_id IN (:auth)" +

            " ORDER BY dt, nm");

        q.setParameter("ms", ms).setParameter("me", me).setParameterList("auth", auth);

        List<Map<String, Object>> list = new ArrayList<>();

        for (Object o : q.getResultList()) {

            Object[] r = (Object[]) o;

            Map<String, Object> m = new LinkedHashMap<>();

            m.put("exec", asStr(r[0]));

            m.put("lead", asStr(r[1]));

            m.put("city", asStr(r[2]));

            m.put("date", asStr(r[3]));

            m.put("status", asStr(r[4]));

            list.add(m);

        }

        return list;

    }

    // ---- Travel & route quality --------------------------------------------

    private Map<String, Object> travel(Session s, String ms, String me, List<Integer> auth, List<Integer> dtr) {

        Map<String, Object> m = new LinkedHashMap<>();

        String legFrom =

            " FROM `user`.beat_route a" +

            " JOIN `user`.beat bt ON bt.id=a.beat_id AND bt.auth_user_id IN (:auth)" +

            " JOIN `user`.beat_route b ON b.beat_id=a.beat_id AND b.day_number=a.day_number AND b.sequence_order=a.sequence_order+1 AND b.active=1" +

            " JOIN (SELECT id, CAST(latitude AS DECIMAL(10,7)) lat, CAST(longitude AS DECIMAL(10,7)) lng FROM fofo.fofo_store WHERE latitude REGEXP '^[0-9.]+$') al ON al.id=a.fofo_id" +

            " JOIN (SELECT id, CAST(latitude AS DECIMAL(10,7)) lat, CAST(longitude AS DECIMAL(10,7)) lng FROM fofo.fofo_store WHERE latitude REGEXP '^[0-9.]+$') bl ON bl.id=b.fofo_id" +

            " WHERE a.active=1";

        String legKm =

            "6371*2*ASIN(SQRT(POWER(SIN(RADIANS(bl.lat-al.lat)/2),2)+COS(RADIANS(al.lat))*COS(RADIANS(bl.lat))*POWER(SIN(RADIANS(bl.lng-al.lng)/2),2)))";

        NativeQuery<?> bq = s.createNativeQuery(

            "SELECT bucket, COUNT(*) n FROM (" +

            "  SELECT CASE WHEN km<2 THEN '0-2 km' WHEN km<5 THEN '2-5 km' WHEN km<15 THEN '5-15 km'" +

            "    WHEN km<50 THEN '15-50 km' ELSE '50 km+' END bucket," +

            "  CASE WHEN km<2 THEN 1 WHEN km<5 THEN 2 WHEN km<15 THEN 3 WHEN km<50 THEN 4 ELSE 5 END ord" +

            "  FROM (SELECT " + legKm + " km" + legFrom + ") l" +

            " ) z GROUP BY bucket, ord ORDER BY ord");

        bq.setParameterList("auth", auth);

        List<Map<String, Object>> buckets = new ArrayList<>();

        for (Object o : bq.getResultList()) {

            Object[] r = (Object[]) o;

            Map<String, Object> b = new LinkedHashMap<>();

            b.put("bucket", asStr(r[0]));

            b.put("count", asLong(r[1]));

            buckets.add(b);

        }

        m.put("legBuckets", buckets);

        NativeQuery<?> sq = s.createNativeQuery(

            "SELECT ROUND(AVG(km),1) avg_leg, ROUND(MAX(km),0) max_leg, SUM(km>15) over15, COUNT(*) total" +

            " FROM (SELECT " + legKm + " km" + legFrom + ") l");

        sq.setParameterList("auth", auth);

        Object[] sr = (Object[]) sq.uniqueResult();

        long totalLegs = asLong(sr[3]), over15 = asLong(sr[2]);

        m.put("avgLegKm", asDouble(sr[0]));

        m.put("maxLegKm", asDouble(sr[1]));

        m.put("pctOver15", totalLegs == 0 ? 0 : Math.round(100.0 * over15 / totalLegs));

        NativeQuery<?> tq = s.createNativeQuery(

            "SELECT ROUND(SUM(TIME_TO_SEC(transit_time))/3600,1) transit_hrs, ROUND(SUM(TIME_TO_SEC(estimated_time))/3600,1) est_hrs" +

            " FROM auth.location_tracking WHERE task_date>=:ms AND task_date<=:me AND task_type='franchisee-visit' AND user_id IN (:dtr)");

        tq.setParameter("ms", ms).setParameter("me", me).setParameterList("dtr", dtr);

        Object[] tr = (Object[]) tq.uniqueResult();

        double transit = asDouble(tr[0]), est = asDouble(tr[1]);

        m.put("actualVsEstimateRatio", est == 0 ? 0 : round1(transit / est));

        return m;

    }

    // ---- Outcomes & visit quality ------------------------------------------

    private Map<String, Object> outcomes(Session s, String ms, String me, List<Integer> auth) {

        NativeQuery<?> q = s.createNativeQuery(

            "SELECT COUNT(*) total," +

            " SUM(partner_remark IS NOT NULL AND TRIM(partner_remark)<>'') remark," +

            " ROUND(AVG(NULLIF(rbm_rating,0)),1) avg_rating," +

            " SUM(instore_visibility IS NOT NULL AND TRIM(instore_visibility)<>'') audit," +

            " SUM(franchise_activity_id>0) nextv" +

            " FROM `user`.my_franchisee_visit" +

            " WHERE auth_id IN (:auth) AND COALESCE(visit_timestamp, created_timestamp)>=:ms" +

            " AND COALESCE(visit_timestamp, created_timestamp)<=CONCAT(:me,' 23:59:59')");

        q.setParameter("ms", ms).setParameter("me", me).setParameterList("auth", auth);

        Object[] r = (Object[]) q.uniqueResult();

        long total = asLong(r[0]);

        Map<String, Object> m = new LinkedHashMap<>();

        m.put("completedVisits", total);

        m.put("remarkFilledPct", total == 0 ? 0 : Math.round(100.0 * asLong(r[1]) / total));

        m.put("avgRating", asDouble(r[2]));

        m.put("auditDonePct", total == 0 ? 0 : Math.round(100.0 * asLong(r[3]) / total));

        m.put("nextVisitPct", total == 0 ? 0 : Math.round(100.0 * asLong(r[4]) / total));

        return m;

    }

    // ---- "What to fix" findings (computed in Java) --------------------------

    private List<Map<String, Object>> findings(Map<String, Object> kpis, Map<String, Object> funnel,

                                               Map<String, Object> deferral, Map<String, Object> util,

                                               Map<String, Object> travel, Map<String, Object> outcomes,

                                               List<Map<String, Object>> coverage, List<Map<String, Object>> scorecard) {

        List<Map<String, Object>> f = new ArrayList<>();

        long avgDisc = asLong(kpis.get("avgDiscussionMin"));

        long rushed = scorecard.stream().filter(r -> asLong(r.get("discussionMin")) > 0 && asLong(r.get("discussionMin")) < 10).count();

        if (avgDisc > 0 && (avgDisc < 30 || rushed > 0)) {

            f.add(finding("high", "Rushed partner visits",

                "Avg discussion is " + avgDisc + " min vs a 30–45 min target" + (rushed > 0 ? ", and " + rushed + " executive(s) average under 10 min" : "") + " — too short for a real outlet conversation.",

                "Set a minimum on-store time and review visit quality."));

        }

        long geo = scorecard.stream().mapToLong(r -> asLong(r.get("geoFlags"))).sum();

        if (geo > 0) {

            f.add(finding("high", "Fake-visit risk",

                geo + " check-in(s) were >50 m from the store (check-in GPS vs the partner's saved location).",

                "Enforce geofenced check-in and flag these journeys for audit."));

        }

        for (Map<String, Object> c : coverage) {

            if ("L1".equalsIgnoreCase(asStr(c.get("level")))) {

                long total = asLong(c.get("totalUsers")), with = asLong(c.get("withPjp"));

                if (total - with > 0) {

                    f.add(finding("med", "Coverage gap",

                        (total - with) + " of " + total + " L1 executives have no monthly PJP — they run no planned beat this period.",

                        "Make a monthly PJP mandatory and approved before month start."));

                }

            }

        }

        long sysPct = asLong(deferral.get("systemPct"));

        double sla = asDouble(deferral.get("avgDaysToAction"));

        if (asLong(deferral.get("total")) > 0 && (sysPct >= 50 || sla >= 2)) {

            f.add(finding("med", "Deferral leakage",

                sysPct + "% of deferrals are system auto-flags" + (sla > 0 ? ", and genuine deferrals sit " + sla + " days before a head acts" : "") + ".",

                "Require a reason on real deferrals and add a manager-action SLA."));

        }

        long idlePct = asLong(util.get("idlePct"));

        if (idlePct >= 20) {

            f.add(finding("med", "A large part of the day is idle",

                idlePct + "% of the working day (" + util.get("idleHrs") + " h) is neither travel nor in-store.",

                "Investigate idle windows; tighten beat sequencing to cut dead time."));

        }

        long over15 = asLong(travel.get("pctOver15"));

        if (over15 >= 15) {

            f.add(finding("med", "Route inefficiency",

                over15 + "% of legs exceed 15 km — consecutive stops aren't geographically clustered.",

                "Re-sequence beats by proximity and cap daily travel."));

        }

        long journeys = asLong(kpis.get("journeys")), leads = asLong(kpis.get("leadsCreated"));

        if (journeys > 0 && leads < journeys * 0.25) {

            f.add(finding("low", "Lead capture is low",

                "Only " + leads + " leads across " + journeys + " journeys — executives aren't logging the new shops they pass.",

                "Add a per-beat lead nudge; recognise top loggers."));

        }

        return f;

    }

    private static Map<String, Object> finding(String sev, String title, String detail, String action) {

        Map<String, Object> m = new LinkedHashMap<>();

        m.put("severity", sev);

        m.put("title", title);

        m.put("detail", detail);

        m.put("action", action);

        return m;

    }

    // ---- helpers ------------------------------------------------------------

    private static List<Integer> safeIds(List<Integer> ids) {

        if (ids == null || ids.isEmpty()) return Collections.singletonList(-1);

        return ids;

    }

    private static long asLong(Object o) {

        return o == null ? 0L : ((Number) o).longValue();

    }

    private static double asDouble(Object o) {

        return o == null ? 0.0 : ((Number) o).doubleValue();

    }

    private static String asStr(Object o) {

        return o == null ? "" : o.toString();

    }

    private static double round1(double v) {

        return Math.round(v * 10.0) / 10.0;

    }

}