This article is a continuation. See the first part here
Implementation approach
Readme.md file
General information about the Readme.md file is presented here - https://www.makeareadme.com/ .
The actual version of the file should be on the default branch.
The file should have the following structure:
- Component name
- ()
- .
- .
- ,
Readme.md — ()
, . , .
:
- CREATED — , . . .
- DEV — . , , . DEV . DEV . , , Readme.md .
- PROD- . . PROD . , , Readme.md . , EOL.
- EOL — . .
- ARCHIVE- ( ) , .
Readme.md —
, , , .
Readme.md —
, « ?» « ?». , , .
, 30-50 , , .
, , — . - - , . , .
Readme.md —
, . ( ) ( ).
, Readme.md .
Readme.md — ,
, , . — .
. , java-doc.
Confluence .
, , , Readme.
, .
, , , .
Readme.md —
, , ().
. — , , , .
-, . , , .
« » — https://en.wikipedia.org/wiki/Hexagonal_architecture_(software).
:
- inbound — .
— — , -. .
— dto — dto,
— — : rest, Kafka, MQ . , - outbound- . , , .
— service — , -
— dto —
— : rest, Kafka, MQ . - domain — , .
— — JPA . , , NoSQL, , CRUD - bussines — -, - . — -
( ) «inbound», «outbound» «domain» . - .
, , , , -).
Swagger REST
REST — . REST , .
Swagger :
- , .
- ,
Jira
, .
, Jira :
— Jira-issue, issue , . , , Component Object Jira. , , .
, — (, Confluence) .
Confluence , , , Confluence.
Swagger-HUB
Swagger-HUB . , build-pipeline, , .
. , , , , . , , , - , , .
, . « », .
: , . SwaggerHub , API.
, . - . . , ( Readme.md) Jira.
!!!