Apriso 开发人员 AI 工具架构总览Apriso Developer AI Tools Architecture Overview

flowchart TB
    subgraph ENTRY["User Entry Layer"]
        PB["PB Desktop Plugin
AI Dev Assistant Panel"]
        EXT["External MCP Client
Claude / Cline / VS Code"]
    end

    subgraph AGENT["AI Agent Layer"]
        AIPANEL["AI Dev Assistant
Context Tracking + Function Selection"]
        CHAT["ChatClient
MCP JSON-RPC / SSE"]
        MEM["DevAiMemory
Keyword + Semantic Hybrid Retrieval"]
    end

    subgraph MCP["MCP Tool Layer (IIS / net48 / Stateless)"]
        HOST["McpHttpHandler
POST/SSE · Auth · Reflection Registry"]
        TOOLS["49+ MCP Tools
5 Tool Groups"]
        CFG["McpConfig · ConnectionFactory
Web.config Flat Config"]
    end

    subgraph DB["Apriso Database Layer"]
        SA["Solution Authoring DB
Oracle / SQL Server"]
        TABLES["SF_SCREEN · DFC · FUNCTION_
SF_VIEW · SF_VIEW_FORM_CONTROL etc."]
    end

    PB --> AIPANEL
    EXT -->|"POST JSON-RPC"| HOST
    AIPANEL --> CHAT
    CHAT -->|"localhost HTTP/SSE"| HOST
    HOST --> TOOLS
    TOOLS --> CFG
    CFG -->|"Direct SQL Dual-Dialect"| SA
    SA --> TABLES

    style ENTRY fill:#eef1f5,stroke:#4f46e5,color:#1a1a2e
    style AGENT fill:#fdf2f8,stroke:#db2777,color:#1a1a2e
    style MCP fill:#ecfeff,stroke:#0891b2,color:#1a1a2e
    style DB fill:#fffbeb,stroke:#b45309,color:#1a1a2e
        

flowchart LR
    CLIENT["MCP Client"] -->|"POST JSON-RPC
Mcp-Api-Key"| HANDLER["McpHttpHandler
Auth · CORS · Protocol Version Check"]
    HANDLER -->|"Stateless"| TRANSPORT["StreamableHttpServerTransport"]
    TRANSPORT --> SERVER["McpServer.Create"]
    SERVER --> OPTIONS["JsonRpcServerOptionsProvider
Process-level read-only options"]
    OPTIONS -->|"Reflection scan"| TOOLS["ToolCollection
49+ [McpServerTool]"]
    TOOLS --> RESULT["McpToolResult
Unified DTO Wrapper"]
    RESULT -->|"SSE text/event-stream"| CLIENT

    style CLIENT fill:#eef1f5,stroke:#4f46e5,color:#1a1a2e
    style HANDLER fill:#ecfeff,stroke:#0891b2,color:#1a1a2e
    style OPTIONS fill:#ecfeff,stroke:#0891b2,color:#1a1a2e
    style TOOLS fill:#ecfeff,stroke:#0891b2,color:#1a1a2e
        

erDiagram
    SF_SCREEN ||--o{ SF_SCREEN_REVISION : "1:N"
    SF_SCREEN_REVISION ||--o{ SF_SCREEN_REVISION_LINK : "1:N"
    SF_SCREEN_REVISION ||--o{ SF_VIEW : "1:N"
    SF_VIEW ||--o{ SF_VIEW_REVISION : "1:N"
    SF_VIEW_REVISION ||--o{ SF_VIEW_FORM : "1:1"
    SF_VIEW_FORM ||--o{ SF_VIEW_FORM_CONTROL : "1:N"
    SF_VIEW_REVISION ||--o{ SF_VIEW_ACTION : "1:N"
    SF_SCREEN ||--o{ SF_SCREEN_PANEL : "1:N"
    SF_SCREEN_PANEL ||--o{ SF_SCREEN_PANEL_ACTION : "1:N"
    DFC ||--|{ DFC_REVISION : "1:N"
    DFC_REVISION ||--|{ DFC_REVISION_LINK : "1:N"
    DFC_REVISION ||--|{ DFC_STEP : "1:N"
    DFC_STEP ||--|{ DFC_STEP_FUNCTION : "1:N"
    DFC_STEP_FUNCTION ||--|| FUNCTION_ : "1:1"
    FUNCTION_ ||--o{ FUNCTION_INPUT : "1:N"
    FUNCTION_ ||--o{ FUNCTION_OUTPUT : "1:N"
    FUNCTION_OUTPUT ||--o{ FUNCTION_OUTPUT_ROUTING : "1:N"
    BUSINESS_OBJECT ||--o| SF_SCREEN : "SFScreenID"
    BUSINESS_OBJECT ||--o| SF_SCREEN_REVISION : "SFScreenRevisionID"
        

sequenceDiagram
    actor U as User
    participant PB as PB Plugin
    participant AI as AI Dev Assistant
    participant MCP as MCP Server
    participant DB as Apriso DB

    Note over U,DB: Scenario A: AI Chat
    U->>PB: Open AI Dev Assistant panel
    PB->>AI: Auto-capture entity context + selected function
    U->>AI: Type message (auto-attach context)
    AI->>MCP: POST tools/call ai_dev_assistant_chat
    MCP->>DB: Query context entities (optional)
    DB-->>MCP: Entity data
    MCP-->>AI: SSE streaming response
    AI-->>U: Render reply + context summary

    Note over U,DB: Scenario B: External MCP client - Deep Copy Preview
    U->>MCP: POST tools/call deep_copy_screen_preview
    MCP->>DB: SELECT SF_SCREEN + DFC + FUNCTION_
    DB-->>MCP: Entity tree data
    MCP-->>U: SSE JSON response (preview rows)

    Note over U,DB: Scenario C: External MCP client - SQL Query
    U->>MCP: POST tools/call execute_sql_query
    MCP->>DB: SELECT (dual-dialect)
    DB-->>MCP: DataSet
    MCP-->>U: SSE JSON response
        

flowchart TB
    FP["Flexpart / Business Object"]
    FP --> SCR["Screen"]
    SCR --> SCREV["Screen Revision"]
    SCREV -->|"1:N"| VW["View"]
    VW --> VWREV["View Revision"]
    VWREV --> VFC["View Form Control xN
Grid / Button / Input / Label"]
    VWREV --> VACT["View Action xN
with TargetScreenID jump"]
    SCREV --> SP["Screen Panel xN"]
    SP --> SPA["Panel Action xN
with NextScreenID jump"]
    FP --> DFC["DFC"]
    DFC --> DFCREV["DFC Revision"]
    DFCREV --> DSTEP["DFC Step xN"]
    DSTEP --> DSTF["DFC Step Function xN"]
    DSTF --> FN["Function_ (1:1)"]
    FN --> FNIN["Function Input xN"]
    FN --> FNOUT["Function Output xN"]
    FNOUT --> FNROUT["Output Routing xN"]

    style FP fill:#eef1f5,stroke:#4f46e5,color:#1a1a2e
    style SCR fill:#ffffff,stroke:#0891b2,color:#1a1a2e
    style DFC fill:#ffffff,stroke:#059669,color:#1a1a2e
    style FN fill:#eef1f5,stroke:#b45309,color:#1a1a2e
        

sequenceDiagram
    participant AI as AI Agent
    participant MCP as MCP Server
    participant DB as Apriso DB

    Note over AI,DB: Step 1: L0 Index
    AI->>MCP: get_entity_index(name="...Order_V3")
    MCP->>DB: SELECT Screen + COUNT(DFC) + COUNT(View)...
    DB-->>MCP: Aggregate data
    MCP-->>AI: { type:"Screen", id:123, views:3, dfcs:2, functions:28, totalFnLines:8500 }

    Note over AI,DB: Step 2: L1 Tree
    AI->>MCP: get_entity_tree(entityId=123, depth="tree")
    MCP->>DB: SELECT entity tree (no function content)
    DB-->>MCP: Tree structure
    MCP-->>AI: [{ kind:"Screen", name:"..." }, { kind:"DFC", name:"...", children:[{ kind:"Step", functions:[{type:"C#Script", lines:45}, {type:"SQL", lines:12}] }] }, ...]

    Note over AI,DB: Step 3: L2 Content
    AI->>MCP: get_function_content(functionId=456, maxChars=10000)
    MCP->>DB: SELECT FUNCTION_.PropertyValue (parse PropertyBag)
    DB-->>MCP: Script body
    MCP-->>AI: { type:"C#Script", content:"...", lines:45, truncated:false }

    Note over AI,DB: Step 4: L2 Content - ScreenInterface HTML
    AI->>MCP: get_screen_interface(names=["...Order_V3"])
    MCP->>DB: SELECT FUNCTION_ (FunctionType=28) + parse HtmlScreen
    DB-->>MCP: HTML/JS/CSS
    MCP-->>AI: { html:"...(truncated, 5000/12000 chars)", js:"...", css:"...", truncated:true }
        

flowchart TB
    USER["User Request
e.g. 'Copy this Screen and modify the DFC'"] --> PLAN["Task Planning
Decompose into sub-tasks"]
    PLAN --> ORCH["Task Orchestrator
Sequence / Parallel / Conditional"]
    ORCH --> EXEC1["Sub-Task 1
deep_copy_screen_preview"]
    ORCH --> EXEC2["Sub-Task 2
get_entity_tree"]
    ORCH --> EXEC3["Sub-Task 3
create_step / modify_function"]
    EXEC1 --> CHECK{"Success?"}
    EXEC2 --> CHECK2{"Success?"}
    EXEC3 --> CHECK3{"Success?"}
    CHECK -->|"No"| FAIL["Failure Strategy
Retry / Rollback / Escalate"]
    CHECK2 -->|"No"| FAIL
    CHECK3 -->|"No"| FAIL
    CHECK -->|"Yes"| AGG["Result Aggregation"]
    CHECK2 -->|"Yes"| AGG
    CHECK3 -->|"Yes"| AGG
    AGG --> MEM["Memory Update
Store outcome + lessons"]
    MEM --> USER2["Response to User
Summary + next steps"]
    FAIL -->|"Retry"| ORCH
    FAIL -->|"Escalate"| USER2

    style USER fill:#eef1f5,stroke:#4f46e5,color:#1a1a2e
    style PLAN fill:#fdf2f8,stroke:#db2777,color:#1a1a2e
    style ORCH fill:#fdf2f8,stroke:#db2777,color:#1a1a2e
    style FAIL fill:#fffbeb,stroke:#b45309,color:#1a1a2e
    style MEM fill:#ecfeff,stroke:#0891b2,color:#1a1a2e