47 lines
1.6 KiB
Markdown
47 lines
1.6 KiB
Markdown
# portal-common
|
||
|
||
Shared Go-библиотека для микросервисов портала.
|
||
|
||
## Состав
|
||
|
||
- `db/` — pgxpool init + slow-query tracer. Заменяет идентичный код в 9 сервисах.
|
||
- `middleware/` — `InternalAuth` (X-Internal-Key + X-User-*) + хелперы для кастомных заголовков.
|
||
- `portal/` — HTTP-клиент portal-сервиса: directory с кэшем+stale fallback, notifications, deactivate user.
|
||
|
||
## Использование
|
||
|
||
В каждом сервисе:
|
||
|
||
```go
|
||
import (
|
||
"gitea.estateliga.work/admin/portal-common/db"
|
||
"gitea.estateliga.work/admin/portal-common/middleware"
|
||
"gitea.estateliga.work/admin/portal-common/portal"
|
||
)
|
||
|
||
pool, _ := db.ConnectURL(cfg.DatabaseURL)
|
||
|
||
r := chi.NewRouter()
|
||
r.Use(middleware.InternalAuth(cfg.InternalAPIKey))
|
||
|
||
portalCli := portal.New(cfg.PortalBaseURL, cfg.PortalAPIKey)
|
||
```
|
||
|
||
## Dev-режим (без push в Gitea)
|
||
|
||
В `go.mod` сервиса добавить `replace`:
|
||
|
||
```
|
||
replace gitea.estateliga.work/admin/portal-common => ../portal-common
|
||
```
|
||
|
||
Когда библиотека стабилизируется, заменить на pinned тег:
|
||
|
||
```
|
||
require gitea.estateliga.work/admin/portal-common v0.1.0
|
||
```
|
||
|
||
## Зачем
|
||
|
||
До этого 9 сервисов копировали один в один: pgxpool init, slow-query tracer (500ms threshold), InternalAuth middleware. Tweak'ать tuning централизованно было невозможно. Сейчас изменения идут в одном репо, сервисы пересобираются.
|