medicafe 0.251014.0__tar.gz → 0.251016.0__tar.gz

{medicafe-0.251014.0 → medicafe-0.251016.0}/MediBot/__init__.py

@@ -19,7 +19,7 @@ Smart Import Integration:
         medibot_main = get_components('medibot_main')
 """
 
-__version__ = "0.251014.0"
+__version__ = "0.251016.0"
 __author__ = "Daniel Vidaud"
 __email__ = "daniel@personalizedtransformation.com"
 

{medicafe-0.251014.0 → medicafe-0.251016.0}/MediCafe/__init__.py

@@ -27,7 +27,7 @@ Smart Import System:
         api_suite = get_api_access()
 """
 
-__version__ = "0.251014.0"
+__version__ = "0.251016.0"
 __author__ = "Daniel Vidaud"
 __email__ = "daniel@personalizedtransformation.com"
 

{medicafe-0.251014.0 → medicafe-0.251016.0}/MediCafe/deductible_utils.py

@@ -778,7 +778,17 @@ def convert_eligibility_to_enhanced_format(data, dob, member_id, patient_id="",
                 'data_source': 'Legacy',
                 'is_successful': bool(patient_name and remaining_amount != 'Not Found')
             }
-            
+
+            # Provide a diagnostic reason when the patient name couldn't be resolved
+            if not patient_name:
+                try:
+                    if not compatibility.get("has_patient_info"):
+                        result['error_reason'] = 'Legacy API response missing patientInfo'
+                    else:
+                        result['error_reason'] = 'Legacy patientInfo present but name fields blank'
+                except Exception:
+                    result['error_reason'] = 'Unable to resolve patient name from Legacy response'
+
             if MediLink_ConfigLoader:
                 MediLink_ConfigLoader.log("Successfully converted Legacy API response: {}".format(result), level="DEBUG")
             return result
@@ -815,7 +825,17 @@ def convert_eligibility_to_enhanced_format(data, dob, member_id, patient_id="",
             'data_source': 'OptumAI',
             'is_successful': bool(patient_name and remaining_amount != 'Not Found')
         }
-        
+
+        # Provide a diagnostic reason when the patient name couldn't be resolved
+        if not patient_name:
+            try:
+                if not compatibility.get("has_patient_info"):
+                    result['error_reason'] = 'OptumAI response missing member info'
+                else:
+                    result['error_reason'] = 'OptumAI member info present but name fields blank'
+            except Exception:
+                result['error_reason'] = 'Unable to resolve patient name from OptumAI response'
+
         if MediLink_ConfigLoader:
             MediLink_ConfigLoader.log("Successfully converted Super Connector API response: {}".format(result), level="DEBUG")
         return result
@@ -929,7 +949,8 @@ def merge_responses(optumai_data, legacy_data, dob, member_id):
             'policy_status': 'Not Available',
             'remaining_amount': 'Not Found',
             'data_source': 'None',
-            'is_successful': False
+            'is_successful': False,
+            'error_reason': 'No eligibility responses returned from OptumAI or Legacy APIs'
         }
     
     # Helper to check if data is valid (not None, has required fields)
@@ -1047,7 +1068,8 @@ def merge_responses(optumai_data, legacy_data, dob, member_id):
             'policy_status': 'Not Available', 
             'remaining_amount': 'Not Found',
             'payer_id': '',
-            'data_source': 'None'
+            'data_source': 'None',
+            'error_reason': 'Unable to extract patient name from available eligibility responses'
         }
     
     # Intelligently backfill missing fields from Legacy API (secondary)
@@ -1129,6 +1151,22 @@ def merge_responses(optumai_data, legacy_data, dob, member_id):
     if 'data_source' not in merged or not merged['data_source']:
         merged['data_source'] = 'OptumAI' if primary == optumai_data else 'Legacy' if primary else 'None'
     
