Overview
The Conformly.ai backend is a FastAPI-based REST API that provides AI-powered automotive compliance analysis. It supports multiple industry standards including ASPICE, ISO 26262, ISO/SAE 21434, and more.Features
- Multi-Standard Compliance: Simultaneous evaluation against ASPICE, ISO 26262, ISO 21434
- AI-Powered Analysis: LangGraph-based workflow with multimodal document processing
- Visual Evidence: Automated highlighting and grounding evidence for audit trails
- Workspace Management: Multi-tenant workspace organization
- Document Processing: PDF parsing with OCR and structure analysis
- Comprehensive Reporting: Detailed compliance reports with gap analysis
- Background Processing: Celery + Redis for async task execution
Architecture
Diagrams emphasize user flows over internal layers for clarity.
User Flow (Traceability Analysis)
Technology Stack
- Framework: FastAPI (Python 3.11+)
- Task Queue: Celery with Redis
- Database: Supabase (PostgreSQL)
- File Storage: Supabase Storage (S3-compatible)
- AI/ML: LangGraph, Google Gemini, Tavily
- Vector Store: FAISS
- Authentication: Supabase JWT
Core Components
API Layer
- RESTful endpoints organized by resource
- Request/response validation with Pydantic
- Authentication middleware
- Error handling and logging
Services Layer
- AI Services: LangGraph workflow for compliance analysis
- File Service: Document processing and parsing
- Job Service: Background task management
- Report Service: Report generation
- Artifact Extraction: Traceability extraction
Task Processing
- Celery Workers: Execute long-running analysis tasks
- Celery Beat: Scheduled tasks (cleanup, maintenance)
- Redis: Message broker and result backend
API Documentation
When running locally, access interactive API documentation:- Swagger UI:
http://localhost:8000/docs - ReDoc:
http://localhost:8000/redoc
View API Reference
Complete API endpoint documentation