File size: 14,509 Bytes
e135aef
 
 
 
9231df6
e135aef
 
 
 
 
 
 
 
 
 
9231df6
e135aef
 
 
 
 
 
 
9231df6
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
e135aef
 
31e4035
e135aef
 
 
 
 
4b4dd57
9231df6
e135aef
 
9231df6
 
e135aef
 
9231df6
 
 
 
 
e135aef
 
0c7416f
e135aef
 
 
 
 
 
0c7416f
 
 
 
 
 
 
 
 
9231df6
0c7416f
9231df6
 
 
 
 
 
0c7416f
9231df6
 
 
 
 
0c7416f
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
9231df6
0c7416f
 
9231df6
 
 
0c7416f
9231df6
 
0c7416f
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
e135aef
 
 
 
0c7416f
 
 
 
 
e135aef
4b4dd57
9231df6
31e4035
 
4b4dd57
9ef8ded
9231df6
31e4035
9231df6
4b4dd57
31e4035
9231df6
4b4dd57
 
 
e135aef
 
 
 
 
 
 
 
 
 
 
0c7416f
9231df6
e135aef
9231df6
e135aef
9231df6
 
 
 
0c7416f
e135aef
 
9231df6
 
e135aef
 
 
 
 
 
 
 
9231df6
4b4dd57
e135aef
 
 
 
 
 
 
9231df6
e135aef
 
 
 
 
 
 
 
9231df6
9ef8ded
31e4035
 
e135aef
 
9231df6
e135aef
 
 
 
 
31e4035
e135aef
 
0c7416f
e135aef
 
 
 
 
 
 
 
 
0c7416f
9231df6
 
 
e135aef
 
 
 
 
 
 
31e4035
e135aef
 
9231df6
e135aef
9231df6
 
0c7416f
e135aef
 
 
 
 
 
 
 
9231df6
e135aef
 
 
 
 
 
9231df6
e135aef
31e4035
e135aef
 
 
 
 
 
 
31e4035
e135aef
 
 
 
 
 
 
 
 
 
 
 
 
 
9231df6
e135aef
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
9231df6
 
 
 
 
 
 
e135aef
9231df6
 
 
 
 
e135aef
9231df6
 
 
 
 
e135aef
9231df6
e135aef
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
import gradio as gr
import pandas as pd
import duckdb
from datasets import load_dataset
from huggingface_hub import login
import openai
import os
from typing import Dict, List, Any

