この記事は続きです。ここの最初の部分を参照してください
実装アプローチ
Readme.mdファイル
Readme.mdファイルに関する一般的な情報はここに提示される- https://www.makeareadme.com/。
ファイルの実際のバージョンは、デフォルトのブランチにある必要があります。
ファイルの構造は次のとおりです。
- コンポーネント名
- コンポーネント（マイクロサービス）のステータスと所有者
- .
- .
- ,
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.
!!!