package cn.qinys.platform.mobile.service;

import cn.qinys.platform.mobile.req.TreeAddressReq;
import cn.qinys.platform.mobile.req.TreeCreateReq;
import cn.qinys.platform.mobile.req.TreeDetailReq;
import cn.qinys.platform.mobile.req.WishingTreeListReq;
import cn.qinys.platform.mobile.resp.TreeAddressResp;
import cn.qinys.platform.mobile.resp.TreeDetailResp;
import cn.qinys.platform.mobile.resp.TreeListResp;

import java.util.List;

/**
 * @author lie tan
 * @description 许愿树服务
 * @date 2026-05-24 21:33
 **/
public interface TreeService {

    /**
     * 查询附近许愿树列表
     *
     * @return 许愿树列表（含距离、是否在范围内）
     */
    List<TreeListResp> listNearbyTrees(WishingTreeListReq req);

    /**
     * 查询许愿树详情
     */
    TreeDetailResp getTreeDetail(TreeDetailReq req);

    /**
     * 创建许愿树（管理员功能）
     */
    void create(TreeCreateReq req);

    TreeAddressResp getAddress(TreeAddressReq req);
}
