تخيل أن لديك فريقًا من المتخصصين الذين ، وفقًا لمبدأ الكود أولاً ، يصنعون نظامًا به العديد من قصص الأعمال استنادًا إلى الخدمات المصغرة. يتمتع جميع الأشخاص بالخبرة ، وكل شخص لديه ما يفعله إلى جانب كيفية كتابة الوثائق أو المواصفات لواجهة برمجة التطبيقات المطورة. يعلم الجميع في البداية أنه إذا كنت تريد استخدام الخدمة ، فأنت بحاجة إلى النظر في الكود ثم السؤال في الدردشة العامة إذا كان هناك شيء غير واضح. موقف مألوف أليس كذلك؟ -))) وبشكل عام ، كل شيء على ما يرام إذا لم ينمو الفريق بمرور الوقت ، ولم ينمو عدد الخدمات والوظائف ، ولم تظهر الأخطاء من الشركات والمختبرين ، ولم يكن مطلوبًا توفير واجهة برمجة تطبيقات للتكامل مع الفرق ذات الصلة ...
, , . .
. ? , .
- - … . Confluence.
- - Jira .
- , . .
- , , - — Jira
? . . :
- - ( Jira)
- ( , REST json DTO, .
- , REST .
, contract-first , . , , .
TO-DO . . , . . — .
- « »
- ,
- "Single source of true"
:
- Readme.md — , .
- REST Swagger. Swagger Hub
- ,
- Jira , . Jira — Component
- , Readme.md
. . .
Gitlab
Readme.md
Readme.md — . « ». ( ) :
- ?
- ?
- ? ?
- ?
- ?
- ? ? ?
- ?
Readme .md , . , « », .
Swagger REST
Swagger REST REST . Swagger Hub REST. , , , API .
Swagger . . REST , , .
, /src. .
, /doc, . , AsciiDoc (https://asciidoc.org/) PlanUML (https://plantuml.com/).
DAO, JPA REST. .
Jira
Jira — , . Jira , . , .
Jira , , Jira , , ( ) .
"" Jira Jira . . , , .
Jira :
- — . , , . .
- —
- ( ) — , , . ,
Confluence
Service Report ( ) — . — , Readme.md.
Gitlab, Readme.md. , , Gitlab
Swagger Hub
Swagger Hub REST Swagger .