Bagaimana jika tidak ada yang mau mendokumentasikan? Mengorganisir dokumentasi layanan mikro seminimal mungkin - bagian 2



Artikel ini adalah lanjutan. Lihat bagian pertama di sini



Pendekatan implementasi



File readme.md



Informasi umum tentang file Readme.md disajikan di sini - https://www.makeareadme.com/ .

Versi sebenarnya dari file tersebut harus di cabang default.

File tersebut harus memiliki struktur berikut:



  • Nama komponen
  • Status dan pemilik komponen (layanan mikro)
  • .
  • .
  • ,


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.



!!!




All Articles