How shivang-agarwal11/dana-tool works
Project Type and Purpose
• DANA is a full-stack, microservices-style DevOps automation platform.
• It provides a React-based UI for low-code pipeline creation and observability, a Node.js/Express backend with MongoDB persistence, and a Python-based AI Agent service for intelligent CI/CD troubleshooting and automation.
Main Components
a. Frontend (dana-app-ui)
• React single-page application
• Components for dashboards, charts, forms, authentication flows
b. Backend/API Server (dana-main-server)
• Node.js • Express
• RESTful endpoints for user management, Jenkins, GitHub, SonarQube, and pipeline analysis
• Middleware for authentication
• MongoDB database
c. AI Agent Service (jenkinsAgenticAI)
• Python (Flask or FastAPI) app.py and rag_deep.py
• Uses Ollama and DeepSeek models for agentic AI tasks
d. External Systems
• Jenkins CI/CD servers
• GitHub (repos, PRs, issues)
• SonarQube server
• MongoDB Atlas or self-hosted
e. DevOps / CI Pipeline
• GitHub Actions (.github/workflows/build.yml)
• SonarQube scanner (sonar-project.properties)
Component Relationships & Data Flows
• The React UI issues AJAX/Fetch requests to the Backend API over HTTPS.
• The Backend:
• Reads/Writes from MongoDB for user data and historical stats.
• Calls Jenkins REST APIs to fetch jobs, build history, logs.
• Calls GitHub REST APIs for commits, PR analysis, and issue creation.
• Calls SonarQube REST APIs for code-quality metrics.
• When AI functionality is invoked (e.g., “Analyze Pipeline”), the Backend forwards requests to the AI Agent Service.
• The AI Agent Service:
• Receives HTTP requests from the Backend.
• Loads and queries large-language models via Ollama/DeepSeek.
• Returns analysis or remediation suggestions.
• DevOps: GitHub Actions pipeline triggers on code commits, runs tests, builds Docker images, and publishes to environments. SonarQube scanner runs as part of the CI to feed quality metrics into the Backend.
Architectural Patterns & Principles
• Client-Server (React SPA + REST API)
• Microservices (separate Python AI service)
• Layered Architecture in Backend: Routes → Controllers → Middleware → Database
• Single Source of Truth in MongoDB
• External Integration Adapters for Jenkins, GitHub, SonarQube
• Low-code/No-code UI separating business logic from presentation
Technologies & Frameworks
• Frontend: React, React Router, Chart.js (BarChart, LineChart, PieChart), CSS
• Backend: Node.js, Express.js, Mongoose (MongoDB), JWT Auth
• AI Agent: Python, Flask (or FastAPI), Ollama, DeepSeek, Transformers
• External: Jenkins REST API, GitHub REST API, SonarQube REST API
• DevOps: GitHub Actions, sonar-project.properties
Essential Details to Capture
• Authentication flow (login endpoint → JWT issuance → ProtectedRoute on UI).
• AI analysis workflow (UI “Analyze” button → POST /analyze/pipeline → AI Agent Service → results displayed).
• Database interactions for user profiles, settings, historical logs.