// Licensed to the Apache Software Foundation (ASF) under one

// or more contributor license agreements.  See the NOTICE file

// distributed with this work for additional information

// regarding copyright ownership.  The ASF licenses this file

// to you under the Apache License, Version 2.0 (the

// "License"); you may not use this file except in compliance

// with the License.  You may obtain a copy of the License at

//

//   http://www.apache.org/licenses/LICENSE-2.0

//

// Unless required by applicable law or agreed to in writing,

// software distributed under the License is distributed on an

// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY

// KIND, either express or implied.  See the License for the

// specific language governing permissions and limitations

// under the License.

#pragma once

#include <gen_cpp/Data_types.h>

#include <gen_cpp/RuntimeProfile_types.h>

#include <gen_cpp/Types_types.h>

#include <atomic>

#include <cstdint>

#include <memory>

#include <mutex>

#include <shared_mutex>

#include <string>

#include <unordered_map>

#include "runtime/workload_management/resource_context.h"

#include "util/threadpool.h"

namespace doris {

class Block;

class TQueryStatisticsResult;

class TReportExecStatusParams;

class RuntimeQueryStatisticsMgrTestPeer;

class RuntimeQueryStatisticsMgr {

public:

    RuntimeQueryStatisticsMgr();

    ~RuntimeQueryStatisticsMgr() = default;

    static TReportExecStatusParams create_report_exec_status_params(

            const TUniqueId& q_id,

            std::unordered_map<int32_t, std::vector<std::shared_ptr<TRuntimeProfileTree>>>

                    fragment_id_to_profile,

            std::vector<std::shared_ptr<TRuntimeProfileTree>> load_channel_profile, bool is_done);

    void register_resource_context(std::string query_id,

                                   std::shared_ptr<ResourceContext> resource_ctx);

    void report_runtime_query_statistics();

    static TQueryStatisticsResult create_query_statistics_result(

            const std::shared_ptr<ResourceContext>& resource_ctx);

    // used for backend_active_tasks

    void get_active_be_tasks_block(Block* block);

    Status get_query_statistics(const std::string& query_id, TQueryStatistics* query_stats);

    // used for MemoryReclamation

    void get_tasks_resource_context(std::vector<std::shared_ptr<ResourceContext>>& resource_ctxs);

    // Called by main threads when backend starts.

    Status start_report_thread();

    // Called by main threads when backend stops.

    void stop_report_thread();

    void register_fragment_profile(const TUniqueId& query_id, const TNetworkAddress& const_addr,

                                   int32_t fragment_id,

                                   std::vector<std::shared_ptr<TRuntimeProfileTree>> p_profiles,

                                   std::shared_ptr<TRuntimeProfileTree> load_channel_profile_x);

    // When query is finished, try to report query profiles to FE.

    // ATTN: Profile is reported to fe fragment by fragment.

    void trigger_profile_reporting();

private:

    friend class RuntimeQueryStatisticsMgrTestPeer;

    enum class FinalStatisticsAction { KEEP_RESOURCE_CONTEXT, COMPACT_RESOURCE_CONTEXT, REMOVE };

    static bool should_remove_finished_query(bool response_received, bool accepted,

                                             int64_t elapsed_after_finish_ms,

                                             int64_t local_retention_ms, int64_t fe_retention_ms,

                                             int64_t no_response_retention_ms);

    static FinalStatisticsAction final_statistics_action(bool response_received, bool accepted,

                                                         int64_t elapsed_after_finish_ms,

                                                         int64_t local_retention_ms,

                                                         int64_t fe_retention_ms,

                                                         int64_t no_response_retention_ms);

    struct PendingFinalStatistics {

        TNetworkAddress fe_addr;

        std::shared_ptr<TQueryStatisticsResult> statistics;

        int64_t finish_time_ms;

    };

    std::shared_mutex _resource_contexts_map_lock;

    // Query execution may end before its final statistics lifecycle, so the live registry owns

    // the ResourceContext until acceptance or conversion to a compact retry snapshot.

    std::map<std::string, std::shared_ptr<ResourceContext>> _resource_contexts_map;

    // Finished queries shed their ResourceContext after the local timeout, but this compact final

    // snapshot remains retryable until FE acceptance or the FE-provided audit window expires.

    std::map<std::string, PendingFinalStatistics> _pending_final_statistics;

    std::atomic<int64_t> _next_query_statistics_generation;

    std::atomic_bool started = false;

    std::mutex _profile_map_lock;

    // query_id -> {coordinator_addr, {fragment_id -> std::vector<pipeline_profile>}}

    std::unordered_map<

            TUniqueId,

            std::tuple<TNetworkAddress,

                       std::unordered_map<int, std::vector<std::shared_ptr<TRuntimeProfileTree>>>>>

            _profile_map;

    std::unordered_map<std::pair<TUniqueId, int32_t>, std::shared_ptr<TRuntimeProfileTree>>

            _load_channel_profile_map;

    std::unique_ptr<ThreadPool> _thread_pool;

};

} // namespace doris