Home

FinCore Engine - Wiki

Open-source fintech core: double-entry ledger, payment orchestration, KYC/AML compliance, JSON-DSL decision engine. License: BSL 1.1 → Apache 2.0 (4-year change date) · Stack: Kotlin · Spring Boot 3.5 · Hibernate · PostgreSQL · Redpanda · Keycloak

Source of truth for project documentation. The repo's README is short; the deep documentation lives here.

---

Quickstart

git clone https://github.com/tiana-code/fincore-engine
cd fincore-engine
docker compose up -d
./scripts/demo.sh

In 30 seconds you have a sandbox fintech: accounts, transactions, payments, decisions. See Getting-Started.

---

Map

Strategy & Vision

• Vision - what we're building and why
• Roadmap - release timeline
• FAQ - common questions

Architecture

• Architecture-Overview - C4 diagrams, modular monolith
• Architecture-Services - per-service responsibilities
• Architecture-Event-Flow - Kafka topics, outbox dispatcher
• Architecture-Resilience - caching, sagas, fault tolerance
• Architecture-Security - auth, RBAC, OWASP
• Architecture-Observability - metrics, logs, traces
• Architecture-SLA-SLI-SLO - performance targets, error budgets

Domain

• Domain-Model - aggregates, invariants, state machines
• Domain-Glossary - terminology
• Use-Cases - what the system does
• User-Flows - sequence diagrams
• Data-Model - SQL schema, indexes

API

• API-Reference - endpoints with curl examples
• OpenAPI spec: api/openapi.yaml

Decisions

• ADR-Index - all architecture decisions
• ADR-0001 - modular monolith
• ADR-0002 - BSL license
• ADR-0003 - outbox pattern
• ADR-0004 - Hibernate JPA
• ADR-0005 - Keycloak
• ADR-0006 - Redpanda
• ADR-0007 - invariant enforcement
• ADR-0008 - DSL choice
• ADR-0009 - license alternatives

Development

• Code-Rules - Kotlin/Spring conventions (REQUIRED reading)
• Dev-Guides - formatter, deps, git flow, release flow, ADR process
• Testing-Strategy - test categories
• Threat-Modeling - STRIDE per service

Planning

• Epics - index
• Epic-01-Ledger - v0.1.0 epic
• Epic-02-09-Briefs - remaining epics
• Sprint-01-Ledger-Foundation - current sprint

Operations

• Deployment - production deploy guide
• Helm-Chart - chart configuration
• Monitoring - what to watch
• Runbook - incident playbooks
• Incident-Response - post-mortem process
• Risk-Register - risk catalog
• Troubleshooting - common problems

---

Recent updates

• 2026-04-25: Initial Wiki structure created (this version)

(Updated automatically by maintainer.)

---

Contributing

See CONTRIBUTING.md in the repo, plus:

• Code-Rules for code conventions
• Dev-Guides for git flow

---

License

BSL 1.1 - see the LICENSE file. Why BSL? See ADR-0002 and ADR-0009.

Each release auto-converts to Apache 2.0 four years after release date.