class SALTAnalytics:
    def __init__(self):
        """Initialize SALT Analytics"""
        self.con = duckdb.connect(':memory:')
        self.data_loaded = False
        self.schema_info = ""
        self.available_columns = []
        
    def load_salt_dataset(self):
        """Load SAP SALT dataset from Hugging Face into DuckDB"""
        if self.data_loaded:
            return "Dataset already loaded!"
            
        try:
            hf_token = os.getenv('HF_TOKEN')
            
            if hf_token:
                dataset = load_dataset(
                    "SAP/SALT", 
                    "joined_table", 
                    split="train", 
                    token=hf_token,
                    streaming=False
                )
            else:
                dataset = load_dataset(
                    "SAP/SALT", 
                    "joined_table", 
                    split="train", 
                    use_auth_token=True,
                    streaming=False
                )
            
            df = dataset.to_pandas()
            
            if len(df) > 100000:
                df = df.sample(n=50000, random_state=42)
            
            self.con.execute("CREATE TABLE salt_data AS SELECT * FROM df")
            
            schema_result = self.con.execute("DESCRIBE salt_data").fetchall()
            self.schema_info = "\n".join([f"{col[0]}: {col[1]}" for col in schema_result])
            self.available_columns = [col[0] for col in schema_result]
            
            self.data_loaded = True
            
            return f"βœ… Successfully loaded {len(df)} records into DuckDB\n\nπŸ“‹ Available columns:\n" + "\n".join(f"β€’ {col}" for col in self.available_columns[:20]) + ("\n... and more" if len(self.available_columns) > 20 else "")
            
        except Exception as e:
            error_msg = str(e)
            if "gated dataset" in error_msg or "authentication" in error_msg.lower():
                return f"❌ Authentication Error: {error_msg}\n\nTo fix this:\n1. Go to https://huggingface.co/datasets/SAP/SALT\n2. Request access to the dataset\n3. Wait for approval\n4. Set HF_TOKEN in your Space secrets"
            else:
                return f"❌ Error loading dataset: {error_msg}"
    
    def get_predefined_insights(self):
        """Generate predefined analytical insights - COMPLETELY FIXED"""
        if not self.data_loaded:
            return "Please load the dataset first"
            
        try:
            insights = {}
            
            # Basic Dataset Overview - This always works
            insights['Dataset Overview'] = self.con.execute("""
                SELECT 
                    COUNT(*) as total_records,
                    COUNT(DISTINCT CREATIONDATE) as unique_dates,
                    MIN(CREATIONDATE) as earliest_date,
                    MAX(CREATIONDATE) as latest_date
                FROM salt_data
            """).fetchdf()
            
            # Payment Terms Distribution - Direct column reference
            if 'CUSTOMERPAYMENTTERMS' in self.available_columns:
                insights['Payment Terms Distribution'] = self.con.execute("""
                    SELECT CUSTOMERPAYMENTTERMS,
                           COUNT(*) as frequency,
                           ROUND(COUNT(*) * 100.0 / SUM(COUNT(*)) OVER(), 2) as percentage
                    FROM salt_data 
                    WHERE CUSTOMERPAYMENTTERMS IS NOT NULL AND CUSTOMERPAYMENTTERMS != ''
                    GROUP BY CUSTOMERPAYMENTTERMS
                    ORDER BY frequency DESC
                    LIMIT 10
                """).fetchdf()
            
            # Sales Office Performance - Find and use the column
            sales_office_col = None
            for col in self.available_columns:
                if 'SALES' in col.upper() and 'OFFICE' in col.upper():
                    sales_office_col = col
                    break
            
            if sales_office_col:
                query = f"""
                    SELECT {sales_office_col}, 
                           COUNT(*) as total_orders
                    FROM salt_data 
                    WHERE {sales_office_col} IS NOT NULL AND {sales_office_col} != ''
                    GROUP BY {sales_office_col}
                    ORDER BY total_orders DESC
                    LIMIT 10
                """
                insights['Sales Office Performance'] = self.con.execute(query).fetchdf()
            
            # Shipping Conditions Analysis
            shipping_col = None
            for col in self.available_columns:
                if 'SHIPPING' in col.upper() and 'CONDITION' in col.upper():
                    shipping_col = col
                    break
            
            if shipping_col:
                query = f"""
                    SELECT {shipping_col},
                           COUNT(*) as order_count
                    FROM salt_data
                    WHERE {shipping_col} IS NOT NULL AND {shipping_col} != ''
                    GROUP BY {shipping_col}
                    ORDER BY order_count DESC
                    LIMIT 10
                """
                insights['Shipping Conditions'] = self.con.execute(query).fetchdf()
            
            # Sales Document Categories
            if 'SALESDOCUMENTITEMCATEGORY' in self.available_columns:
                insights['Sales Document Categories'] = self.con.execute("""
                    SELECT SALESDOCUMENTITEMCATEGORY,
                           COUNT(*) as frequency,
                           ROUND(COUNT(*) * 100.0 / SUM(COUNT(*)) OVER(), 2) as percentage
                    FROM salt_data 
                    WHERE SALESDOCUMENTITEMCATEGORY IS NOT NULL AND SALESDOCUMENTITEMCATEGORY != ''
                    GROUP BY SALESDOCUMENTITEMCATEGORY
                    ORDER BY frequency DESC
                    LIMIT 10
                """).fetchdf()
            
            # Show available columns for debugging
            insights['Available Columns Sample'] = pd.DataFrame({
                'Column Name': self.available_columns[:20],
                'Index': range(len(self.available_columns[:20]))
            })
            
            return insights
            
        except Exception as e:
            # Return detailed error information for debugging
            return f"❌ Error generating insights: {str(e)}\n\nπŸ” Debug Info:\n" + \
                   f"Data loaded: {self.data_loaded}\n" + \
                   f"Available columns ({len(self.available_columns)}): {', '.join(self.available_columns[:15])}...\n" + \
                   f"Error type: {type(e).__name__}"
    
    def clean_sql_response(self, sql_query: str) -> str:
        """Clean SQL response - avoiding string literal errors"""
        backticks = "`" + "`" + "`"
        sql_marker = backticks + "sql"
        
        if sql_query.startswith(sql_marker):
            sql_query = sql_query[6:]
        elif sql_query.startswith(backticks):
            sql_query = sql_query[3:]
        
        if sql_query.endswith(backticks):
            sql_query = sql_query[:-3]
            
        return sql_query.strip()
    
    def natural_language_query(self, question: str, api_key: str):
        """Convert natural language to SQL and execute"""
        if not self.data_loaded:
            return "Please load the dataset first"
            
        if not api_key:
            return "Please provide OpenAI API key"
            
        try:
            client = openai.OpenAI(api_key=api_key)
            
            columns_list = ", ".join(self.available_columns[:30])
            
            prompt = f"""
            You are a SQL expert analyzing SAP SALT dataset. The database has a table called 'salt_data' with these available columns:
            
            {columns_list}
            
            The SALT dataset contains SAP ERP sales order data where each row represents a sales document item.
            
            IMPORTANT: Use only the column names I provided above. Do not assume column names that don't exist.
            
            Convert this question to a DuckDB SQL query: "{question}"
            
            Return ONLY the SQL query, no explanation. Limit results to 20 rows and use WHERE clauses to filter out NULL values.
            """
            
            response = client.chat.completions.create(
                model="gpt-4",
                messages=[{"role": "user", "content": prompt}],
                temperature=0.1
            )
            
            sql_query = response.choices[0].message.content.strip()
            sql_query = self.clean_sql_response(sql_query)
            
            result_df = self.con.execute(sql_query).fetchdf()
            
            explanation_prompt = f"""
            Question: {question}
            Results: {result_df.head(10).to_string()}
            
            Provide a clear business explanation of these SAP ERP results in 2-3 sentences, focusing on actionable insights for sales operations.
            """
            
            explanation_response = client.chat.completions.create(
                model="gpt-4",
                messages=[{"role": "user", "content": explanation_prompt}],
                temperature=0.3
            )
            
            explanation = explanation_response.choices[0].message.content
            
            code_block = "`" + "`" + "`"
            return f"**SQL Query:**\n{code_block}sql\n{sql_query}\n{code_block}\n\n**Results:**\n{result_df.to_string(index=False)}\n\n**Explanation:**\n{explanation}"
            
        except Exception as e:
            return f"Error: {str(e)}\n\nTry rephrasing your question. Available columns: {', '.join(self.available_columns[:10])}..."

