#!/usr/bin/env python3 """ FastAPI Server for N8N Workflow Documentation High-performance API with sub-100ms response times. """ from fastapi import FastAPI, HTTPException, Query, BackgroundTasks from fastapi.staticfiles import StaticFiles from fastapi.responses import HTMLResponse, FileResponse, JSONResponse from fastapi.middleware.cors import CORSMiddleware from fastapi.middleware.gzip import GZipMiddleware from pydantic import BaseModel, field_validator from typing import Optional, List, Dict, Any import json import os import asyncio from pathlib import Path import sys import uvicorn BASE_DIR = Path(__file__).resolve().parent if str(BASE_DIR) not in sys.path: sys.path.insert(0, str(BASE_DIR)) STATIC_DIR = BASE_DIR / "static" WORKFLOWS_DIR = BASE_DIR / "workflows" CONTEXT_DIR = BASE_DIR / "context" os.environ.setdefault("WORKFLOW_SOURCE_DIR", str(WORKFLOWS_DIR)) from workflow_db import WorkflowDatabase # Helper function to ensure database is available def ensure_database(): """Ensure database is initialized, attempt lazy initialization if not.""" global db if db is None: try: db = WorkflowDatabase() except Exception as e: raise HTTPException( status_code=503, detail=f"Database not available: {str(e)}. Please check filesystem permissions." ) return db # Initialize database with error handling app = FastAPI( title="N8N Workflow Documentation API", description="Fast API for browsing and searching workflow documentation", version="2.0.0" ) # Add middleware for performance app.add_middleware(GZipMiddleware, minimum_size=1000) app.add_middleware( CORSMiddleware, allow_origins=["*"], allow_credentials=True, allow_methods=["*"], allow_headers=["*"], ) # Initialize database with error handling db = None try: db = WorkflowDatabase() except Exception as e: print(f"⚠️ Database initialization deferred due to: {e}") print("🔄 Will attempt to initialize database on first request") # Startup function to verify database @app.on_event("startup") async def startup_event(): """Verify database connectivity on startup and trigger indexing if needed.""" global db if db is None: try: print("🔄 Attempting database initialization...") db = WorkflowDatabase() print("✅ Database initialized successfully during startup") except Exception as e: print(f"⚠️ Database initialization still failing: {e}") print("📝 API will run with limited functionality until database is available") return def run_indexing(): print("🚀 Starting background workflow indexing...") try: # It's better to re-initialize the db object in the new thread db_thread = WorkflowDatabase() db_thread.index_all_workflows(force_reindex=True) print("✅ Background workflow indexing complete.") except Exception as e: print(f"❌ Error during background indexing: {e}") try: stats = db.get_stats() if stats['total'] == 0: print("⚠️ Database is empty. Triggering background indexing.") loop = asyncio.get_event_loop() loop.run_in_executor(None, run_indexing) else: print(f"✅ Database connected: {stats['total']} workflows indexed") except Exception as e: print(f"⚠️ Database stats check failed: {e}") # Response models class WorkflowSummary(BaseModel): id: Optional[int] = None filename: str name: str active: bool description: str = "" trigger_type: str = "Manual" complexity: str = "low" node_count: int = 0 integrations: List[str] = [] tags: List[str] = [] created_at: Optional[str] = None updated_at: Optional[str] = None class Config: # Allow conversion of int to bool for active field validate_assignment = True @field_validator('active', mode='before') @classmethod def convert_active(cls, v): if isinstance(v, int): return bool(v) return v class SearchResponse(BaseModel): workflows: List[WorkflowSummary] total: int page: int per_page: int pages: int query: str filters: Dict[str, Any] class StatsResponse(BaseModel): total: int active: int inactive: int triggers: Dict[str, int] complexity: Dict[str, int] total_nodes: int unique_integrations: int last_indexed: str @app.get("/") async def root(): """Serve the main documentation page.""" static_dir = STATIC_DIR index_file = static_dir / "index.html" if not index_file.exists(): return HTMLResponse("""
Static files not found. Please ensure the static directory exists with index.html
Current directory: """ + str(Path.cwd()) + """
""") return FileResponse(str(index_file)) @app.get("/health") async def health_check(): """Health check endpoint.""" return {"status": "healthy", "message": "N8N Workflow API is running"} @app.get("/api/stats", response_model=StatsResponse) async def get_stats(): """Get workflow database statistics.""" try: db_instance = ensure_database() stats = db_instance.get_stats() return StatsResponse(**stats) except HTTPException: raise except Exception as e: raise HTTPException(status_code=500, detail=f"Error fetching stats: {str(e)}") @app.get("/api/workflows", response_model=SearchResponse) async def search_workflows( q: str = Query("", description="Search query"), trigger: str = Query("all", description="Filter by trigger type"), complexity: str = Query("all", description="Filter by complexity"), active_only: bool = Query(False, description="Show only active workflows"), page: int = Query(1, ge=1, description="Page number"), per_page: int = Query(20, ge=1, le=100, description="Items per page") ): """Search and filter workflows with pagination.""" try: db_instance = ensure_database() offset = (page - 1) * per_page workflows, total = db_instance.search_workflows( query=q, trigger_filter=trigger, complexity_filter=complexity, active_only=active_only, limit=per_page, offset=offset ) # Convert to Pydantic models with error handling workflow_summaries = [] for workflow in workflows: try: # Remove extra fields that aren't in the model clean_workflow = { 'id': workflow.get('id'), 'filename': workflow.get('filename', ''), 'name': workflow.get('name', ''), 'active': workflow.get('active', False), 'description': workflow.get('description', ''), 'trigger_type': workflow.get('trigger_type', 'Manual'), 'complexity': workflow.get('complexity', 'low'), 'node_count': workflow.get('node_count', 0), 'integrations': workflow.get('integrations', []), 'tags': workflow.get('tags', []), 'created_at': workflow.get('created_at'), 'updated_at': workflow.get('updated_at') } workflow_summaries.append(WorkflowSummary(**clean_workflow)) except Exception as e: print(f"Error converting workflow {workflow.get('filename', 'unknown')}: {e}") # Continue with other workflows instead of failing completely continue pages = (total + per_page - 1) // per_page # Ceiling division return SearchResponse( workflows=workflow_summaries, total=total, page=page, per_page=per_page, pages=pages, query=q, filters={ "trigger": trigger, "complexity": complexity, "active_only": active_only } ) except HTTPException: raise except Exception as e: raise HTTPException(status_code=500, detail=f"Error searching workflows: {str(e)}") @app.get("/api/workflows/{filename}") async def get_workflow_detail(filename: str): """Get detailed workflow information including raw JSON.""" try: db_instance = ensure_database() # Get workflow metadata from database workflows, _ = db_instance.search_workflows(f'filename:"{filename}"', limit=1) if not workflows: raise HTTPException(status_code=404, detail="Workflow not found in database") workflow_meta = workflows[0] # file_path = Path(__file__).parent / "workflows" / workflow_meta.name / filename # print(f"当前工作目录: {workflow_meta}") # Load raw JSON from file workflows_path = WORKFLOWS_DIR json_files = list(workflows_path.rglob("*.json")) file_path = [f for f in json_files if f.name == filename][0] if not file_path.exists(): print(f"Warning: File {file_path} not found on filesystem but exists in database") raise HTTPException(status_code=404, detail=f"Workflow file '{filename}' not found on filesystem") with open(file_path, 'r', encoding='utf-8') as f: raw_json = json.load(f) return { "metadata": workflow_meta, "raw_json": raw_json } except HTTPException: raise except Exception as e: raise HTTPException(status_code=500, detail=f"Error loading workflow: {str(e)}") @app.get("/api/workflows/{filename}/download") async def download_workflow(filename: str): """Download workflow JSON file.""" try: workflows_path = WORKFLOWS_DIR json_files = list(workflows_path.rglob("*.json")) file_path = [f for f in json_files if f.name == filename][0] if not os.path.exists(file_path): print(f"Warning: Download requested for missing file: {file_path}") raise HTTPException(status_code=404, detail=f"Workflow file '{filename}' not found on filesystem") return FileResponse( file_path, media_type="application/json", filename=filename ) except FileNotFoundError: raise HTTPException(status_code=404, detail=f"Workflow file '{filename}' not found") except Exception as e: print(f"Error downloading workflow {filename}: {str(e)}") raise HTTPException(status_code=500, detail=f"Error downloading workflow: {str(e)}") @app.get("/api/workflows/{filename}/diagram") async def get_workflow_diagram(filename: str): """Get Mermaid diagram code for workflow visualization.""" try: workflows_path = WORKFLOWS_DIR json_files = list(workflows_path.rglob("*.json")) file_path = [f for f in json_files if f.name == filename][0] print(f'{file_path}') if not file_path.exists(): print(f"Warning: Diagram requested for missing file: {file_path}") raise HTTPException(status_code=404, detail=f"Workflow file '{filename}' not found on filesystem") with open(file_path, 'r', encoding='utf-8') as f: data = json.load(f) nodes = data.get('nodes', []) connections = data.get('connections', {}) # Generate Mermaid diagram diagram = generate_mermaid_diagram(nodes, connections) return {"diagram": diagram} except HTTPException: raise except FileNotFoundError: raise HTTPException(status_code=404, detail=f"Workflow file '{filename}' not found") except json.JSONDecodeError as e: print(f"Error parsing JSON in {filename}: {str(e)}") raise HTTPException(status_code=400, detail=f"Invalid JSON in workflow file: {str(e)}") except Exception as e: print(f"Error generating diagram for {filename}: {str(e)}") raise HTTPException(status_code=500, detail=f"Error generating diagram: {str(e)}") def generate_mermaid_diagram(nodes: List[Dict], connections: Dict) -> str: """Generate Mermaid.js flowchart code from workflow nodes and connections.""" if not nodes: return "graph TD\n EmptyWorkflow[No nodes found in workflow]" # Create mapping for node names to ensure valid mermaid IDs mermaid_ids = {} for i, node in enumerate(nodes): node_id = f"node{i}" node_name = node.get('name', f'Node {i}') mermaid_ids[node_name] = node_id # Start building the mermaid diagram mermaid_code = ["graph TD"] # Add nodes with styling for node in nodes: node_name = node.get('name', 'Unnamed') node_id = mermaid_ids[node_name] node_type = node.get('type', '').replace('n8n-nodes-base.', '') # Determine node style based on type style = "" if any(x in node_type.lower() for x in ['trigger', 'webhook', 'cron']): style = "fill:#b3e0ff,stroke:#0066cc" # Blue for triggers elif any(x in node_type.lower() for x in ['if', 'switch']): style = "fill:#ffffb3,stroke:#e6e600" # Yellow for conditional nodes elif any(x in node_type.lower() for x in ['function', 'code']): style = "fill:#d9b3ff,stroke:#6600cc" # Purple for code nodes elif 'error' in node_type.lower(): style = "fill:#ffb3b3,stroke:#cc0000" # Red for error handlers else: style = "fill:#d9d9d9,stroke:#666666" # Gray for other nodes # Add node with label (escaping special characters) clean_name = node_name.replace('"', "'") clean_type = node_type.replace('"', "'") label = f"{clean_name}