.

Presentation.md

@@ -0,0 +1,53 @@
+
+# LLM Bill Chat App
+
+This project is a proof of concept for a chat application utilizing a Large Language Model (LLM) to assist users with their telecom billing inquiries. The application is built using Python and Streamlit, providing an interactive web interface for users to engage with.
+
+## Features
+
+- Maintain chat conversation context (history)
+- Allow users to query their billing information
+- Compare the last bills and provide insights
+- Respond exclusively with the user's own billing information
+- Augment the prompt instructions with user's text recognized entities - NER -> Dynamic prompting# Aplicația LLM Bill Chat
+
+## Project Structure
+
+hf-llm-bill-chat/
+│
+├── app.py
+├── pages/
+│   ├── One_model.py
+│   ├── Two_models.py
+│
+├── data/
+│   └── user_data/
+│       └── user_data_724077190.json
+└── logs/
+    └── conversation_logs.json
+
+
+## Code Implementation - Main Script
+
+- Initialize Streamlit app
+- Load user data and display existing bills
+- Handle file uploads for new bills
+- Maintain chat conversation context
+- Leverage user text entities recognition (NER) for dynamic prompting
+- Call OpenAI models (GPT-4o and GPT-4o-mini) for responses
+- Display responses in two parallel columns
+- Log conversation details
+
+## Future Improvements
+
+- Enhance Natural Language Processing (NLP) capabilities for better entity recognition
+- Implement user authentication for secure access to billing information
+- Add support for more telecom providers and bill formats
+- Improve the user interface for better user experience
+- Integrate with payment gateways for bill payments
+
+## Conclusion
+
+- The LLM Bill Chat App demonstrates the potential of using Large Language Models for telecom billing assistance.
+- The app provides a user-friendly interface for querying billing information and getting insights.
+- Future improvements can enhance the app's capabilities and user experience.

Prezentare.md

@@ -0,0 +1,52 @@
+# Aplicația LLM Bill Chat
+
+Acest proiect este un proof of concept pentru o aplicație de chat care utilizează un Model de Limbaj Mare (LLM) pentru a asista utilizatorii cu întrebările lor legate de facturile telecom. Aplicația este construită folosind Python și Streamlit, oferind o interfață web interactivă pentru utilizatori.
+
+## Funcționalități
+
+- Menținerea contextului conversației de chat (istoric)
+- Permite utilizatorilor să își interogheze informațiile de facturare
+- Compararea ultimelor facturi și oferirea de informații
+- Răspunde exclusiv cu informațiile de facturare ale utilizatorului
+- Augmentează instrucțiunile promptului cu entitățile recunoscute din textul utilizatorului - NER -> Prompting dinamic.
+- Salvează informațiile utilizatorului și istoricul conversațiilor
+
+## Structura Proiectului
+
+hf-llm-bill-chat/
+│
+├── app.py
+├── pages/
+│   ├── One_model.py
+│   ├── Two_models.py
+│
+├── data/
+│   └── user_data/
+│       └── user_data_724077190.json
+└── logs/
+    └── conversation_logs.json
+
+## Implementarea Codului - Script Principal
+
+- Inițializează aplicația Streamlit
+- Încarcă datele utilizatorului și afișează facturile existente
+- Gestionează încărcările de fișiere pentru facturile noi
+- Menține contextul conversației de chat
+- Utilizează recunoașterea entităților din textul utilizatorului (NER) pentru prompting dinamic
+- Apelează modelele OpenAI (GPT-4o și GPT-4o-mini) pentru răspunsuri
+- Afișează răspunsurile în două coloane paralele
+- Înregistrează detaliile conversației
+
+## Îmbunătățiri Viitoare
+
+- Îmbunătățirea capacităților de Procesare a Limbajului Natural (NLP) pentru o mai bună recunoaștere a entităților
+- Implementarea autentificării utilizatorilor pentru accesul securizat la informațiile de facturare
+- Adăugarea suportului pentru mai mulți furnizori de telecomunicații și formate de facturi
+- Îmbunătățirea interfeței utilizatorului pentru o experiență mai bună
+- Integrarea cu gateway-uri de plată pentru plata facturilor
+
+## Concluzie
+
+- Aplicația LLM Bill Chat demonstrează potențialul utilizării Modelor de Limbaj Mare pentru asistența în facturarea telecom.
+- Aplicația oferă o interfață prietenoasă pentru interogarea informațiilor de facturare și obținerea de informații.
+- Îmbunătățirile viitoare pot spori capacitățile aplicației și experiența utilizatorului.

