Subversion Repositories SmartDukaan

package com.spice.profitmandi.service;

import com.spice.profitmandi.common.exception.ProfitMandiBusinessException;
import com.spice.profitmandi.dao.entity.user.AgendaInstance;
import com.spice.profitmandi.dao.enumuration.dtr.AgendaSource;

import java.time.LocalDate;

public interface AgendaInstanceService {

    /**
     * Open an instance; no-op returning the existing one if already OPEN for
     * (fofoId, agendaType). Race-safe via the uq_one_open DB key.
     */
    AgendaInstance open(int fofoId, String agendaType, AgendaSource source, Integer openedBy,
                        String openMetricJson) throws ProfitMandiBusinessException;

    /** Cron-only close path: metric normalized. closed_by stays NULL. */
    void closeByMetric(AgendaInstance instance, String closeMetricJson);

    /** Team close path. Rejects AUTO instances — those close only by metric. */
    void closeManual(AgendaInstance instance, int closedBy, String remark)
            throws ProfitMandiBusinessException;

    /** Log one visit discussion against an OPEN instance. */
    void logVisit(int instanceId, Integer locationTrackingId, int visitorUserId,
                  LocalDate visitDate, String discussion) throws ProfitMandiBusinessException;

    /**
     * Display-layer filter for visit surfaces (day-view agenda + checkout
     * remarks): when a REVIVAL instance is open, AUTO data-driven agendas other
     * than CREDIT_DUES stay hidden — the instances keep their own lifecycle,
     * they just aren't populated during the visit. MANUAL instances always show.
     */
    java.util.List<com.spice.profitmandi.dao.entity.user.AgendaInstance> filterVisibleForVisit(
            java.util.List<com.spice.profitmandi.dao.entity.user.AgendaInstance> openInstances);
}