backend-microservice-development
后端微服务开发规范,涵盖目录结构、分层架构(API/Service/DAO)、依赖注入、配置管理、Spring Boot 最佳实践。当用户进行后端开发、创建新微服务、编写 Kotlin/Java 代码或设计服务架构时使用。
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
后端微服务开发规范,涵盖目录结构、分层架构(API/Service/DAO)、依赖注入、配置管理、Spring Boot 最佳实践。当用户进行后端开发、创建新微服务、编写 Kotlin/Java 代码或设计服务架构时使用。
How to use
Zidentyfikuj typ zasobu, który budujesz — UserPipelineResource dla interfejsu publicznego, ServiceProcessResource dla komunikacji wewnętrznej, BuildDispatchResource dla agentów, lub OpenApiResource dla klientów zewnętrznych. Każdy typ ma inny prefiks i zakres dostępu.
Utwórz strukturę katalogów zgodnie z czterowarstwową architekturą: api-{service} dla definicji interfejsów REST, biz-{service} dla logiki biznesowej i DAO, boot-{service} jako niezależna jednostka deploymentu, model-{service} dla obiektów dostępu do bazy danych generowanych przez JOOQ.
Zdefiniuj interfejs Resource w warstwie api-{service} używając adnotacji @Path, @GET/@POST, @Operation do dokumentacji OpenAPI. Parametry autentykacji pobieraj z nagłówka AUTH_HEADER_USER_ID, zwracaj odpowiedź w typie Result
. Zaimplementuj Resource w tej samej warstwie z iniekcją konstruktora @Autowired — wstrzykuj Service z warstwy biz-{service}. Nie umieszczaj logiki biznesowej w Resource, deleguj do Service.
W warstwie biz-{service} napisz Service z metodami biznesowymi oraz DAO do dostępu do danych. Stosuj nazewnictwo pakietów com.tencent.devops.{modul}.
Skonfiguruj Spring Boot w boot-{service} — zarejestruj komponenty, ustaw properties, przygotuj artefakt do deploymentu jako niezależny mikroserwis.