Skip to content

docs(concepts): revise layered model for services - #692

Merged
patriknw merged 5 commits into
mainfrom
doc-arch-model-revise
Jun 30, 2025
Merged

patriknw merged 5 commits into
mainfrom
doc-arch-model-revise

Conversation

@beritou

@beritou beritou commented Jun 26, 2025

Copy link
Copy Markdown
Contributor

Present Akka services as using clear layered structure. Describe roles of each layer.

Include project structure example to reinforce conventions.

Closes: lightbend/kalix#13710

@github-actions github-actions Bot added the documentation documentation related label Jun 26, 2025
Present Akka services as using clear layered structure. Describe roles
of each layer.

Include project structure example to reinforce conventions.

Closes: lightbend/kalix#13710
@beritou
beritou force-pushed the doc-arch-model-revise branch from c722a0f to ba1b01b Compare June 26, 2025 19:47
├── domain/ # Business logic
├── application/ # Akka components
└── api/ # External endpoints
----

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The structure for a real project is more like:

 [org.application-name].[module-name].[api|application|domain]`

Examples:

  • com.northwind.trading.api
  • com.northwind.trading.application.StockEntity
  • com.acme.petclinic.domain.VisitRecord

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@patriknw
patriknw requested a review from octonato June 27, 2025 09:56
@beritou
beritou requested a review from patriknw June 28, 2025 01:21

@patriknw patriknw left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@patriknw
patriknw merged commit e9c4e39 into main Jun 30, 2025
@patriknw
patriknw deleted the doc-arch-model-revise branch June 30, 2025 07:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation documentation related

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants