golang-ddd-hex

module
v0.0.0-...-88b2b22 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 7, 2020 License: MIT

README

Golang DDD+HEX demo blog api

  • tactical design
    • entities
      • an object defined primarily by its identity
    • value objects
      • immutable
    • repositories
      • how will communicate with storage
    • services
      • corresponds application use cases
      • example: oauth -> user policy -> adding post

context: blogpost
ubiquitous language: author, post, vote, comments, storage
entities: author, post, votes, comments
value objects: it can be part of entity object (author, voter, commenter)
aggregates: PostAuthor, PostVotes, PostComments

  • service:
    • stateless operations
      • post adder / listing,
      • vote increment / decrement / count
      • comment adder / listing
      • author register / login
  • events: can affect to the system (errors, logs)
  • repository: facade over backend

Goals: good structure goal

  • consistent.
  • easy to test.
  • easy to understand.
  • easy to change.

Project Specs

  • author can add a post.
  • author can add a comment for the post.
  • author can vote for the post.
  • author can list all posts with votes.
  • author can list all reviews for the post.

Dependencies:

Status:

in progress

Run:

go build cmd/boilerplate/main.go

Example

http://localhost:8000/swagger/index.html

# add new post
curl -X POST "http://localhost:8000/api/post" -H "accept: application/json" -H "Content-Type: application/json" -d '{"content": "hello cruel world"}'

# get all posts
curl -X GET "http://localhost:8000/api/posts" -H "accept: application/json"

# migrate
migrate -source file://$PWD/db/migrations -database "postgres://adm:1234@localhost:5432/alem?sslmode=disable" up

swag init -g cmd/server/main.go --parseDependency --parseInternal -o ./api

https://khalilstemmler.com/wiki/conways-law/
https://medium.com/@hatajoe/clean-architecture-in-go-4030f11ec1b1
https://khalilstemmler.com/articles/software-design-architecture/organizing-app-logic/
http://olivergierke.de/2020/03/Implementing-DDD-Building-Blocks-in-Java/
https://archfirst.org/domain-driven-design-8-conclusion/
https://herbertograca.com/2017/09/14/ports-adapters-architecture/
https://blog.fedecarg.com/2009/03/11/domain-driven-design-and-mvc-architectures/#:~:text=According%20to%20Eric%20Evans%2C%20Domain,a%20technology%20or%20a%20methodology.&text=Domain%2Ddriven%20design%20separates%20the,to%20retrieve%20and%20store%20data.
http://www.newtonmeters.com/blog/domain-driven-design-in-go/
https://vaadin.com/learn/tutorials/ddd/ddd_and_hexagonal
https://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL