Primeira onda do roadmap de indicadores executivos do Grupo Nova. Mede ADOÇÃO DO CANAL DIGITAL, não a operação total — banner explícito alerta que reservas fechadas manualmente na recepção ainda não estão capturadas (Onda 1B vai adicionar marcação manual via botão na conversa). Backend: - V2::Reports::ConversionFunnelBuilder — leads (novo/retorno/total), reservas (criadas != draft, pagas in active/completed/confirmed), taxas de conversão. Filtro opcional por inbox. - V2::Reports::InboxBenchmarkingBuilder — uma linha por inbox com brand_name (via Captain::UnitInbox -> Unit -> Brand) - Endpoints GET /reports/conversion_funnel e /reports/inbox_benchmarking - RSpec do ConversionFunnelBuilder Frontend: - Rota top-level Reports → Painel Diretoria - DirectoryDashboard.vue: banner de adoção + filtros + cards + funil + tabela benchmarking agrupada por marca com variação vs média - API client getConversionFunnel + getInboxBenchmarking - i18n EN + PT Memórias suporte: feedback_metricas_adocao_canal.md + project_painel_diretoria_roadmap.md Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
243 lines
6.3 KiB
Ruby
243 lines
6.3 KiB
Ruby
# rubocop:disable Metrics/ClassLength
|
|
class Api::V2::Accounts::ReportsController < Api::V1::Accounts::BaseController
|
|
include Api::V2::Accounts::ReportsHelper
|
|
include Api::V2::Accounts::HeatmapHelper
|
|
|
|
before_action :check_authorization
|
|
|
|
def index
|
|
builder = V2::Reports::Conversations::ReportBuilder.new(Current.account, report_params)
|
|
data = builder.timeseries
|
|
render json: data
|
|
end
|
|
|
|
def summary
|
|
render json: build_summary(:summary)
|
|
end
|
|
|
|
def bot_summary
|
|
render json: build_summary(:bot_summary)
|
|
end
|
|
|
|
def agents
|
|
@report_data = generate_agents_report
|
|
generate_csv('agents_report', 'api/v2/accounts/reports/agents')
|
|
end
|
|
|
|
def inboxes
|
|
@report_data = generate_inboxes_report
|
|
generate_csv('inboxes_report', 'api/v2/accounts/reports/inboxes')
|
|
end
|
|
|
|
def labels
|
|
@report_data = generate_labels_report
|
|
generate_csv('labels_report', 'api/v2/accounts/reports/labels')
|
|
end
|
|
|
|
def teams
|
|
@report_data = generate_teams_report
|
|
generate_csv('teams_report', 'api/v2/accounts/reports/teams')
|
|
end
|
|
|
|
def conversations_summary
|
|
@report_data = generate_conversations_report
|
|
generate_csv('conversations_summary_report', 'api/v2/accounts/reports/conversations_summary')
|
|
end
|
|
|
|
def conversation_traffic
|
|
@report_data = generate_conversations_heatmap_report
|
|
timezone_offset = (params[:timezone_offset] || 0).to_f
|
|
@timezone = ActiveSupport::TimeZone[timezone_offset]
|
|
|
|
generate_csv('conversation_traffic_reports', 'api/v2/accounts/reports/conversation_traffic')
|
|
end
|
|
|
|
def conversations
|
|
return head :unprocessable_entity if params[:type].blank?
|
|
|
|
render json: conversation_metrics
|
|
end
|
|
|
|
def bot_metrics
|
|
bot_metrics = V2::Reports::BotMetricsBuilder.new(Current.account, bot_metrics_params).metrics
|
|
render json: bot_metrics
|
|
end
|
|
|
|
def inbox_label_matrix
|
|
builder = V2::Reports::InboxLabelMatrixBuilder.new(
|
|
account: Current.account,
|
|
params: inbox_label_matrix_params
|
|
)
|
|
render json: builder.build
|
|
end
|
|
|
|
def first_response_time_distribution
|
|
builder = V2::Reports::FirstResponseTimeDistributionBuilder.new(
|
|
account: Current.account,
|
|
params: first_response_time_distribution_params
|
|
)
|
|
render json: builder.build
|
|
end
|
|
|
|
OUTGOING_MESSAGES_ALLOWED_GROUP_BY = %w[agent team inbox label].freeze
|
|
|
|
def outgoing_messages_count
|
|
return head :unprocessable_entity unless OUTGOING_MESSAGES_ALLOWED_GROUP_BY.include?(params[:group_by])
|
|
|
|
builder = V2::Reports::OutgoingMessagesCountBuilder.new(Current.account, outgoing_messages_count_params)
|
|
render json: builder.build
|
|
end
|
|
|
|
def inbox_leads_summary
|
|
return head :unprocessable_entity if params[:inbox_id].blank?
|
|
|
|
builder = V2::Reports::InboxLeadsSummaryBuilder.new(Current.account, inbox_leads_summary_params)
|
|
render json: builder.build
|
|
end
|
|
|
|
def conversion_funnel
|
|
builder = V2::Reports::ConversionFunnelBuilder.new(Current.account, conversion_funnel_params)
|
|
render json: builder.metrics
|
|
end
|
|
|
|
def inbox_benchmarking
|
|
builder = V2::Reports::InboxBenchmarkingBuilder.new(Current.account, inbox_benchmarking_params)
|
|
render json: builder.build
|
|
end
|
|
|
|
private
|
|
|
|
def generate_csv(filename, template)
|
|
response.headers['Content-Type'] = 'text/csv'
|
|
response.headers['Content-Disposition'] = "attachment; filename=#{filename}.csv"
|
|
render layout: false, template: template, formats: [:csv]
|
|
end
|
|
|
|
def check_authorization
|
|
authorize :report, :view?
|
|
end
|
|
|
|
def common_params
|
|
{
|
|
type: params[:type].to_sym,
|
|
id: params[:id],
|
|
group_by: params[:group_by],
|
|
business_hours: ActiveModel::Type::Boolean.new.cast(params[:business_hours])
|
|
}
|
|
end
|
|
|
|
def current_summary_params
|
|
common_params.merge({
|
|
since: range[:current][:since],
|
|
until: range[:current][:until],
|
|
timezone_offset: params[:timezone_offset]
|
|
})
|
|
end
|
|
|
|
def previous_summary_params
|
|
common_params.merge({
|
|
since: range[:previous][:since],
|
|
until: range[:previous][:until],
|
|
timezone_offset: params[:timezone_offset]
|
|
})
|
|
end
|
|
|
|
def report_params
|
|
common_params.merge({
|
|
metric: params[:metric],
|
|
since: params[:since],
|
|
until: params[:until],
|
|
timezone_offset: params[:timezone_offset]
|
|
})
|
|
end
|
|
|
|
def conversation_params
|
|
{
|
|
type: params[:type].to_sym,
|
|
user_id: params[:user_id],
|
|
page: params[:page].presence || 1
|
|
}
|
|
end
|
|
|
|
def range
|
|
{
|
|
current: {
|
|
since: params[:since],
|
|
until: params[:until]
|
|
},
|
|
previous: {
|
|
since: (params[:since].to_i - (params[:until].to_i - params[:since].to_i)).to_s,
|
|
until: params[:since]
|
|
}
|
|
}
|
|
end
|
|
|
|
def build_summary(method)
|
|
builder = V2::Reports::Conversations::MetricBuilder
|
|
current_summary = builder.new(Current.account, current_summary_params).send(method)
|
|
previous_summary = builder.new(Current.account, previous_summary_params).send(method)
|
|
current_summary.merge(previous: previous_summary)
|
|
end
|
|
|
|
def conversation_metrics
|
|
V2::ReportBuilder.new(Current.account, conversation_params).conversation_metrics
|
|
end
|
|
|
|
def inbox_label_matrix_params
|
|
{
|
|
since: params[:since],
|
|
until: params[:until],
|
|
inbox_ids: params[:inbox_ids],
|
|
label_ids: params[:label_ids]
|
|
}
|
|
end
|
|
|
|
def first_response_time_distribution_params
|
|
{
|
|
since: params[:since],
|
|
until: params[:until]
|
|
}
|
|
end
|
|
|
|
def outgoing_messages_count_params
|
|
{
|
|
group_by: params[:group_by],
|
|
since: params[:since],
|
|
until: params[:until]
|
|
}
|
|
end
|
|
|
|
def bot_metrics_params
|
|
{
|
|
inbox_id: params[:inbox_id],
|
|
since: params[:since],
|
|
until: params[:until]
|
|
}
|
|
end
|
|
|
|
def inbox_leads_summary_params
|
|
{
|
|
inbox_id: params[:inbox_id],
|
|
group_by: params[:group_by],
|
|
since: params[:since],
|
|
until: params[:until]
|
|
}
|
|
end
|
|
|
|
def conversion_funnel_params
|
|
{
|
|
inbox_id: params[:inbox_id],
|
|
since: params[:since],
|
|
until: params[:until]
|
|
}
|
|
end
|
|
|
|
def inbox_benchmarking_params
|
|
{
|
|
since: params[:since],
|
|
until: params[:until]
|
|
}
|
|
end
|
|
end
|
|
# rubocop:enable Metrics/ClassLength
|