+    # If patient name still missing or unknown, infer a failure reason when possible
+    try:
+        if (not merged.get('patient_name')) or (merged.get('patient_name') == 'Unknown Patient'):
+            if not merged.get('error_reason'):
+                if is_super_connector_response_format(optumai_data or {}):
+                    raw = (optumai_data or {}).get('rawGraphQLResponse', {})
+                    elig = raw.get('data', {}).get('checkEligibility', {}).get('eligibility', [])
+                    merged['error_reason'] = 'OptumAI response contained no eligibility records' if not elig else 'OptumAI eligibility present but member name missing'
+                elif is_legacy_response_format(legacy_data or {}):
+                    policies = (legacy_data or {}).get('memberPolicies', [])
+                    merged['error_reason'] = 'Legacy API returned no memberPolicies records' if not policies else 'Legacy policy present but patient name missing'
+                else:
+                    merged['error_reason'] = 'Patient name not found in responses or CSV backfill'
+    except Exception:
+        pass
+
     # Set final success status
     merged['is_successful'] = bool(merged.get('patient_name') and 
                                  merged.get('patient_name') != 'Unknown Patient' and
@@ -1214,6 +1252,13 @@ def backfill_enhanced_result(enhanced_result, csv_row=None):
             csv_name = _format_patient_name_from_csv_row(csv_row)
             if csv_name:
                 result['patient_name'] = csv_name
+            else:
+                # Attach CSV-specific diagnostic if still missing
+                try:
+                    if not result.get('error_reason'):
+                        result['error_reason'] = 'CSV patient name fields missing or blank'
+                except Exception:
+                    pass
 
         # Backfill patient_id
         if not result.get('patient_id') and csv_row is not None:

{medicafe-0.251014.0 → medicafe-0.251016.0}/MediLink/MediLink_Deductible.py

@@ -375,12 +375,16 @@ def manual_deductible_lookup():
 
         # Fetch eligibility data
         found_data = False
+        printed_messages = set()
         for i, payer_id in enumerate(payer_ids, 1):
             print("Checking Payer ID {} ({}/{}): {}".format(payer_id, i, len(payer_ids), payer_id))
             
             # Use the current mode setting for validation
             run_validation = DEBUG_MODE
-            eligibility_data = get_eligibility_info(client, payer_id, provider_last_name, formatted_dob, member_id, npi, run_validation=run_validation, is_manual_lookup=True)
+            eligibility_data = get_eligibility_info(
+                client, payer_id, provider_last_name, formatted_dob, member_id, npi,
+                run_validation=run_validation, is_manual_lookup=True, printed_messages=printed_messages
+            )
             if eligibility_data:
                 found_data = True
                 
@@ -484,13 +488,28 @@ def manual_deductible_lookup():
                             enhanced_result['policy_status'][:14],
                             enhanced_result['remaining_amount'][:14])
                         output_file.write(table_row + "\n")
+
+                        # Persist per-row error diagnostics in a user-friendly way
+                        try:
+                            row_reason = _compute_error_reason(enhanced_result)
+                            row_messages = enhanced_result.get('error_messages', []) or []
+                            if row_reason or row_messages:
+                                output_file.write("  >> Errors:" + "\n")
+                                if row_reason:
+                                    output_file.write("  >> - {}\n".format(row_reason))
+                                for msg in row_messages:
+                                    # Avoid duplicating the reason message if identical
+                                    if not row_reason or msg.strip() != row_reason.strip():
+                                        output_file.write("  >> - {}\n".format(str(msg)))
+                        except Exception:
+                            pass
                     else:
                         display_eligibility_info(eligibility_data, formatted_dob, member_id, output_file)
                 
                 # Ask if user wants to open the report
                 open_report = input("\nEligibility data found! Open the report? (Y/N): ").strip().lower()
                 if open_report in ['y', 'yes']:
-                    os.system('notepad.exe "{}"'.format(output_file_path))
+                    os.startfile(output_file_path)
                 print("Manual eligibility report generated: {}\n".format(output_file_path))
                 break  # Assuming one payer ID per manual lookup
             else:
@@ -523,6 +542,8 @@ def get_eligibility_info(client, payer_id, provider_last_name, date_of_birth, me
         if run_validation:
             # Debug mode: Call both APIs and run validation
             MediLink_ConfigLoader.log("Running in DEBUG MODE - calling both APIs", level="INFO")
+            # Always initialize row-level error messages for diagnostics
+            error_messages_for_row = []
             
             # Get legacy response
             MediLink_ConfigLoader.log("Getting legacy get_eligibility_v3 API response", level="INFO")
@@ -596,6 +617,11 @@ def get_eligibility_info(client, payer_id, provider_last_name, date_of_birth, me
                             if detail_msg not in printed_messages:
                                 print(detail_msg)
                                 printed_messages.add(detail_msg)
+                            # Accumulate per-row messages for persistence in reports
+                            try:
+                                error_messages_for_row.append("{} - {}".format(error_code, error_desc))
+                            except Exception:
+                                pass
                             
                             # Check for data in error extensions (some APIs return data here)
                             extensions = error.get('extensions', {})
@@ -607,20 +633,25 @@ def get_eligibility_info(client, payer_id, provider_last_name, date_of_birth, me
                                     if details:
                                         first_detail = details[0]
                                         print("    First detail: {}".format(first_detail))
+                                        # Persist a brief extension note without dumping raw objects
+                                        try:
+                                            error_messages_for_row.append("Extensions include {} detail record(s)".format(len(details)))
+                                        except Exception:
+                                            pass
                 
                 # Check status code
                 if super_connector_eligibility:
                     status_code = super_connector_eligibility.get('statuscode')
-                    if status_code and status_code != '200':
+                    if status_code is not None and str(status_code).strip() != '200':
                         print("Super Connector API status code: {} (non-200 indicates errors)".format(status_code))
+                        # Record status code for the row diagnostics
+                        error_messages_for_row.append("Status code {} from Super Connector".format(status_code))
                 
                 # Open validation report in Notepad (only for manual lookups, not batch processing)
                 if validation_file_path and os.path.exists(validation_file_path):
                     # Only open in manual mode - batch processing will handle this separately
                     if is_manual_lookup:  # Check if we're in manual lookup mode
-                        ret = os.system('notepad.exe "{}"'.format(validation_file_path))
-                        if ret != 0:
-                            print("Failed to open Notepad (exit code: {}). Please open manually: {}".format(ret, validation_file_path))
+                        os.startfile(validation_file_path)
                 elif validation_file_path:
                     print("\nValidation report file was not created: {}".format(validation_file_path))
             except Exception as e:
@@ -628,7 +659,17 @@ def get_eligibility_info(client, payer_id, provider_last_name, date_of_birth, me
             
             # After validation, merge responses
             try:
-                merged_data = merge_responses(super_connector_eligibility, legacy_eligibility, date_of_birth, member_id)
+                if merge_responses is not None:
+                    merged_data = merge_responses(super_connector_eligibility, legacy_eligibility, date_of_birth, member_id)
+                else:
+                    MediLink_ConfigLoader.log("merge_responses utility not available; returning raw API response", level="WARNING")
+                    merged_data = super_connector_eligibility or legacy_eligibility or {}
+                # Attach accumulated row-level messages for downstream display/persistence
+                try:
+                    if isinstance(merged_data, dict) and error_messages_for_row:
+                        merged_data['error_messages'] = error_messages_for_row
+                except Exception:
+                    pass
                 return merged_data
             except Exception as e:
                 MediLink_ConfigLoader.log("Error in merge_responses: {}".format(e), level="ERROR")
@@ -713,8 +754,10 @@ def display_eligibility_info(data, dob, member_id, output_file, patient_id="", s
     if data is None:
         return
 
-    # Convert to enhanced format
-    enhanced_data = convert_eligibility_to_enhanced_format(data, dob, member_id, patient_id, service_date)
+    # Convert to enhanced format (guard if utility missing)
+    enhanced_data = None
+    if convert_eligibility_to_enhanced_format is not None:
+        enhanced_data = convert_eligibility_to_enhanced_format(data, dob, member_id, patient_id, service_date)
     if enhanced_data:
         # Write to output file in legacy format for compatibility
         table_row = "{:<20} | {:<10} | {:<40} | {:<5} | {:<14} | {:<14}".format(
@@ -727,6 +770,27 @@ def display_eligibility_info(data, dob, member_id, output_file, patient_id="", s
         output_file.write(table_row + "\n")
         print(table_row)  # Print to console for progressive display
 
+# Helper to compute a user-friendly error explanation for a result row
+def _compute_error_reason(record):
+    try:
+        if not isinstance(record, dict):
+            return ""
+        reason = str(record.get('error_reason', '')).strip()
+        name_unknown = (not str(record.get('patient_name', '')).strip()) or (record.get('patient_name') == 'Unknown Patient')
+        has_error = (str(record.get('status', '')) == 'Error') or (str(record.get('data_source', '')) in ['None', 'Error'])
+        amount_missing = (str(record.get('remaining_amount', '')) == 'Not Found')
+
+        if not reason:
+            if name_unknown:
+                reason = 'Patient name could not be determined from API responses or CSV backfill'
+            elif amount_missing:
+                reason = 'Deductible remaining amount not found in eligibility response'
+            elif has_error:
+                reason = 'Eligibility lookup encountered an error; see logs for details'
+        return reason
+    except Exception:
+        return ""
+
 # Global mode flags (will be set in main)
 LEGACY_MODE = False
 DEBUG_MODE = False
@@ -1042,6 +1106,20 @@ if __name__ == "__main__":
                         result['remaining_amount'][:14])
                     output_file.write(table_row + "\n")
 
+                    # Persist per-row error diagnostics in a user-friendly way
+                    try:
+                        row_reason = _compute_error_reason(result)
+                        row_messages = result.get('error_messages', []) or []
+                        if row_reason or row_messages:
+                            output_file.write("  >> Errors:" + "\n")
+                            if row_reason:
+                                output_file.write("  >> - {}\n".format(row_reason))
+                            for msg in row_messages:
+                                if not row_reason or msg.strip() != row_reason.strip():
+                                    output_file.write("  >> - {}\n".format(str(msg)))
+                    except Exception:
+                        pass
+
                 # Write enhanced error summary to file
                 if errors:
                     error_msg = "\nErrors encountered during API calls:\n"
@@ -1053,7 +1131,7 @@ if __name__ == "__main__":
             # Ask if user wants to open the report
             open_report = input("\nBatch processing complete! Open the eligibility report? (Y/N): ").strip().lower()
             if open_report in ['y', 'yes']:
-                os.system('notepad.exe "{}"'.format(output_file_path))
+                os.startfile(output_file_path)
             
             # Print summary of validation reports only in debug mode
             if DEBUG_MODE:
@@ -1072,9 +1150,7 @@ if __name__ == "__main__":
                     if open_validation in ['y', 'yes']:
                         for file_path in validation_files_created:
                             print("Opening: {}".format(os.path.basename(file_path)))
-                            ret = os.system('notepad.exe "{}"'.format(file_path))
-                            if ret != 0:
-                                print("Failed to open Notepad for: {}".format(os.path.basename(file_path)))
+                            os.startfile(file_path)
                 else:
                     print("No validation reports were generated.")
                     print("This may be because:")

{medicafe-0.251014.0 → medicafe-0.251016.0}/MediLink/MediLink_Display_Utils.py

@@ -227,7 +227,9 @@ def _normalize_post_api_data(eligibility_result):
                 'insurance_type': str(eligibility_result.get('insurance_type', '')),
                 'policy_status': str(eligibility_result.get('policy_status', '')),
                 'remaining_amount': str(eligibility_result.get('remaining_amount', '')),
-                'data_source': str(eligibility_result.get('data_source', ''))
+                'data_source': str(eligibility_result.get('data_source', '')),
+                'error_reason': str(eligibility_result.get('error_reason', '')),
+                'is_successful': bool(eligibility_result.get('is_successful', False))
             }
 
             # Default unknown patient name when blank
@@ -440,6 +442,9 @@ def _display_primary_line(record, line_number, col_widths, context):
             str(record.get('data_source', ''))[:col_widths['data_source']], col_widths['data_source']
         ))
 
+        # After primary line in post-API view, display an explanatory error row when appropriate
+        _maybe_display_error_row(record, context)
+
 def _display_secondary_line(record, col_widths, context):
     """Display secondary line with dashes for grouped data"""
     patient_id_dashes = '-' * min(len(str(record.get('patient_id', ''))), col_widths['patient_id'])
@@ -491,4 +496,30 @@ def _display_secondary_line(record, col_widths, context):
             policy_status_dashes, col_widths['policy_status'],
             str(record.get('remaining_amount', ''))[:col_widths['remaining_amount']], col_widths['remaining_amount'],
             str(record.get('data_source', ''))[:col_widths['data_source']], col_widths['data_source']
-        )) 
+        )) 
+
+        # For grouped secondary lines, we do not repeat error rows
+
+def _maybe_display_error_row(record, context):
+    """Print an explanatory error row beneath the primary line when name or other lookups failed."""
+    try:
+        if context != 'post_api':
+            return
+        name_unknown = (not record.get('patient_name')) or (record.get('patient_name') == 'Unknown Patient')
+        has_error = (record.get('status') == 'Error') or (record.get('data_source') in ['None', 'Error'])
+        amount_missing = (str(record.get('remaining_amount', '')) == 'Not Found')
+        reason = record.get('error_reason', '')
+
+        if not reason:
+            if name_unknown:
+                reason = 'Patient name could not be determined from API responses or CSV backfill'
+            elif amount_missing:
+                reason = 'Deductible remaining amount not found in eligibility response'
+            elif has_error:
+                reason = 'Eligibility lookup encountered an error; see logs for details'
+
+        if reason:
+            print("     >> Error: {}".format(reason))
+    except Exception:
+        # Never let diagnostics break table rendering
+        pass

