PenaDevops/docs
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Mikhail 2023-12-27 21:37:48 +00:00
parent 43307074a0
commit 993777bc63
1 changed files with 5 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
architecture/golang/README.md
View File

@ -14,23 +14,18 @@
├── .dockerignore - Файл для перечисления игнорирования докером файлов/директорий ├── .dockerignore - Файл для перечисления игнорирования докером файлов/директорий
├── .gitignore - Файл для перечисления игнорирования гитом файлов/директорий ├── .gitignore - Файл для перечисления игнорирования гитом файлов/директорий
├── .gitlab-ci.yml - Файл настройки Gitlab CI ├── .gitlab-ci.yml - Файл настройки Gitlab CI
├── .golangci.yaml - Файл настройки линтера для Golang -- убрать, вынести в общий репозиторий, в хуки ├── .mockery.yaml - Файл настройки пакета mockery для генерации моков на Golang. используем для внешних зависимостей или пустых сервисов
├── .mockery.yaml - Файл настройки пакета mockery для генерации моков на Golang -- либо заменяем мокери, либо мок имиспользуем для внешних зависимостей или пустых сервисов
├── .buf.gen.yaml - https://buf.build/docs/configuration/v1/buf-gen-yaml
├── .buf.work.yaml - https://buf.build/docs/configuration/v1/buf-work-yaml/
├── .buf.yaml - https://buf.build/docs/configuration/v1/buf-yaml/ -- proto2swagger не используем
├── go.mod - Корень управления зависимостями в GoLang ├── go.mod - Корень управления зависимостями в GoLang
├── go.sum - Файл содержащий хеши для нескольких версий модуля ├── go.sum - Файл содержащий хеши для нескольких версий модуля
├── Makefile - Набор команд -- заменить на go-task ├── Taskfile.yml - Набор команд go-task
├── README.md - Общий файл документации (путеводитель) ├── README.md - Общий файл документации (путеводитель)
``` ```
## Структура `/cmd`: ## Структура `/cmd`:
``` ```
├── [app name] - Название приложения (app) -- уходим от пракки некольких сервисов в одном репозитории, поэтому подкаталог делать не надо ├── main.go - Точка входа в приложение
│ ├── main.go - Точка входа в приложение ├── Dockerfile - Файл контейнеризации сервиса -- проверить возможность скопировать из корня проекта
│ ├── Dockerfile - Файл контейнеризации сервиса -- проверить возможность скопировать из корня проекта
``` ```
## Структура `/docs`: ## Структура `/docs`:
@ -53,11 +48,10 @@
├── adapters - Данная директория хранит адаптеры для взаимодействия с внешними сервисами ├── adapters - Данная директория хранит адаптеры для взаимодействия с внешними сервисами
│ ├── client - Пакет клиента для взаимодействия с другими приложениями (REST, gRPC) │ ├── client - Пакет клиента для взаимодействия с другими приложениями (REST, gRPC)
│ │ ├── [name].go - Сам клиент │ │ ├── [name].go - Сам клиент
├── repository - Директория репозиториев для взаимодействия с базой данных -- если есть набор отдельных баз, то делаем отдельные подкаталоги ├── repository - Директория репозиториев для взаимодействия с базой данных, если есть набор отдельных баз, то делаем отдельные подкаталоги
│ ├── [name].go - Файл репозитория (user.go) │ ├── [name].go - Файл репозитория (user.go)
├── controller - Директория контроллеров ├── controller - Директория контроллеров
│ ├── [name] - Директория контроллера │ ├── [name] - Директория контроллера
│ │ ├── mocks - Директория, которая хранит сгенерированные моки для контроллера
│ │ ├── [name].go - Сам контроллер. Хранит в себе обработчики внешних запросов │ │ ├── [name].go - Сам контроллер. Хранит в себе обработчики внешних запросов
│ │ ├── [name]_test.go - Файл тестов для контроллера │ │ ├── [name]_test.go - Файл тестов для контроллера
├── models - Пакет моделей данных ├── models - Пакет моделей данных