README.md

@@ -17,30 +17,31 @@ This project is a proof of concept for a chat application utilizing a Large Lang
 
 ## Features
 
-- Maintain chat conversation context
+- Maintain chat conversation context (history)
 - Allow users to query their billing information
-- Compare the last four bills and provide insights
+- Compare the last bills and provide insights
 - Respond exclusively with the user's own billing information
+- Augment the prompt instructions with user's text recognized entities - NER.
 - Save user information and conversation history
 
 ## Project Structure
 
-```
+
 llm-bill-chat-app
 ├── src
 │   ├── chat
-│   │   ├── __init__.py       # Package initialization for chat module
-│   │   ├── context.py         # Manages conversation context
-│   │   ├── bill_comparison.py  # Compares user bills
-│   │   ├── user_info.py       # Handles user-specific information
-│   │   └── conversation.py     # Manages conversation flow
+│   │   ├── __init__.py
+│   │   ├── context.py
+│   │   ├── bill_comparison.py
+│   │   ├── user_info.py
+│   │   └── conversation.py
 │   └── utils
-│       └── __init__.py       # Package 
-├── bill.py            # Main entry point for the Streamlit app
+│       └── __init__.py 
+├── bill.py        # Streamlit app
 initialization for utils module
-├── requirements.txt           # Project dependencies
-└── README.md                  # Project documentation
-```
+├── requirements.txt
+└── README.md
+
 
 ## Installation
 

diag.md

@@ -0,0 +1,39 @@
++---------------------+
+| hf-llm-bill-chat/   |
++---------------------+
+          |
+          +---------------------+
+          | app.py              |
+          +---------------------+
+          |
+          +---------------------+
+          | pages/              |
+          +---------------------+
+          |     |
+          |     +---------------------+
+          |     | One_model.py        |
+          |     +---------------------+
+          |     |
+          |     +---------------------+
+          |     | Two_models.py       |
+          |     +---------------------+
+          |
+          +---------------------+
+          | data/               |
+          +---------------------+
+          |     |
+          |     +---------------------+
+          |     | user_data/          |
+          |     +---------------------+
+          |           |
+          |           +---------------------+
+          |           | user_data_724077190.json |
+          |           +---------------------+
+          |
+          +---------------------+
+          | logs/               |
+          +---------------------+
+                |
+                +---------------------+
+                | conversation_logs.json |
+                +---------------------+

diag.plantUML

@@ -0,0 +1,17 @@
+@startuml
+package "hf-llm-bill-chat/" {
+    [app.py]
+    package "pages/" {
+        [One_model.py]
+        [Two_models.py]
+    }
+    package "data/" {
+        package "user_data/" {
+            [user_data_724077190.json]
+        }
+    }
+    package "logs/" {
+        [conversation_logs.json]
+    }
+}
+@enduml

logs/conversation_logs.json

@@ -142,5 +142,41 @@
             "total_tokens": 2208
         },
         "cost": 0.06624
