/**
 * Copyright 2018 人人开源 https://www.renren.io
 * <p>
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 * <p>
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * <p>
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

package com.epmet.service;

import com.epmet.commons.mybatis.service.BaseService;
import com.epmet.commons.tools.page.PageData;
import com.epmet.dto.UserAdviceDTO;
import com.epmet.dto.form.AdviceListFormDTO;
import com.epmet.dto.form.ReplyAdviceFormDTO;
import com.epmet.dto.result.AdviceDetailResultDTO;
import com.epmet.dto.result.AdviceListResultDTO;
import com.epmet.dto.result.MyAdviceListResultDTO;
import com.epmet.entity.UserAdviceEntity;

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

/**
 * user_advice
 *
 * @author qu qu@elink-cn.com
 * @since v1.0.0 2020-11-06
 */
public interface UserAdviceService extends BaseService<UserAdviceEntity> {

    /**
     * 默认分页
     *
     * @param params
     * @return PageData<UserAdviceDTO>
     * @author generator
     * @date 2020-11-06
     */
    PageData<UserAdviceDTO> page(Map<String, Object> params);

    /**
     * 默认查询
     *
     * @param params
     * @return java.util.List<UserAdviceDTO>
     * @author generator
     * @date 2020-11-06
     */
    List<UserAdviceDTO> list(Map<String, Object> params);

    /**
     * 单条查询
     *
     * @param id
     * @return UserAdviceDTO
     * @author generator
     * @date 2020-11-06
     */
    UserAdviceDTO get(String id);

    /**
     * 默认保存
     *
     * @param dto
     * @return void
     * @author generator
     * @date 2020-11-06
     */
    void save(UserAdviceDTO dto);

    /**
     * 默认更新
     *
     * @param dto
     * @return void
     * @author generator
     * @date 2020-11-06
     */
    void update(UserAdviceDTO dto);

    /**
     * 批量删除
     *
     * @param ids
     * @return void
     * @author generator
     * @date 2020-11-06
     */
    void delete(String[] ids);

    /**
     * @Description 回复建议
     * @param dto
     * @param loginUserId
     * @return void
     * @Author liushaowen
     * @Date 2020/11/6 16:44
     */
    void replyAdvice(ReplyAdviceFormDTO dto, String loginUserId);

    /**
     * @Description 建议详情
     * @param adviceId
     * @return com.epmet.dto.result.AdviceDetailResultDTO
     * @Author liushaowen
     * @Date 2020/11/6 17:19
     */
    AdviceDetailResultDTO adviceDetail(String adviceId);

    /**
     * @Description 查询建议列表
     * @param dto
     * @return com.epmet.commons.tools.page.PageData<com.epmet.dto.UserAdviceDTO>
     * @Author liushaowen
     * @Date 2020/11/9 10:41
     */
    PageData<AdviceListResultDTO> adviceList(AdviceListFormDTO dto);

    /**
     * @Description 居民端-我的建议列表
     * @param pageSize
     * @param pageNo
     * @param loginUserId
     * @return java.util.List<com.epmet.dto.result.MyAdviceListResultDTO>
     * @Author liushaowen
     * @Date 2020/11/9 17:39
     */
    List<MyAdviceListResultDTO> myAdviceList(int pageSize, int pageNo, String loginUserId);
}