Update formulas.py

formulas.py

@@ -2,256 +2,215 @@
 
 PLOT_FORMULAS = {
     "posts_activity": {
-        "title": "Posts Activity Over Time",
+        "title": "Attività dei Post nel Tempo",
         "description": (
-            "This chart displays the number of posts made each day over the selected period. "
-            "It helps in understanding posting consistency and identifying trends in content output."
+            "Scopri quanto spesso pubblichi! Questo grafico ti mostra il numero di post pubblicati ogni giorno. "
+            "È perfetto per capire se la tua strategia di contenuti è costante e per individuare i periodi di maggiore attività."
         ),
         "calculation_steps": [
-            "1. Takes the posts dataset and a date column (default: 'published_at').",
-            "2. Converts the date column to a proper datetime format.",
-            "3. Removes any entries where the date is invalid.",
-            "4. Groups the posts by day.",
-            "5. Counts the number of posts for each day.",
-            "6. Displays the daily post count as a line graph over time."
+            "1. Analizziamo i tuoi post e le date di pubblicazione.",
+            "2. Raggruppiamo i post per giorno.",
+            "3. Contiamo quanti post hai fatto ogni giorno.",
+            "4. Ti mostriamo l'andamento come una linea colorata nel tempo. Più è alta, più hai postato!"
         ]
     },
     "mentions_activity": {
-        "title": "Mentions Activity Over Time",
+        "title": "Chi Parla di Te? Attività delle Menzioni",
         "description": (
-            "This chart shows the number of mentions received each day over the selected period. "
-            "It's useful for tracking brand presence and engagement spikes related to mentions."
+            "Quante volte sei stato nominato? Questo grafico traccia le menzioni giornaliere del tuo brand. "
+            "Ideale per monitorare la tua popolarità e l'effetto delle tue campagne."
         ),
         "calculation_steps": [
-            "1. Takes the mentions dataset and a date column (default: 'date').",
-            "2. Converts the date column to a proper datetime format.",
-            "3. Removes any entries where the date is invalid.",
-            "4. Groups the mentions by day.",
-            "5. Counts the number of mentions for each day.",
-            "6. Displays the daily mention count as a line graph over time."
+            "1. Raccogliamo tutte le volte che il tuo brand è stato menzionato.",
+            "2. Controlliamo la data di ogni menzione.",
+            "3. Contiamo le menzioni giorno per giorno.",
+            "4. Visualizziamo il tutto con una linea che sale e scende, mostrandoti i picchi di attenzione!"
         ]
     },
     "mention_sentiment": {
-        "title": "Mention Sentiment Distribution",
+        "title": "Cosa Dice la Gente? Il Sentiment delle Menzioni",
         "description": (
-            "This pie chart illustrates the proportion of mentions categorized by sentiment (e.g., positive, negative, neutral). "
-            "It provides a quick overview of the overall tone surrounding your brand mentions."
+            "Come viene percepito il tuo brand? Questa torta colorata divide le menzioni in base al sentiment (positivo, negativo, neutro). "
+            "Un colpo d'occhio per capire l'umore generale attorno a te!"
         ),
         "calculation_steps": [
-            "1. Takes the mentions dataset and a sentiment column (default: 'sentiment_label').",
-            "2. Counts the occurrences of each unique sentiment value (e.g., 'Positive', 'Negative', 'Neutral').",
-            "3. Displays these counts as a pie chart, with each slice representing the percentage of a sentiment category."
+            "1. Leggiamo le menzioni ricevute.",
+            "2. Capiamo se il tono è positivo, negativo o neutro.",
+            "3. Contiamo quante menzioni appartengono a ciascuna categoria di sentiment.",
+            "4. Ti presentiamo una torta dove ogni fetta colorata rappresenta la percentuale di un tipo di sentiment. Più grande la fetta, più forte quel sentiment!"
         ]
     },
     "followers_count_over_time": {
-        "title": "Followers Count Over Time",
+        "title": "La Tua Community Cresce? Numero di Follower nel Tempo",
         "description": (
-            "This chart tracks the cumulative number of organic and paid followers over time for a specific follower metric (e.g., 'follower_gains_monthly'). "
-            "It helps visualize audience growth from different sources."
-            "The specific metric (e.g., monthly gains, total followers) is determined by the 'type_value' parameter used when generating the plot."
+            "Guarda come cresce la tua base di fan! Questo grafico mostra l'aumento dei tuoi follower, distinguendo tra quelli ottenuti naturalmente (organici) e quelli tramite promozioni (a pagamento). "
+            "Fondamentale per vedere l'impatto delle tue strategie di crescita."
         ),
         "calculation_steps": [
-            "1. Takes the follower statistics dataset.",
-            "2. Filters the data based on a 'type_filter_column' (default: 'follower_count_type') and a specific 'type_value' (e.g., 'follower_gains_monthly').",
-            "3. Uses a date information column (default: 'category_name', expected to contain date strings) and converts it to datetime objects.",
-            "4. Extracts organic follower counts (default: 'follower_count_organic') and paid follower counts (default: 'follower_count_paid').",
-            "5. Ensures follower counts are numeric, replacing missing values with 0.",
-            "6. Removes entries with invalid dates or follower counts.",
-            "7. Sorts the data by date.",
-            "8. Plots the organic and paid follower counts as separate lines on a graph over time."
+            "1. Prendiamo i dati sulla crescita dei tuoi follower.",
+            "2. Distinguiamo i follower 'naturali' da quelli 'a pagamento'.",
+            "3. Controlliamo le date per vedere l'evoluzione mese per mese.",
+            "4. Ti mostriamo due linee colorate: una per i follower organici e una per quelli a pagamento, così vedi subito come sta andando!"
         ]
     },
     "followers_growth_rate": {
-        "title": "Follower Growth Rate",
+        "title": "A Che Velocità Crescono i Follower? Tasso di Crescita",
         "description": (
-            "This chart displays the percentage change in organic and paid followers over time for a specific follower metric. "
-            "It highlights the speed of audience growth or decline. "
-            "The specific metric is determined by the 'type_value' parameter."
+            "Quanto velocemente stai conquistando nuovi follower? Questo grafico ti svela il tasso di crescita percentuale dei tuoi follower organici e a pagamento. "
+            "Indica se la tua community sta accelerando o rallentando."
         ),
         "calculation_steps": [
-            "1. Similar to 'Followers Count Over Time', data is filtered and prepared based on 'type_value'.",
-            "2. The date column is set as the index.",
-            "3. Calculates the period-over-period percentage change for both organic and paid follower counts (e.g., ((current_period_followers - previous_period_followers) / previous_period_followers) * 100).",
-            "4. Handles any infinite values resulting from division by zero (e.g., if previous count was 0).",
-            "5. Plots the calculated organic and paid growth rates as separate lines on a graph over time. The Y-axis is formatted as a percentage."
+            "1. Partiamo dai numeri dei tuoi follower, organici e a pagamento.",
+            "2. Calcoliamo la variazione percentuale da un periodo all'altro (ad esempio, da un mese al successivo).",
+            "3. Ti mostriamo queste percentuali con delle linee, per farti capire subito se stai crescendo più o meno velocemente."
         ]
     },
     "followers_by_demographics": {
-        "title": "Followers by Demographics",
+        "title": "Chi Sono i Tuoi Follower? Analisi Demografica",
         "description": (
-            "This bar chart breaks down the number of organic and paid followers by a chosen demographic category (e.g., country, industry, seniority). "
-            "It shows the top N categories, helping to understand audience composition. The specific demographic breakdown is determined by the 'type_value' (e.g., 'followers_by_country') and 'category_col' parameters."
+            "Conosci il tuo pubblico! Questo grafico a barre mostra da dove vengono i tuoi follower, che ruolo hanno, in che settore lavorano o il loro livello di esperienza. "
+            "Ti fa vedere le categorie principali per capire meglio chi ti segue. Il tipo di dettaglio (es. Paese, Settore) dipende dalla visualizzazione scelta."
         ),
         "calculation_steps": [
-            "1. Takes the follower statistics dataset.",
-            "2. Filters data based on 'type_filter_column' and a specific 'type_value' that defines the demographic type (e.g., 'followers_by_country').",
-            "3. Extracts organic and paid follower counts, ensuring they are numeric.",
-            "4. Groups the data by the specified 'category_col' (e.g., 'country_name') and sums the organic and paid followers for each category.",
-            "5. Sorts the demographic categories by the total number of followers (organic + paid) in descending order.",
-            "6. Displays the top N (default: 10) demographic categories.",
-            "7. For each top category, plots the number of organic and paid followers as a grouped bar chart."
+            "1. Analizziamo le informazioni disponibili sui tuoi follower (come località, settore, etc.).",
+            "2. Raggruppiamo i follower per queste categorie.",
+            "3. Contiamo quanti follower (organici e a pagamento) appartengono a ciascuna categoria.",
+            "4. Ti mostriamo le categorie più numerose con delle barre colorate. Più alta la barra, più follower di quel tipo!"
         ]
     },
     "engagement_rate_over_time": {
-        "title": "Engagement Rate Over Time",
+        "title": "Quanto Coinvolgi? Tasso di Engagement nel Tempo",
         "description": (
-            "This chart visualizes the average engagement rate of your posts on a daily basis. "
-            "Engagement rate is typically calculated as (Total Engagements / Total Impressions or Reach or Followers) * 100. "
-            "The specific formula for 'engagement' column should be predefined in your data."
+            "I tuoi post catturano l'attenzione? Questo grafico misura il tasso di coinvolgimento medio dei tuoi post, giorno per giorno. "
+            "L'engagement si calcola solitamente come (Interazioni Totali / Visualizzazioni o Follower) * 100. Un indicatore chiave per l'efficacia dei contenuti!"
         ),
         "calculation_steps": [
-            "1. Takes the posts dataset with a date column (default: 'published_at') and an engagement rate column (default: 'engagement').",
-            "2. Converts the date column to datetime and the engagement rate column to numeric.",
-            "3. Removes entries with invalid dates or engagement rates.",
-            "4. Groups the data by day.",
-            "5. Calculates the average engagement rate for each day.",
-            "6. Plots this daily average engagement rate as a line graph. The Y-axis is formatted as a percentage."
+            "1. Guardiamo le date dei tuoi post e il loro tasso di engagement (già calcolato nei tuoi dati).",
+            "2. Calcoliamo la media giornaliera del tasso di engagement.",
+            "3. Una linea ti mostrerà l'andamento, facendoti vedere i giorni in cui i tuoi contenuti hanno 'spaccato' di più!"
         ]
     },
     "reach_over_time": {
-        "title": "Reach Over Time (Clicks)",
+        "title": "Quante Persone Raggiungi? Copertura nel Tempo (Click)",
         "description": (
-            "This chart shows the total number of clicks (often used as a proxy for reach for certain post types or if 'reach' data isn't directly available) on your posts, aggregated daily. "
-            "It helps track how many unique users potentially saw your content, based on click interactions."
+            "Fino a dove arrivano i tuoi messaggi? Questo grafico traccia il numero totale di click sui tuoi post, aggregati giornalmente. "
+            "I click sono un buon modo per stimare quante persone hanno interagito attivamente con i tuoi contenuti."
         ),
         "calculation_steps": [
-            "1. Takes the posts dataset with a date column (default: 'published_at') and a clicks column (default: 'clickCount').",
-            "2. Converts the date column to datetime and the clicks column to numeric.",
-            "3. Removes entries with invalid dates or click counts.",
-            "4. Groups the data by day.",
-            "5. Calculates the sum of clicks for each day.",
-            "6. Plots the daily total clicks as a line graph over time."
+            "1. Prendiamo i tuoi post e contiamo i click ricevuti ogni giorno.",
+            "2. Sommiamo i click giornalieri.",
+            "3. Una linea ti mostra l'andamento dei click totali nel tempo. Più sale, più persone interagiscono!"
         ]
     },
     "impressions_over_time": {
-        "title": "Impressions Over Time",
+        "title": "Quante Volte Appari? Visualizzazioni nel Tempo",
         "description": (
-            "This chart displays the total number of impressions your posts received, aggregated daily. "
-            "Impressions represent the total number of times your content was displayed, regardless of whether it was clicked."
+            "Quante volte i tuoi post sono stati visti? Questo grafico mostra il numero totale di visualizzazioni (impression) giornaliere. "
+            "Le visualizzazioni indicano quante volte i tuoi contenuti sono apparsi sullo schermo degli utenti."
         ),
         "calculation_steps": [
-            "1. Takes the posts dataset with a date column (default: 'published_at') and an impressions column (default: 'impressionCount').",
-            "2. Converts the date column to datetime and the impressions column to numeric.",
-            "3. Removes entries with invalid dates or impression counts.",
-            "4. Groups the data by day.",
-            "5. Calculates the sum of impressions for each day.",
-            "6. Plots the daily total impressions as a line graph over time."
+            "1. Analizziamo i tuoi post e contiamo quante volte sono stati visualizzati ogni giorno.",
+            "2. Sommiamo le visualizzazioni giornaliere.",
+            "3. Una linea ti mostra l'andamento delle visualizzazioni totali. Utile per capire la visibilità generale!"
         ]
     },
     "likes_over_time": {
-        "title": "Reactions (Likes) Over Time",
+        "title": "Piaci alla Gente? Reazioni (Like) nel Tempo",
         "description": (
-            "This chart tracks the total number of likes (or reactions) your posts received, aggregated daily. "
-            "It's a key indicator of content resonance and audience appreciation."
+            "I tuoi contenuti piacciono? Questo grafico traccia il numero totale di 'Mi piace' (o reazioni) ricevuti dai tuoi post, giorno per giorno. "
+            "Un segnale forte di apprezzamento da parte del tuo pubblico!"
         ),
         "calculation_steps": [
-            "1. Takes the posts dataset with a date column (default: 'published_at') and a likes column (default: 'likeCount').",
-            "2. Converts the date column to datetime and the likes column to numeric.",
-            "3. Removes entries with invalid dates or like counts.",
-            "4. Groups the data by day.",
-            "5. Calculates the sum of likes for each day.",
-            "6. Plots the daily total likes as a line graph over time."
+            "1. Guardiamo i tuoi post e contiamo i 'Mi piace' ricevuti ogni giorno.",
+            "2. Sommiamo i 'Mi piace' giornalieri.",
+            "3. Una linea ti mostra quanti 'Mi piace' accumuli nel tempo. Vedi subito cosa funziona!"
         ]
     },
-    "clicks_over_time": { # Note: This reuses the reach_over_time logic
-        "title": "Clicks Over Time",
+    "clicks_over_time": {
+        "title": "Click sui Contenuti nel Tempo",
         "description": (
-            "This chart shows the total number of clicks on your posts, aggregated daily. "
-            "It directly measures user interaction involving clicks on your content or links within it."
+            "Quanti click generano i tuoi post? Questo grafico mostra il numero totale di click sui tuoi contenuti o link, aggregati giornalmente. "
+            "Misura diretta dell'interesse e dell'azione degli utenti."
         ),
         "calculation_steps": [
-            "1. Takes the posts dataset with a date column (default: 'published_at') and a clicks column (default: 'clickCount').",
-            "2. Converts the date column to datetime and the clicks column to numeric.",
-            "3. Removes entries with invalid dates or click counts.",
-            "4. Groups the data by day.",
-            "5. Calculates the sum of clicks for each day.",
-            "6. Plots the daily total clicks as a line graph over time. (This plot uses the same calculation logic as 'Reach Over Time (Clicks)')."
+            "1. Prendiamo i tuoi post e contiamo i click ricevuti ogni giorno.", # Stessa logica di 'reach_over_time'
+            "2. Sommiamo i click giornalieri.",
+            "3. Una linea ti mostra l'andamento dei click totali nel tempo. Più sale, più persone interagiscono attivamente!"
         ]
     },
     "shares_over_time": {
-        "title": "Shares Over Time",
+        "title": "Contenuti Virali? Condivisioni nel Tempo",
         "description": (
-            "This chart displays the total number of times your posts were shared, aggregated daily. "
-            "Shares are a strong indicator of content value and audience advocacy."
+            "I tuoi post vengono condivisi? Questo grafico mostra quante volte i tuoi contenuti sono stati ricondivisi, giorno per giorno. "
+            "Le condivisioni sono un ottimo segno: il tuo pubblico apprezza e diffonde i tuoi messaggi!"
         ),
         "calculation_steps": [
-            "1. Takes the posts dataset with a date column (default: 'published_at') and a shares column (default: 'shareCount').",
-            "2. Converts the date column to datetime and the shares column to numeric.",
-            "3. Removes entries with invalid dates or share counts.",
-            "4. Groups the data by day.",
-            "5. Calculates the sum of shares for each day.",
-            "6. Plots the daily total shares as a line graph over time."
+            "1. Analizziamo i tuoi post e contiamo le condivisioni giornaliere.",
+            "2. Sommiamo le condivisioni di ogni giorno.",
+            "3. Una linea ti mostra l'andamento delle condivisioni. Scopri cosa spinge gli altri a parlare di te!"
         ]
     },
     "comments_over_time": {
-        "title": "Comments Over Time",
+        "title": "Si Scatena la Discussione? Commenti nel Tempo",
         "description": (
-            "This chart tracks the total number of comments on your posts, aggregated daily. "
-            "Comments reflect audience engagement and conversation around your content."
+            "I tuoi post stimolano il dibattito? Questo grafico traccia il numero totale di commenti ricevuti, giorno per giorno. "
+            "I commenti indicano un forte coinvolgimento e interazione attorno ai tuoi contenuti."
         ),
         "calculation_steps": [
-            "1. Takes the posts dataset with a date column (default: 'published_at') and a comments column (default: 'commentCount').",
-            "2. Converts the date column to datetime and the comments column to numeric.",
-            "3. Removes entries with invalid dates or comment counts.",
-            "4. Groups the data by day.",
-            "5. Calculates the sum of comments for each day.",
-            "6. Plots the daily total comments as a line graph over time."
+            "1. Guardiamo i tuoi post e contiamo i commenti ricevuti ogni giorno.",
+            "2. Sommiamo i commenti giornalieri.",
+            "3. Una linea ti mostra come variano i commenti nel tempo. Ideale per capire cosa fa parlare il tuo pubblico!"
         ]
     },
     "comments_sentiment_breakdown": {
-        "title": "Breakdown of Comments by Sentiment",
+        "title": "Che Aria Tira nei Commenti? Sentiment dei Commenti",
         "description": (
-            "This pie chart shows the distribution of sentiments (e.g., positive, negative, neutral) expressed in the comments on your posts. "
-            "It helps in understanding audience reactions at a deeper level."
+            "Come reagisce il pubblico nei commenti? Questa torta colorata mostra la distribuzione dei sentimenti (positivo, negativo, neutro) espressi. "
+            "Un modo per capire più a fondo le reazioni del tuo pubblico."
         ),
         "calculation_steps": [
-            "1. Takes the comments dataset (or posts dataset if comments have sentiment labels) and a sentiment column (default: 'comment_sentiment', with 'sentiment' as a fallback).",
-            "2. Ensures the sentiment column is treated as string data.",
-            "3. Counts the occurrences of each unique sentiment value.",
-            "4. Displays these counts as a pie chart, with each slice representing the percentage of a sentiment category in comments."
+            "1. Analizziamo i commenti ai tuoi post.",
+            "2. Interpretiamo il sentiment di ciascun commento.",
+            "3. Contiamo quanti commenti sono positivi, negativi o neutri.",
+            "4. Ti mostriamo una torta dove ogni fetta colorata rappresenta la percentuale di un tipo di sentiment. Vedi subito l'umore dominante!"
         ]
     },
     "post_frequency": {
-        "title": "Post Frequency Over Time",
+        "title": "Ogni Quanto Pubblichi? Frequenza dei Post",
         "description": (
-            "This chart visualizes how frequently posts are made, aggregated by a chosen period (Daily 'D', Weekly 'W', or Monthly 'M'). "
-            "It helps assess content scheduling and output rhythm. The aggregation period is determined by the 'resample_period' parameter."
+            "Qual è il tuo ritmo di pubblicazione? Questo grafico mostra quanto spesso pubblichi, raggruppando i post per giorno, settimana o mese. "
+            "Aiuta a valutare la tua costanza e la pianificazione dei contenuti."
         ),
         "calculation_steps": [
-            "1. Takes the posts dataset with a date column (default: 'published_at').",
-            "2. Converts the date column to datetime format.",
-            "3. Removes entries with invalid dates.",
-            "4. Groups posts by the specified 'resample_period' (e.g., 'D' for day, 'W' for week, 'M' for month).",
-            "5. Counts the number of posts within each period.",
-            "6. Displays the result as a line chart for daily frequency or a bar chart for weekly/monthly frequency."
+            "1. Prendiamo le date di tutti i tuoi post.",
+            "2. Raggruppiamo i post per giorno, settimana o mese (a seconda della scelta).",
+            "3. Contiamo quanti post hai fatto in ciascun periodo.",
+            "4. Ti mostriamo i risultati con un grafico a linee (per i giorni) o a barre (per settimane/mesi). Così vedi subito il tuo ritmo!"
         ]
     },
     "content_format_breakdown": {
-        "title": "Breakdown of Content by Format",
+        "title": "Che Tipo di Contenuti Usi? Formati dei Post",
         "description": (
-            "This bar chart shows the distribution of your posts based on their media type or format (e.g., article, image, video). "
-            "It helps identify which content formats are most commonly used."
+            "Quali formati preferisci? Questo grafico a barre mostra quanti dei tuoi post sono articoli, immagini, video, ecc. "
+            "Ti aiuta a capire quali tipi di contenuto utilizzi di più nella tua strategia."
         ),
         "calculation_steps": [
-            "1. Takes the posts dataset and a format column (default: 'media_type').",
-            "2. Counts the occurrences of each unique media type.",
-            "3. Displays these counts as a bar chart, with each bar representing a media type and its height representing the number of posts."
+            "1. Guardiamo al formato di ogni tuo post (es. testo, immagine, video).",
+            "2. Contiamo quanti post appartengono a ciascun formato.",
+            "3. Ti mostriamo delle barre colorate: ogni barra è un formato e la sua altezza dice quanti post di quel tipo hai fatto."
         ]
     },
     "content_topic_breakdown": {
-        "title": "Breakdown of Content by Topics",
+        "title": "Di Cosa Parli? Argomenti Principali dei Post",
         "description": (
-            "This horizontal bar chart displays the most frequent topics associated with your posts, based on assigned labels (e.g., from 'li_eb_labels' column). "
-            "It shows the top N topics (default: 15) to highlight key themes in your content strategy."
+            "Quali sono i temi caldi dei tuoi contenuti? Questo grafico a barre orizzontali mostra gli argomenti più frequenti nei tuoi post, basandosi sulle etichette che hai assegnato. "
+            "Evidenzia i temi chiave della tua comunicazione (di solito i primi 15)."
         ),
         "calculation_steps": [
-            "1. Takes the posts dataset and a topics column (default: 'li_eb_labels') which may contain single labels or lists of labels.",
-            "2. Parses the topics column: if an entry is a string representation of a list, it's converted to a list; otherwise, it's treated as a single-item list. Empty or invalid entries are handled.",
-            "3. 'Explodes' the data so that each individual topic label from a post gets its own row.",
-            "4. Filters out any empty string labels that might have resulted from parsing.",
-            "5. Counts the occurrences of each unique topic.",
-            "6. Selects the top N most frequent topics (default N=15).",
-            "7. Displays these top topics and their counts as a horizontal bar chart."
+            "1. Analizziamo le etichette o 'tag' che hai associato ai tuoi post.",
+            "2. Contiamo quante volte compare ogni etichetta/argomento.",
+            "3. Selezioniamo gli argomenti più popolari (i top N).",
+            "4. Ti mostriamo delle barre orizzontali: ogni barra è un argomento e la sua lunghezza indica quanto ne parli. Facile capire i tuoi cavalli di battaglia!"
         ]
     }
-}
+}