{medicafe-0.251014.0 → medicafe-0.251016.0}/MediLink/__init__.py

@@ -22,7 +22,7 @@ Smart Import Integration:
         datamgmt = get_components('medilink_datamgmt')
 """
 
-__version__ = "0.251014.0"
+__version__ = "0.251016.0"
 __author__ = "Daniel Vidaud"
 __email__ = "daniel@personalizedtransformation.com"
 

{medicafe-0.251014.0/medicafe.egg-info → medicafe-0.251016.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: medicafe
-Version: 0.251014.0
+Version: 0.251016.0
 Summary: MediCafe
 Home-page: https://github.com/katanada2/MediCafe
 Author: Daniel Vidaud

{medicafe-0.251014.0 → medicafe-0.251016.0/medicafe.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: medicafe
-Version: 0.251014.0
+Version: 0.251016.0
 Summary: MediCafe
 Home-page: https://github.com/katanada2/MediCafe
 Author: Daniel Vidaud

{medicafe-0.251014.0 → medicafe-0.251016.0}/setup.py

@@ -54,7 +54,7 @@ if long_description_text is None:
 
 setup(
     name='medicafe',
-    version="0.251014.0",
+    version="0.251016.0",
     description='MediCafe',
     long_description=long_description_text,
     long_description_content_type='text/markdown',