package com.yunhai.acaclassroom.service;

import com.yunhai.acaclassroom.model.ClassroomBatchAddRequest;
import com.yunhai.acaclassroom.model.ClassroomBatchEditRequest;
import com.yunhai.acaclassroom.model.ClassroomEditRequest;

import java.util.List;
import java.util.Map;

/**
 * 教室管理服务。
 */
public interface IClassroomService {

    /**
     * 教室列表（空间作用域：按楼栋或按校区，可按楼层/类型/状态/关键字过滤，内存分页）。
     *
     * @param buildingId 楼栋 id（与 campusId 至少传其一，楼栋优先）
     * @param campusId   校区 id（buildingId 为空时按校区查全部楼栋的教室）
     * @param floor      楼层（可空）
     * @param typeId     教室类型（可空）
     * @param status     open/closed（可空）
     * @param keyword    教室名称/编号模糊（可空）
     * @param grade      年级过滤（绑定班级页 Tab：1=高一 2=高二 3=高三；可空不过滤。
     *                   过滤口径=未绑定教室 + 绑定班级为该年级的教室）
     * @param bindStatus 绑定状态过滤 bound/unbound（可空）
     * @param page       页码（1 起）
     * @param count      每页条数
     * @param sortField  排序字段 floor/roomCode/roomName/status/seatCount（可空=默认序：楼层升序+编号升序）
     * @param order      asc/desc（可空=asc）
     */
    Map<String, Object> list(Integer buildingId, Integer campusId, Integer floor, Integer typeId, String status,
                             String keyword, Integer grade, String bindStatus, Integer page, Integer count,
                             String sortField, String order);

    /** 楼栋下已有教室的楼层列表（升序，筛选项用）。 */
    List<Integer> floors(Integer buildingId);

    /** 全校教室扁平列表（空间筛选树数据源，仅轻量字段）。 */
    List<Map<String, Object>> tree();

    /** 批量添加教室，返回 {created, skipped, total}。 */
    Map<String, Object> batchAdd(ClassroomBatchAddRequest req);

    /** 编辑教室（类型/名称/编号/状态/座位数）。 */
    void edit(ClassroomEditRequest req);

    /** 批量编辑教室（仅状态 / 教室类型，可只改其一），返回 {updated, skipped, total}。 */
    Map<String, Object> batchEdit(ClassroomBatchEditRequest req);

    /** 批量删除教室。 */
    void delete(List<Integer> ids);

    /** 教室绑定班级（班级同校且未被其他教室占用），返回 {classId, className}。 */
    Map<String, Object> bindClass(Integer serID, Integer classId);

    /** 教室解绑班级（未绑定时静默成功）。 */
    void unbindClass(Integer serID);

    /** 批量解绑（未绑定/不存在的教室计入 skipped），返回 {updated, skipped, total}。 */
    Map<String, Object> batchUnbind(List<Integer> serIDs);
}