Skip to content

Commit

Permalink
created concept folder
Browse files Browse the repository at this point in the history
  • Loading branch information
Marc Gorzala committed Dec 29, 2023
1 parent 0842e70 commit 13b732e
Show file tree
Hide file tree
Showing 5 changed files with 68 additions and 10 deletions.
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,5 @@ build
.asciidoctor
*.iml
*.bkp
*.dtmp

Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
= Handling Timezones in our Microservices
:jbake-type: page
:jbake-status: published
:jbake-date: 2023-12-10
:jbake-tags: architecture
:jbake-description: How we are dealing with timezones
:jbake-author: Marc Gorzala
:jbake-disqus_enabled: true
:jbake-disqus_identifier: c7a95fa4-975d-11ee-a865-fbcdbd64ae80


== The Problem


== Decision

In all Persistence Technologies we are storing Timestampes in UTC (with out timezone information)

All Server run on UTC

But Application is there for started with utc

(show command line snippte)


mvn spring-boot:run -Dspring-boot.run.jvmArguments="-Duser.timezone=UTC"

offsetdatetime


https://stackoverflow.com/questions/54316667/how-do-i-force-a-spring-boot-jvm-into-utc-time-zone

everything from outwards ist being transformed
29 changes: 29 additions & 0 deletions src/main/jbake/content/documentation/arc42/concepts/index.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
== Cross-cutting Concepts

=== Handling of Time-related information

==== The Problem

Handling Times correctly is a common Problem


==== Our way to handle this
* UTC in all Persistence Technologie
* Storage without Timezone
* Expose Timestamp in Formats with given (UTC)-Timezone

=== Inverting the test-pyramid

* Relying more on End2End-Test (what means more like System Tests)
* Unit and Integration Test only for that parts with lots of branches in the code

=== Handling of Profiles in Spring Boot based Projects

==== Dev Environment and Profile

This own is active when the developer runs his application locally

==== IT Profile

IT stands for Integrations-Tests

Original file line number Diff line number Diff line change
Expand Up @@ -29,4 +29,8 @@ The only constraints we have is to obey our architectural principles. Find them
|Id|Convention|Description
|C1|Be polite|being aggressive or rude... will never do anything good.
|C2|Listen first, judge less|When confronted with a different point of view, give your colleague the chance to explain themselves.
|C3|Name Convention Database names | SQL key words in UPPERCASE, identifiers (database names, tables, colums) in snake_case
|C4|Name Convention (Kafka-)Topic names | use hyphens and all lower case: profile-updated


|===
11 changes: 1 addition & 10 deletions src/main/jbake/content/documentation/arc42/src/08_concepts.adoc
Original file line number Diff line number Diff line change
@@ -1,15 +1,6 @@
[[section-concepts]]
== Cross-cutting Concepts

=== Handling of Timestamps

* UTC in all Persistence Technologie
* Storage without Timezone
* Expose Timestamp in Formats with given (UTC)-Timezone

=== Inverting the test-pyramid

* Relying more on End2End-Test (what means more like System Tests)
* Unit and Integration Test only for that parts with lots of branches in the code
find our Cross Cutting Concepts link:https://project.dancier.net/documentation/arc42/concepts/index.html[here]


0 comments on commit 13b732e

Please sign in to comment.