README_EN.md

Freedom DDD Framework

Freedom is a framework based on a hexagonal architecture that supports the congestion domain model paradigm.

Overview

• Integrated Iris v12
• Integrated Prometheus
• Link Tracing
• Infra Container, Component-based Infrastructure
• Http2 Server & Client
• Dependency Injection & Dependency Inversion
• CRUD Automatic Code Generation
• DDD & Hexagonal Architecture
• Domain Events & MQ Infrastructure
• CQS & Aggregation
• Message Events & Event Retries & Domain Events
• Primary Cache & Secondary Cache & Prevent Breakdown

Install

$ go install github.com/8treenet/freedom/freedom@latest
$ freedom version

Create Project

$ freedom new-project [project-name]
$ cd [project-name]
$ go mod tidy
$ go run server/main.go

Build Persistent Objects(PO)

# Configurable address and output directory, using 'freedom new-po -h' to see more
$ cd [project-name]

# DB schema
$ freedom new-po --dsn "root:123123@tcp(127.0.0.1:3306)/freedom?charset=utf8"

# JSON schema
$ freedom new-po --json ./domain/po/schema.json

Example

Basic Tutorial

Http2 Listening And Dependency Inversion

Transaction Components And Custom Components

Message Events And Domain Events

Electronic Demo(Contains CQS、Aggregation、entity、Domain Events、Repository、Infrastructure)