SAP Automation Web App

Web interface for managing SAP system configurations, running automations, and monitoring execution through a browser-based dashboard.

Quick Start

cp .env.example .env
# Edit .env with your API keys and credentials
docker-compose up

The app will be available at http://localhost (nginx proxies to the services below).

Architecture

Browser -> nginx (:80)
             |
             +-- /api/*  -> FastAPI backend (:8000) -> PostgreSQL (:5432)
             |                    |
             |                    +-> Claude API (Anthropic)
             |                    +-> SAP Systems (via sap-automation)
             |
             +-- /*      -> Next.js frontend (:3000)

Tech Stack

• Frontend: Next.js 14, React, TypeScript, Tailwind CSS, Clerk (auth)
• Backend: FastAPI, SQLAlchemy (async), Alembic (migrations), Pydantic
• Database: PostgreSQL 16
• Infrastructure: Docker Compose, nginx (reverse proxy)
• AI: Anthropic Claude API for intelligent automation

Development Setup

With Docker (recommended)

docker-compose up

Without Docker

Backend:

cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
alembic upgrade head
uvicorn main:app --reload --port 8000

Frontend:

cd frontend
npm install
npm run dev

PostgreSQL must be running locally on port 5432.

Useful Commands

make up              # Start all services
make down            # Stop all services
make build           # Rebuild Docker images
make dev-backend     # Run backend locally (no Docker)
make dev-frontend    # Run frontend locally (no Docker)
make migrate         # Run database migrations
make test            # Run backend tests
make logs            # Tail all service logs
make clean           # Remove volumes and build artifacts