Backend: Trigger AI Analysis and Architecture Generation

[lele-maxwell]

Description

Create a backend service that receives a request from the UI and performs architecture analysis using the AI engine. It should:

• Analyze the full project structure
• Generate architectural layers (system, modules, components)
• Identify patterns and dependencies
• Return a JSON with both structured data and Mermaid-compatible diagrams

Requirements

• Endpoint: POST /api/analyze-architecture
• Accepts project reference or upload ID
• Returns structured architecture data + Mermaid syntax + summaries
• Handle edge cases: invalid repos, unsupported structures, large files

Acceptance Criteria

• Architecture data is generated correctly
• Failures return appropriate error codes and messages