Update app.py

app.py

@@ -14,6 +14,8 @@ from gtts import gTTS
 DATA_FILE = "legislation_rules.json"
 RULINGS_FILE = "rulings_log.json"
 
+# --- CORE LOGIC ---
+
 def load_data(file_path):
     if os.path.exists(file_path):
         with open(file_path, 'r') as f:
@@ -34,7 +36,6 @@ def extract_text_from_any(file_obj):
     if file_obj is None: return ""
     file_path = file_obj.name if hasattr(file_obj, 'name') else file_obj
     if not os.path.exists(file_path): return ""
-    
     ext = os.path.splitext(file_path)[1].lower()
     text = ""
     try:
@@ -74,12 +75,10 @@ def process_rule_document(file_obj, act_name):
     return add_rule_manually(act_name, os.path.basename(file_obj.name), text, f"File: {os.path.basename(file_obj.name)}")
 
 def generate_tts(text):
-    """Generates an audio file from text using gTTS."""
-    if not text or len(text) < 5:
-        return None
+    if not text or len(text) < 5: return None
     try:
         clean_text = text.replace("#", "").replace("*", "").replace("`", "")
-        tts = gTTS(text=clean_text[:1500], lang='en') # Limit to first 1500 chars for speed
+        tts = gTTS(text=clean_text[:1500], lang='en')
         filename = f"ruling_audio_{int(datetime.now().timestamp())}.mp3"
         tts.save(filename)
         return filename
@@ -90,31 +89,11 @@ def generate_tts(text):
 def rule_on_issue(issue_description, issue_file, llm_endpoint, llm_key, llm_model):
     file_text = extract_text_from_any(issue_file)
     combined_issue = f"{issue_description}\n\n[EXTRACTED FROM DOCUMENT]:\n{file_text}".strip()
-    
-    if not combined_issue:
-        return "Error: No issue description or document provided.", "", None
-
+    if not combined_issue: return "Error: No issue description or document provided.", "", None
     rules = load_data(DATA_FILE)
-    if not rules:
-        return "Error: Dataset is empty. Add rules (CRA, FCA, etc.) first.", "", None
-    
+    if not rules: return "Error: Dataset is empty. Add rules (CRA, FCA, etc.) first.", "", None
     context = "\n".join([f"[{r['act']} - {r['section_title']}]: {r['text'][:600]}..." for r in rules[:20]])
-    
-    prompt = f"""
-    You are a Regulatory Ruling Engine. 
-    ISSUE TO ANALYZE:
-    {combined_issue}
-    
-    DETERMINISTIC REFERENCE RULES:
-    {context}
-    
-    TASK:
-    1. Identify applicable rules.
-    2. Provide a 'Formal Ruling' (Compliant/Non-Compliant/Warning).
-    3. Cite Rule Titles and Deterministic IDs.
-    4. Provide forensic justification.
-    """
-    
+    prompt = f"You are a Regulatory Ruling Engine.\nISSUE TO ANALYZE:\n{combined_issue}\nDETERMINISTIC REFERENCE RULES:\n{context}\nTASK:\n1. Identify applicable rules.\n2. Provide a 'Formal Ruling' (Compliant/Non-Compliant/Warning).\n3. Cite Rule Titles and Deterministic IDs.\n4. Provide forensic justification."
     ruling_text = "LLM Inference required for automated ruling."
     if llm_endpoint and llm_key:
         try:
@@ -122,23 +101,12 @@ def rule_on_issue(issue_description, issue_file, llm_endpoint, llm_key, llm_mode
             payload = {"model": llm_model, "messages": [{"role": "user", "content": prompt}], "temperature": 0}
             response = requests.post(f"{llm_endpoint.rstrip('/')}/v1/chat/completions", json=payload, headers=headers, timeout=45)
             ruling_text = response.json()['choices'][0]['message']['content']
-        except Exception as e:
-            ruling_text = f"Inference Error: {str(e)}"
-    
-    # Generate Audio for the Ruling
+        except Exception as e: ruling_text = f"Inference Error: {str(e)}"
     audio_file = generate_tts(ruling_text)
-    
-    # Log the ruling
     rulings_log = load_data(RULINGS_FILE)
-    new_ruling = {
-        "timestamp": datetime.now().isoformat(),
-        "issue_summary": combined_issue[:200],
-        "ruling": ruling_text,
-        "ruling_hash": hashlib.sha256(ruling_text.encode()).hexdigest()
-    }
+    new_ruling = {"timestamp": datetime.now().isoformat(), "issue_summary": combined_issue[:200], "ruling": ruling_text, "ruling_hash": hashlib.sha256(ruling_text.encode()).hexdigest()}
     rulings_log.append(new_ruling)
     save_data(rulings_log, RULINGS_FILE)
-    
     return ruling_text, f"Ruling Logged (ID: {new_ruling['ruling_hash'][:8]})", audio_file
 
 def sync_all(token, dataset_id):
@@ -158,6 +126,25 @@ def view_stats():
     for r in data: acts[r['act']] = acts.get(r['act'], 0) + 1
     return "\n".join([f"{k}: {v}" for k,v in acts.items()])
 
+# --- GRADIO UI ---
+
+USER_MANUAL_MD = """
+# ⚖️ Legislation & FCA Ruling Manager: User Manual
+
+## 🛠️ Building Your Rulebase
+1. **Manual Entry**: Go to **Manage Rules** to paste specific sections from acts.
+2. **Document Ingestion**: Upload **PDF, DOCX, or TXT** files of internal policies or acts.
+3. **FCA Automation**: Use the **FCA Guidelines** tab to pull the **12 Principles for Businesses (PRIN)**.
+
+## 🏛️ Ruling on Issues
+1. **Describing the Issue**: Go to **Rule on Issues**. Upload an **Issue Document** or type a description.
+2. **Generating the Ruling**: Ensure your **Inference Settings** are configured, then click **Generate Formal Ruling**.
+3. **Audible Delivery (TTS)**: Click play on the **Audio Player** to hear the ruling read aloud.
+
+## ☁️ Sync & Audit
+- Go to **Sync & Audit**, enter your **HF Write Token** and **Dataset ID**, and click **Sync Everything**.
+"""
+
 with gr.Blocks(theme=gr.themes.Soft()) as demo:
     gr.Markdown("# ⚖️ Legislation & FCA Ruling Manager")
     
@@ -193,10 +180,18 @@ with gr.Blocks(theme=gr.themes.Soft()) as demo:
                 stats_out = gr.Textbox(label="Dataset Inventory", value=view_stats())
                 refresh_btn = gr.Button("Refresh Inventory")
 
+    with gr.Tab("🏦 FCA Guidelines"):
+        gr.Markdown("### 🛠️ FCA Handbook Automation")
+        fca_btn = gr.Button("Ingest FCA PRIN Principles", variant="secondary")
+        fca_status = gr.Textbox(label="FCA Ingestion Status")
+
     with gr.Tab("☁️ Sync & Audit"):
         hf_t = gr.Textbox(label="HF Token", type="password"); hf_d = gr.Textbox(label="Dataset ID")
         s_btn = gr.Button("Sync Everything to Dataset")
         s_out = gr.Textbox(label="Sync Status")
+        
+    with gr.Tab("📖 User Manual"):
+        gr.Markdown(USER_MANUAL_MD)
 
     rule_btn.click(fn=rule_on_issue, inputs=[issue_desc, issue_file, end, key, mod], outputs=[ruling_out, log_status, audio_out])
     doc_btn.click(fn=process_rule_document, inputs=[doc_in, doc_act], outputs=op_status)