Конфигурация хранит feature_flags (JSON-массив, NULL = нет) — какие данные она использует. Флаги выводятся из содержимого при каждом сохранении (internal/configfeatures). Если у конфигурации есть флаг, неизвестный этой версии, клиент отказывается её изменять: все write-пути отдают 409 unsupported_config_features со списком флагов, конфигуратор показывает баннер «обновите приложение» и блокирует сохранение. Push на сервер тоже отказывается, если серверная версия несёт неизвестный флаг; такое изменение остаётся в очереди до обновления. Первый флаг: sale_row_markups. Серверная миграция 034 добавляет колонку; до её применения запись идёт без колонки (с warning). Формат имён и реестр флагов — bible-local/02-architecture.md, ADL 2026-09-24. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
97 lines
2.2 KiB
Go
97 lines
2.2 KiB
Go
package handlers
|
|
|
|
import (
|
|
"encoding/json"
|
|
"errors"
|
|
"io"
|
|
"net/http"
|
|
"strings"
|
|
|
|
"git.mchus.pro/mchus/quoteforge/internal/configfeatures"
|
|
"github.com/gin-gonic/gin"
|
|
)
|
|
|
|
func RespondError(c *gin.Context, status int, fallback string, err error) {
|
|
if err != nil {
|
|
_ = c.Error(err)
|
|
}
|
|
// A write refused over unknown configuration feature flags is a 409 with the flag list,
|
|
// whatever status the caller picked — every config write path funnels through here.
|
|
if ue, ok := configfeatures.AsUnsupported(err); ok {
|
|
c.JSON(http.StatusConflict, gin.H{
|
|
"error": ue.Error(),
|
|
"code": "unsupported_config_features",
|
|
"unsupported_features": ue.Flags,
|
|
})
|
|
return
|
|
}
|
|
c.JSON(status, gin.H{"error": clientFacingErrorMessage(status, fallback, err)})
|
|
}
|
|
|
|
// BindJSON decodes the request body into T, responding with a 422 and writing
|
|
// the error via RespondError on failure. The second return value reports success.
|
|
func BindJSON[T any](c *gin.Context) (*T, bool) {
|
|
var req T
|
|
if err := c.ShouldBindJSON(&req); err != nil {
|
|
RespondError(c, http.StatusUnprocessableEntity, "invalid request", err)
|
|
return nil, false
|
|
}
|
|
return &req, true
|
|
}
|
|
|
|
func clientFacingErrorMessage(status int, fallback string, err error) string {
|
|
if err == nil {
|
|
return fallback
|
|
}
|
|
if status >= 500 {
|
|
return fallback
|
|
}
|
|
if isRequestDecodeError(err) {
|
|
return fallback
|
|
}
|
|
|
|
message := strings.TrimSpace(err.Error())
|
|
if message == "" {
|
|
return fallback
|
|
}
|
|
if looksTechnicalError(message) {
|
|
return fallback
|
|
}
|
|
return message
|
|
}
|
|
|
|
func isRequestDecodeError(err error) bool {
|
|
var syntaxErr *json.SyntaxError
|
|
if errors.As(err, &syntaxErr) {
|
|
return true
|
|
}
|
|
|
|
var unmarshalTypeErr *json.UnmarshalTypeError
|
|
if errors.As(err, &unmarshalTypeErr) {
|
|
return true
|
|
}
|
|
|
|
return errors.Is(err, io.ErrUnexpectedEOF) || errors.Is(err, io.EOF)
|
|
}
|
|
|
|
func looksTechnicalError(message string) bool {
|
|
lower := strings.ToLower(strings.TrimSpace(message))
|
|
needles := []string{
|
|
"sql",
|
|
"gorm",
|
|
"driver",
|
|
"constraint",
|
|
"syntax error",
|
|
"unexpected eof",
|
|
"record not found",
|
|
"no such table",
|
|
"stack trace",
|
|
}
|
|
for _, needle := range needles {
|
|
if strings.Contains(lower, needle) {
|
|
return true
|
|
}
|
|
}
|
|
return false
|
|
}
|