+    },
+    {
+        "timestamp": "2025-01-22T17:36:25.195958",
+        "user_id": "0724077190",
+        "user_query": "total costuri?",
+        "assistant_response": "Pentru a calcula totalul costurilor per num\u0103r de telefon din cele dou\u0103 facturi, voi sumariza costurile a\u0219a cum sunt prezentate \u00een datele furnizate.\n\n### Factura 1 (Data: 2025-01-06)\n1. **Num\u0103r telefon: 724015962**\n   - Red 11: 34.08 lei\n   - Reducere promo: -8.52 lei\n   - Secure Net: 2.99 lei\n   - Reducere promotional\u0103 12 luni: -4.26 lei\n   - Rate terminal: 70.99 lei\n   - **Total costuri:** 34.08 - 8.52 + 2.99 - 4.26 + 70.99 = **95.28 lei**\n\n2. **Num\u0103r telefon: 373920691**\n   - Abonament Vodafone WiFi Instant Nelimitat+: 29.82 lei\n   - **Total costuri:** 29.82 lei\n\n3. **Num\u0103r telefon: 724077190**\n   - RED Start: 38.33 lei\n   - Secure Net: 2.99 lei\n   - Reducere promotional\u0103 12 luni: -4.26 lei\n   - Reducere Secure Net: -2.99 lei\n   - Valoare rate r\u0103mase p\u00e2n\u0103 la expirare contract: 5374.54 lei\n   - **Total costuri:** 38.33 + 2.99 - 4.26 - 2.99 + 5374.54 = **5408.61 lei**\n\n### Factura 2 (Data: 2024-12-06)\n1. **Num\u0103r telefon: 724015962**\n   - Red 11: 34.08 lei\n   - Reducere promo: -8.52 lei\n   - Secure Net: 2.99 lei\n   - Reducere promotional\u0103 12 luni: -4.26 lei\n   - Rate terminal: 70.99 lei\n   - **Total costuri:** 34.08 - 8.52 + 2.99 - 4.26 + 70.99 = **95.28 lei**\n\n2. **Num\u0103r telefon: 373920691**\n   - Abonament Vodafone WiFi Instant Nelimitat+: 29.82 lei\n   - **Total costuri:** 29.82 lei\n\n3. **Num\u0103r telefon: 724077190**\n   - RED Start: 38.33 lei\n   - Secure Net: 2.99 lei\n   - Reducere promotional\u0103 12 luni: -4.26 lei\n   - Reducere Secure Net: -2.99 lei\n   - **Total costuri:** 38.33 + 2.99 - 4.26 - 2.99 = **34.07 lei** (f\u0103r\u0103 rate terminal, deoarece acestea nu sunt incluse \u00een Factura 2)\n\n### Total costuri pe num\u0103r de telefon:\n- **Factura 1:**\n  - 724015962: **95.28 lei**\n  - 373920691: **29.82 lei**\n  - 724077190: **5408.61 lei**\n  - **Total factur\u0103 1:** 95.28 + 29.82 + 5408.61 = **5533.71 lei**\n\n- **Factura 2:**\n  - 724015962: **95.28 lei**\n  - 373920691: **29.82 lei**\n  - 724077190: **34.07 lei**\n  - **Total factur\u0103 2:** 95.28 + 29.82 + 34.07 = **159.17 lei**\n\n### Total general costuri:\n- **Total general factur\u0103 1:** **5533.71 lei**\n- **Total general factur\u0103 2:** **159.17 lei**\n\nDac\u0103 ai alte \u00eentreb\u0103ri sau vrei s\u0103 analizezi mai \u00een detaliu vreun aspect, te rog s\u0103 \u00eemi spui!",
+        "tokens": {
+            "prompt_tokens": 3498,
+            "completion_tokens": 854,
+            "total_tokens": 4352
+        },
+        "cost": 0.06527999999999999
+    },
+    {
+        "timestamp": "2025-01-22T17:37:46.055914",
+        "user_id": "0724077190",
+        "user_query": "reia raspunsul",
+        "assistant_response": "Desigur, s\u0103 sumariz\u0103m totalul costurilor pentru fiecare num\u0103r de telefon pe baza informa\u021biilor din facturi.\n\n### Factura 1 (Data: 2025-01-06)\n1. **Num\u0103r telefon: 724015962**\n   - Red 11: 34.08 lei\n   - Reducere promo: -8.52 lei\n   - Secure Net: 2.99 lei\n   - Reducere promotional\u0103 12 luni: -4.26 lei\n   - Rate terminal: 70.99 lei\n   - **Total costuri:** 34.08 - 8.52 + 2.99 - 4.26 + 70.99 = **95.28 lei**\n\n2. **Num\u0103r telefon: 373920691**\n   - Abonament Vodafone WiFi Instant Nelimitat+: 29.82 lei\n   - **Total costuri:** 29.82 lei\n\n3. **Num\u0103r telefon: 724077190**\n   - RED Start: 38.33 lei\n   - Secure Net: 2.99 lei\n   - Reducere promotional\u0103 12 luni: -4.26 lei\n   - Reducere Secure Net: -2.99 lei\n   - Valoare rate r\u0103mase p\u00e2n\u0103 la expirare contract: 5374.54 lei\n   - **Total costuri:** 38.33 + 2.99 - 4.26 - 2.99 + 5374.54 = **5408.61 lei**\n\n### Factura 2 (Data: 2024-12-06)\n1. **Num\u0103r telefon: 724015962**\n   - Red 11: 34.08 lei\n   - Reducere promo: -8.52 lei\n   - Secure Net: 2.99 lei\n   - Reducere promotional\u0103 12 luni: -4.26 lei\n   - Rate terminal: 70.99 lei\n   - **Total costuri:** 34.08 - 8.52 + 2.99 - 4.26 + 70.99 = **95.28 lei**\n\n2. **Num\u0103r telefon: 373920691**\n   - Abonament Vodafone WiFi Instant Nelimitat+: 29.82 lei\n   - **Total costuri:** 29.82 lei\n\n3. **Num\u0103r telefon: 724077190**\n   - RED Start: 38.33 lei\n   - Secure Net: 2.99 lei\n   - Reducere promotional\u0103 12 luni: -4.26 lei\n   - **Total costuri:** 38.33 + 2.99 - 4.26 = **37.06 lei**\n\n### Total costuri pentru fiecare num\u0103r de telefon:\n- **Factura 1:**\n  - 724015962: **95.28 lei**\n  - 373920691: **29.82 lei**\n  - 724077190: **5408.61 lei**\n  - **Total general factur\u0103 1:** 95.28 + 29.82 + 5408.61 = **5533.71 lei**\n\n- **Factura 2:**\n  - 724015962: **95.28 lei**\n  - 373920691: **29.82 lei**\n  - 724077190: **37.06 lei**\n  - **Total general factur\u0103 2:** 95.28 + 29.82 + 37.06 = **162.16 lei**\n\nDac\u0103 ai nevoie de alte detalii sau clarific\u0103ri, te rog s\u0103 \u00eemi spui!",
+        "tokens": {
+            "prompt_tokens": 4364,
+            "completion_tokens": 763,
+            "total_tokens": 5127
+        },
+        "cost": 0.15380999999999997
+    },
+    {
+        "timestamp": "2025-01-27T13:36:32.266831",
+        "user_id": "0724077190",
+        "user_query": "De ce am asa de mult de plata",
+        "assistant_response": "\u00cen baza informa\u021biilor din facturile prezentate, exist\u0103 c\u00e2teva aspecte importante de remarcat care explic\u0103 motivele pentru care ai un total de plat\u0103 at\u00e2t de mare:\n\n1. **Valoare rate ramase pana la expirare contract**: Acesta este un cost semnificativ care se poate acumula odat\u0103 cu trecerea timpului. \u00cen factura din 2025, valoarea rate ramase este de ***5374.54 lei***. Acest lucru indic\u0103 faptul c\u0103 ai un contract de plat\u0103 \u00een rate care este \u00eenc\u0103 activ \u0219i cu o sum\u0103 considerabil\u0103 de plat\u0103 restant\u0103.\n\n2. **Rest plata**: Aceast\u0103 sum\u0103 poate include plata restant\u0103 de la facturile anterioare. \u00cen factura din 2025, restul de plat\u0103 este de ***-5073.74 lei***, ceea ce sugereaz\u0103 c\u0103 a existat o sum\u0103 de plat\u0103 care trebuia acoperit\u0103 din facturile anterioare.\n\n3. **Promotie Vodafone Smartphone cu plata in rate 12/36**: Aceasta este o promo\u021bie prin care ai achizi\u021bionat un smartphone cu plata \u00een rate. Costurile asociate acestei promo\u021bii se adaug\u0103 totalului de plat\u0103 \u0219i contribuie, astfel, la valoarea total\u0103 pe care trebuie s\u0103 o achi\u021bi. \u00cen facturile men\u021bionate, aceast\u0103 promovare apare ca un cost, iar valoarea ratei este de ***70.99 lei*** pentru perioada facturat\u0103.\n\n4. **Total de plata**: \u00cen ultima factur\u0103, totalul de plat\u0103 este de ***5550.46 lei***, ceea ce reflect\u0103 costurile totale acumulate, inclusiv ratele, costurile suplimentare \u0219i alte taxe.\n\nAceste elemente contribuie la suma total\u0103 pe care trebuie s\u0103 o pl\u0103te\u0219ti \u0219i explic\u0103 de ce factura este at\u00e2t de mare. Dac\u0103 ai nevoie de detalii suplimentare, te pot ajuta cu informa\u021bii din facturile respective.",
+        "tokens": {
+            "prompt_tokens": 1789,
+            "completion_tokens": 422,
+            "total_tokens": 2211
+        },
+        "cost": 0.033165
     }
 ]