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);

}