AI system for automated JIRA Support Case analysis with COBOL/SQL/JCL code intelligence

Go to file

Ricel Leite 34bcd9f116 chore: Remove portal folder - dashboard is integrated in main_v3.py		2026-02-18 19:06:09 -03:00
api	feat: Universal issue tracker integration v2.0	2026-02-18 18:41:20 -03:00
docs	docs: Add Developer Guide, User Guide, and Architecture documentation	2026-02-18 18:55:54 -03:00
workers	Atualizar workers/indexer.py	2026-02-18 17:39:55 +00:00
.env.example	Atualizar .env.example	2026-02-18 17:41:07 +00:00
.gitignore	feat: Initial project structure	2026-02-18 13:33:43 -03:00
README.md	Atualizar README.md	2026-02-18 17:33:06 +00:00
docker-compose.prod.yml	Atualizar docker-compose.prod.yml	2026-02-18 17:41:52 +00:00
docker-compose.yml	Atualizar docker-compose.yml	2026-02-18 17:42:17 +00:00

README.md

JIRA AI Fixer

AI system for automated JIRA Support Case analysis with COBOL/SQL/JCL code intelligence.

Overview

JIRA AI Fixer monitors JIRA Support Cases, analyzes the reported issues, searches relevant code in Bitbucket repositories, and proposes fixes using AI-powered code understanding.

Architecture

JIRA (webhook) → Event Processor → Code Intelligence → Fix Generator → Output (JIRA + PR)

Stack

Backend: Python 3.11+ / FastAPI
Vector DB: Qdrant (embeddings)
Queue: Redis + Bull
Database: PostgreSQL
LLM: Azure OpenAI GPT-4o / OpenRouter (dev)
Embeddings: MiniLM-L6-v2 (local) / Azure OpenAI (prod)

Project Structure

jira-ai-fixer/
├── api/                    # FastAPI backend
│   ├── main.py
│   ├── routers/
│   │   ├── webhook.py      # JIRA/Bitbucket webhooks
│   │   ├── issues.py       # Issue management
│   │   └── config.py       # Configuration API
│   ├── services/
│   │   ├── jira.py         # JIRA client
│   │   ├── bitbucket.py    # Bitbucket client
│   │   ├── llm.py          # LLM orchestration
│   │   └── embeddings.py   # Code indexing
│   └── models/
├── portal/                 # React admin UI
│   ├── src/
│   └── package.json
├── workers/                # Background processors
│   ├── analyzer.py
│   └── indexer.py
├── tests/
├── docker-compose.yml
├── .env.example
└── README.md

Quick Start

# Clone
git clone https://gitea.startdata.com.br/startdata/jira-ai-fixer.git
cd jira-ai-fixer

# Configure
cp .env.example .env
# Edit .env with your credentials

# Run (development)
docker compose up -d

# Access portal
open https://localhost:8080

Development

Requirements

Python 3.11+
Node.js 20+
Docker & Docker Compose
Redis
PostgreSQL (or SQLite for dev)

Local Setup

# Backend
cd api
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload

# Portal
cd portal
npm install
npm run dev

Configuration

All configuration is done via the Admin Portal or environment variables:

Variable	Description	Required
`JIRA_URL`	JIRA Server URL	Yes
`JIRA_TOKEN`	JIRA API Token	Yes
`BITBUCKET_URL`	Bitbucket Server URL	Yes
`BITBUCKET_TOKEN`	Bitbucket Access Token	Yes
`AZURE_OPENAI_ENDPOINT`	Azure OpenAI endpoint	Yes (prod)
`AZURE_OPENAI_KEY`	Azure OpenAI API key	Yes (prod)
`OPENROUTER_API_KEY`	OpenRouter key	Yes (dev)
`DATABASE_URL`	PostgreSQL connection	Yes
`REDIS_URL`	Redis connection	Yes

License

Proprietary - Ricel Leite

Contact

Developer: Ricel Leite