# Initialize analytics
analytics = SALTAnalytics()

def load_dataset_interface():
    return analytics.load_salt_dataset()

def show_insights_interface():
    """Fixed insights interface with better error handling"""
    insights = analytics.get_predefined_insights()
    
    if isinstance(insights, str):
        return insights
    
    output = "# πŸ“Š SAP SALT Dataset Insights\n\n"
    
    for title, df in insights.items():
        output += f"## {title}\n\n"
        if isinstance(df, pd.DataFrame) and len(df) > 0:
            output += df.to_markdown(index=False)
        else:
            output += "*No data available for this analysis*"
        output += "\n\n---\n\n"
    
    return output

def qa_interface(question: str, api_key: str):
    if not question.strip():
        return "Please enter a question"
    return analytics.natural_language_query(question, api_key)

sample_questions = [
    "Which sales offices process the most orders?",
    "What are the most common payment terms?",
    "Show me the distribution of shipping conditions",
    "What is the date range of orders in the dataset?",
    "Which document categories are most frequent?"
]

with gr.Blocks(title="SAP SALT Analytics Demo", theme=gr.themes.Soft()) as demo:
    
    gr.Markdown("""
    # πŸš€ SAP SALT Dataset Analytics Demo
    ## Open Source Analytics + AI for SAP ERP
    
    This demo uses the **authentic SAP SALT dataset** - real ERP data from sales orders, items, customers, and addresses.
    """)
    
    with gr.Tab("πŸ“₯ Load Dataset"):
        gr.Markdown("### Load SAP SALT Dataset from Hugging Face")
        
        load_btn = gr.Button("Load SALT Dataset", variant="primary")
        load_output = gr.Textbox(label="Status", lines=8)
        
        load_btn.click(fn=load_dataset_interface, outputs=load_output)
    
    with gr.Tab("πŸ“ˆ Insights"):
        gr.Markdown("### Pre-built Analytics Insights")
        
        insights_btn = gr.Button("Generate Insights", variant="primary")
        insights_output = gr.Markdown()
        
        insights_btn.click(fn=show_insights_interface, outputs=insights_output)
    
    with gr.Tab("πŸ€– AI Q&A"):
        gr.Markdown("### Ask Questions in Natural Language")
        
        with gr.Row():
            with gr.Column(scale=3):
                api_key_input = gr.Textbox(
                    label="OpenAI API Key",
                    type="password",
                    placeholder="Enter your OpenAI API key"
                )
                
                question_input = gr.Textbox(
                    label="Your Question",
                    placeholder="e.g., Which sales offices process the most orders?",
                    lines=2
                )
                
                sample_dropdown = gr.Dropdown(
                    choices=sample_questions,
                    label="Or choose a sample question",
                    value=None
                )
                
                ask_btn = gr.Button("Get Answer", variant="primary")
            
            with gr.Column(scale=4):
                qa_output = gr.Markdown()
        
        sample_dropdown.change(
            fn=lambda x: x if x else "",
            inputs=sample_dropdown,
            outputs=question_input
        )
        
        ask_btn.click(
            fn=qa_interface,
            inputs=[question_input, api_key_input],
            outputs=qa_output
        )
    
    with gr.Tab("ℹ️ About"):
        gr.Markdown("""
        ### About the SALT Dataset
        
        **SAP SALT** (Sales Autocompletion Linked Business Tables) contains:
        - **500,908 sales orders** from real SAP S/4HANA system
        - **2.3M sales order line items** 
        - **139,611 unique customers**
        - **Data from 2018-2020** with full business context
        
        **Key Use Cases:**
        - Sales process automation (70-80% accuracy)
        - Customer behavior analysis
        - Shipping and logistics optimization
        - Payment terms prediction
        
        **Technology Stack:**
        - **DuckDB**: High-performance analytics
        - **OpenAI GPT-4**: Natural language to SQL
        - **Gradio**: Interactive interface
        - **Real ERP Data**: Authentic business scenarios
        
        This demonstrates how **open source tools** can unlock massive value from enterprise SAP systems at zero licensing cost.
        """)

if __name__ == "__main__":
    demo.launch()