IDIN CoreGo backend framework

An opinionated stack over Echo, GORM, MongoDB, Redis and RabbitMQ — so services start with routing, config, errors and jobs already wired.

Get Started

What's new in v2

View on GitLab

🧩

One context, every capability

Database, cache, queue, config, logger and structured errors reachable from a single per-request container.

🌐

HTTP with binding & validation

Bind a request, validate it, and return structured errors — routing, middleware and error handling come pre-assembled.

🗄️

Generic repository

A chainable, type-safe data layer over GORM and MongoDB, with pagination and preloading built in.

⏱️

Jobs & scheduling

Cron jobs, queues and RabbitMQ consumers that share the same context and error reporting as your HTTP handlers.

🧪

Mocks that ship with it

Every interface has a hand-written mock, and build tags split unit, integration and end-to-end suites.

🚀

Ready to deploy

Docker, Kubernetes and GitLab CI/CD recipes that match how these services actually run in production.

Choosing a version

Two major versions live side by side. v2 is a separate Go module, so both can be imported into the same build while you migrate — nothing forces a big-bang upgrade.

	v1	v2
Import path	`gitlab.finema.co/finema/idin-core`	`gitlab.finema.co/finema/idin-core/v2`
Status	Stable — maintained for existing services	Active development
Entry point	`NewContext` / `NewHTTPServer`	`NewApp` with explicit `With…` options
Jobs	Cronjob context	Job runner: triggers, queue, status, logs
Documentation	v1 guide	v2 guide

v2v1

go get gitlab.finema.co/finema/idin-core/v2

go get gitlab.finema.co/finema/idin-core

Because the module path is private, configure Go and Git once per machine:

export GOPRIVATE=gitlab.finema.co/finema/*
git config --global url."[email protected]:".insteadOf "https://gitlab.finema.co/"

New service? Start from the starter template.