AIDIS

Autonomous AI Decision Intelligence System (AIDIS) is a full-stack portfolio project that turns business inputs into structured strategic recommendations.

The system combines a multi-agent backend with a modern frontend to guide users from intake to decision output, trade-off analysis, and follow-up strategy refinement.

Monorepo Layout

• aidis-backend/ - FastAPI backend, auth, session storage, and multi-agent orchestration
• aidis-frontend/ - Next.js frontend (App Router) for intake, streaming analysis, and report views
• project_report.txt - Product and roadmap context

Tech Stack

• Frontend: Next.js 16, React 19, TypeScript, Tailwind CSS, Recharts
• Backend: FastAPI, LangGraph, LangChain Google GenAI, JWT auth, SQLite session store
• Testing: Python unittest + FastAPI TestClient contract tests

Prerequisites

• Python 3.11+ (recommended)
• Node.js 20+ and npm
• A Google API key for Gemini access

1) Backend Setup

From the workspace root:

cd aidis-backend
python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt

Create environment file:

Copy-Item .env.example .env

Set values in aidis-backend/.env:

• GOOGLE_API_KEY (required)
• JWT_SECRET_KEY (required)
• ALLOWED_ORIGINS (default: http://localhost:3000)

Run the backend:

uvicorn main:app --reload --host 127.0.0.1 --port 8000

2) Frontend Setup

Open a second terminal from the workspace root:

cd aidis-frontend
npm install

Create aidis-frontend/.env.local:

NEXT_PUBLIC_API_URL=http://localhost:8000
# Optional: used by auto re-auth logic in app/lib/auth.ts
DEMO_PASSWORD=your_demo_password

Run the frontend:

npm run dev

Open:

• Frontend: http://localhost:3000
• Backend health/info: http://localhost:8000/

Running Tests

Backend contract tests:

cd aidis-backend
python -m unittest tests.test_contracts -v

API Surface (Current)

Auth:

• POST /auth/register
• POST /auth/token

Analysis and sessions:

• POST /analyze (SSE stream)
• GET /session/{session_id}
• GET /sessions

Post-analysis interaction:

• POST /chat/{session_id}
• POST /refine/{session_id}

Utility:

• GET /
• GET /favicon.ico

Notes

• Backend CORS is controlled by ALLOWED_ORIGINS.
• The backend stores local state in aidis-backend/aidis_sessions.db.
• The frontend stores auth state in browser localStorage.

Existing Project Docs

• aidis-frontend/README.md for frontend-focused product notes
• aidis-backend/API_CONTRACT_v1.md for API contract details
• aidis-backend/API_CONTRACT_CHANGELOG.md for contract evolution