haer-connector

Integration layer source-agnostic + AI. Repo: github.com/msa-haer-org/haer-connector  · folder lokal sama.

Stack

Python 3.12, FastAPI + SQLAlchemy 2 async + Alembic. Postgres-only. uv untuk dependency & venv.

Fungsi

Ingest data dari sistem HR arbitrer → normalisasi jadi model kanonik Person / Signal → expose ke AI agent sebagai MCP tool primitive. Reference use case: triage flight-risk karyawan.

Menjalankan

uv sync
psql -d postgres -c "CREATE DATABASE haer_connector"
uv run alembic upgrade head

Jalanin FastAPI-nya (lihat README.md). Lint + format: uv run ruff check . dan uv run ruff format ..

Konvensi

ruff strict (lint + format). FastAPI + SQLAlchemy 2 async. Postgres-only.

Migrasi (Alembic)

uv run alembic upgrade head apply semua migration. Pakai scratch-DB recipe buat generate/verify. Aturan lintas-repo: Data & Migrations.

Observability

Trace jalur AI/LLM lewat Langfuse (skor confidence + reviewer feedback).

Deploy

Dideploy via Coolify.

Source of truth: README.md di repo (+ plan docs di docs/).