@careonbrasil/dashboard 14.0.0

package/lib/models/dashboard.models.d.ts

@@ -0,0 +1,200 @@
+import { TimelinePoint, ComparisonItem, DonutChartItem, StackedBarItem, FunnelBarItem } from '@careonbrasil/ng-charts';
+/**
+ * Periodo de agregacao temporal para consulta e exibicao das metricas do dashboard.
+ */
+export declare enum DashboardPeriod {
+    /** Visualizacao agregada das metricas do dia atual. */
+    Today = "Today",
+    /** Visualizacao agregada dos ultimos 7 dias. */
+    Week = "Week",
+    /** Visualizacao agregada do mes corrente (ultimos 30 dias). */
+    Month = "Month"
+}
+/**
+ * Resumo consolidado dos indicadores-chave de performance (KPIs) exibidos nos cards superiores.
+ * Inclui os totais do periodo corrente, do periodo imediatamente anterior e a variacao correspondente.
+ */
+export interface DashboardKpiSummary {
+    /** Quantidade total de vagas publicadas no periodo atual. */
+    registeredVacancies?: number;
+    /** Quantidade total de vagas publicadas no periodo anterior equivalente. */
+    registeredVacanciesPrevious?: number;
+    /** Diferenca absoluta de vagas publicadas entre o periodo atual e o anterior. */
+    registeredVacanciesDifference?: number;
+    /** Total de candidaturas recebidas nas vagas da instituicao no periodo atual. */
+    candidateApplications?: number;
+    /** Total de candidaturas recebidas no periodo anterior equivalente. */
+    candidateApplicationsPrevious?: number;
+    /** Diferenca absoluta de candidaturas entre os dois periodos. */
+    candidateApplicationsDifference?: number;
+    /** Quantidade de curriculos pendentes de avaliacao ou triagem pelo recrutador. */
+    pendingReviews?: number;
+    /** Quantidade de curriculos pendentes no periodo anterior. */
+    pendingReviewsPrevious?: number;
+    /** Variacao de curriculos pendentes entre os periodos. */
+    pendingReviewsDifference?: number;
+    /** Media aritmetica de candidatos inscritos por vaga publicada no periodo. */
+    averageCandidatesPerVacancy?: number;
+    /** Media de candidatos por vaga no periodo anterior. */
+    averageCandidatesPerVacancyPrevious?: number;
+    /** Diferenca na media de candidatos por vaga. */
+    averageCandidatesDifference?: number;
+    /** Quantidade de vagas ativas no momento (status aberto). */
+    openVacancies?: number;
+    /** Quantidade de vagas encerradas, canceladas ou preenchidas. */
+    closedVacancies?: number;
+    /** Total acumulado de vagas registradas pela instituicao. */
+    totalVacancies?: number;
+}
+/**
+ * Representa uma vaga ou plantao que demanda intervencao imediata do recrutador.
+ * Exibido na secao "Precisa da sua atencao".
+ */
+export interface DashboardAttentionItem {
+    /** Identificador unico da vaga no sistema. */
+    dutyId: number;
+    /** Titulo principal da vaga (ex: especialidade médica, cargo). */
+    title: string;
+    /** Subtitulo contextual com informacoes de horario, setor ou unidade. */
+    subtitle: string;
+    /** Quantidade de profissionais inscritos nesta vaga. */
+    candidatesCount?: number;
+    /** Quantidade de inscricoes pendentes de analise para esta vaga. */
+    pendingReviewsCount?: number;
+    /** Quantidade de dias corridos em que a vaga permanece aberta sem candidaturas. */
+    daysOpen?: number;
+    /** Quantidade de horas decorridas desde a abertura da vaga. */
+    hoursOpen?: number;
+    /** Indica se a vaga e de regime fixo continuo ou plantao avulso. */
+    isFixedJob?: boolean;
+}
+/**
+ * Nivel qualitativo de atratividade e conversao institucional.
+ * Utilizado para parametrizar a renderizacao da onda vetorial de performance.
+ */
+export declare enum PerformanceLevel {
+    /** Nivel Azul: Desempenho satisfatorio, alta conversao e boa procura de candidatos. */
+    Blue = "Blue",
+    /** Nivel Laranja: Desempenho moderado, vagas visualizadas com conversao abaixo do potencial. */
+    Orange = "Orange",
+    /** Nivel Vermelho: Desempenho critico, baixa procura ou periodo prolongado sem publicacoes. */
+    Red = "Red"
+}
+/**
+ * Analise qualitativa e orientacao consultiva sobre o desempenho de recrutamento da instituicao.
+ */
+export interface DashboardPerformanceAnalysis {
+    /** Taxa media percentual de conversao de visualizacoes em candidaturas (0 a 100). */
+    averageConversionRate?: number;
+    /** Nivel de performance categorizado (Blue, Orange ou Red). */
+    level?: PerformanceLevel | number;
+    /** Titulo em destaque sintetizando o diagnostico da instituicao. */
+    highlightTitle?: string;
+    /** Descricao explicativa com recomendacoes praticas para otimizacao das vagas. */
+    description?: string;
+    /** Total de vagas avaliadas no calculo do periodo. */
+    totalVacanciesInPeriod?: number;
+}
+/**
+ * Classificacao comparativa da remuneracao oferecida em relacao a media regional de mercado.
+ */
+export declare enum DutySalaryStatus {
+    /** Remuneracao oferecida abaixo da media praticada na regiao. */
+    BelowMarket = "BelowMarket",
+    /** Remuneracao alinhada com a faixa media de mercado da regiao. */
+    AtMarket = "AtMarket",
+    /** Remuneracao acima da media regional, conferindo vantagem competitiva. */
+    AboveMarket = "AboveMarket",
+    /** Remuneracao a combinar ou nao informada no cadastro da vaga. */
+    NotInformed = "NotInformed",
+    /** Volume amostral insuficiente na regiao para calculo de referencia confiavel. */
+    InsufficientData = "InsufficientData"
+}
+/**
+ * Diagnostico salarial comparativo de uma vaga especifica frente aos dados de mercado da regiao.
+ */
+export interface DashboardDutySalaryComparison {
+    /** Valor monetario oferecido pela instituicao para o plantao ou cargo. */
+    yourSalary?: number | null;
+    /** Valor medio regional apurado para a mesma especialidade e carga horaria. */
+    regionalAverageSalary?: number | null;
+    /** Diferenca percentual em relacao a media regional (positivo indica acima, negativo abaixo). */
+    differencePercentage?: number | null;
+    /** Classificacao da faixa salarial de acordo com o enum DutySalaryStatus. */
+    status: DutySalaryStatus;
+    /** Titulo sintetico do comparativo salarial. */
+    highlightTitle: string;
+    /** Orientacao detalhada sobre o impacto do valor oferecido na velocidade de preenchimento. */
+    description: string;
+    /** Texto formatado do badge visual (ex: '+15%', 'Na media', 'Abaixo'). */
+    badgeText?: string | null;
+}
+/**
+ * Conjunto completo de metricas analiticas de uma vaga selecionada para aprofundamento.
+ * Utilizado na secao "Analise por Vaga".
+ */
+export interface DashboardDutyAnalysis {
+    /** Identificador unico da vaga. */
+    dutyId: number;
+    /** Titulo da vaga ou especialidade. */
+    title: string;
+    /** Detalhes de localidade, data ou modalidade da vaga. */
+    subtitle: string;
+    /** Total de candidaturas confirmadas para a vaga. */
+    candidatesCount: number;
+    /** Quantidade total de visualizacoes da pagina de detalhes da vaga. */
+    viewsCount: number;
+    /** Taxa de conversao calculada: (candidaturas / visualizacoes) * 100. */
+    conversionRate: number;
+    /** Serie historica de pontos temporais de candidaturas para o grafico de linha do tempo. */
+    timelinePoints: TimelinePoint[];
+    /** Fatias do grafico Donut representando a proporcao de conversao de candidatos. */
+    conversionDonut?: DonutChartItem[];
+    /** Etapas do funil de atracao da vaga (Visualizacoes -> Candidaturas). */
+    funnelItems?: FunnelBarItem[];
+    /** Analise comparativa de remuneracao regional da vaga. */
+    salaryComparison?: DashboardDutySalaryComparison;
+}
+/**
+ * Contrato de dados principal que alimenta o componente `<careon-dashboard>`.
+ * Agrupa todas as secoes de metricas, listas e graficos consolidados.
+ */
+export interface DashboardOverviewData {
+    /** Identificador unico da instituicao no sistema. */
+    institutionId?: number;
+    /** Razao social ou nome de exibicao da instituicao. */
+    institutionName?: string;
+    /** Rotulo amigavel do periodo ativo (ex: 'Hoje', 'Semana', 'Mes'). */
+    period?: string;
+    /** Data inicial do intervalo temporal coberto pelas metricas. */
+    startDate?: string | Date;
+    /** Data final do intervalo temporal coberto pelas metricas. */
+    endDate?: string | Date;
+    /** Resumo numerico dos KPIs superiores. */
+    kpis?: DashboardKpiSummary;
+    /** Pontos para o grafico de linha do tempo geral de candidaturas. */
+    timeline?: TimelinePoint[];
+    /** Dados para o grafico de barras comparativas entre vagas. */
+    comparison?: ComparisonItem[];
+    /** Distribuicao percentual de candidaturas por categoria ou especialidade. */
+    distribution?: DonutChartItem[];
+    /** Distribuicao de status das vagas (abertas vs. encerradas) para barra empilhada. */
+    dutiesStatus?: StackedBarItem[];
+    /** Etapas consolidadas do funil geral de recrutamento da instituicao. */
+    recruitmentFunnel?: FunnelBarItem[];
+    /** Relacao de vagas prioritarias que requerem atencao imediata do recrutador. */
+    attentionItems?: DashboardAttentionItem[];
+    /** Diagnostico de performance geral da instituicao com curva de ondas. */
+    performanceAnalysis?: DashboardPerformanceAnalysis;
+    /** Relacao de vagas detalhadas com metricas individuais para o seletor. */
+    vacanciesAnalysis?: DashboardDutyAnalysis[];
+}
+/**
+ * Payload emitido quando um elemento interativo interno de um grafico e selecionado.
+ */
+export interface DashboardItemSelectedEvent<T = any> {
+    /** Nome ou identificador da secao grafica de origem do evento. */
+    chart: string;
+    /** Registro de dados vinculado ao elemento selecionado. */
+    item: T;
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@careonbrasil/dashboard",
+  "version": "14.0.0",
+  "description": "Biblioteca privada do Dashboard de Recrutamento para Angular 14 da CareOn",
+  "peerDependencies": {
+    "@angular/common": ">=14.0.0 <15.0.0",
+    "@angular/core": ">=14.0.0 <15.0.0",
+    "@careonbrasil/ng-charts": "^14.0.6"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "fesm2015/careonbrasil-dashboard.mjs",
+  "es2020": "fesm2020/careonbrasil-dashboard.mjs",
+  "esm2020": "esm2020/careonbrasil-dashboard.mjs",
+  "fesm2020": "fesm2020/careonbrasil-dashboard.mjs",
+  "fesm2015": "fesm2015/careonbrasil-dashboard.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "esm2020": "./esm2020/careonbrasil-dashboard.mjs",
+      "es2020": "./fesm2020/careonbrasil-dashboard.mjs",
+      "es2015": "./fesm2015/careonbrasil-dashboard.mjs",
+      "node": "./fesm2015/careonbrasil-dashboard.mjs",
+      "default": "./fesm2020/careonbrasil-dashboard.mjs"
+    }
+  },
+  "sideEffects": false
+}

package/public-api.d.ts

@@ -0,0 +1,6 @@
+export * from './lib/dashboard.component';
+export * from './lib/careon-dashboard.module';
+export * from './lib/models/dashboard.models';
+export * from './lib/components/performance-wave/performance-wave.component';
+export * from './lib/components/dashboard-icon/dashboard-icon.component';
+export * from './lib/components/dashboard-skeleton/dashboard-skeleton.component';