Enterprise Go The Spring Way

server:
  cors:
    allowed-origins:
      - "http://localhost:3000"
      - "https://app.yourdomain.com"
    allowed-origin-patterns:
      - "https://*.yourdomain.com"
    allowed-methods: ["GET","POST","PUT"]
    allow-credentials: true
    max-age: 3600

func TestCreateUser(t *testing.T) {
  app := test.NewSprinGoTestContext(t)
  defer app.TearDown()

  app.ReplaceBean("EmailService",
    &MockEmailService{})

  app.Client.
    Post("/api/v1/users").
    WithJSON(payload).
    Execute().
    ExpectStatus(http.StatusCreated).
    ExpectBodyContains(`"status":201`)
}

// Parameters auto-injected by framework
func (c *UserController) GetProfile(
    ctx     context.Context,
    user    *security.UserInfo,  // ← auto-injected
    traceID web.TraceID,        // ← auto-injected
) (any, error) {
    return c.svc.Get(ctx, user.Username)
}

// Declarative @Transactional on endpoint
r.Post("/complex", web.DispatchTx(c.complexDemo))

// Nested propagation in service
database.Transactional(txCtx, logFn,
    database.WithPropagation(
        database.PropagationRequiresNew))

# YAML file structured hierarchy
validation:
  required: "El campo es requerido"
  min: "Debe tener al menos {0} caracteres"
  UserRequest:
    email:
      email: "Dirección de correo inválida"

spring:
  telemetry:
    enabled: true
    service-name: "my-awesome-api"
    zipkin:
      enabled: true
      endpoint: "http://localhost:9411/api/v2/spans"
      batch-size: 100
      flush-interval: "5s"

// Register factory returning (T, error)
ioc.RegisterFactory("orderService", func(repo *OrderRepo) (*OrderService, error) {
    return &OrderService{Repo: repo}, nil
})

// Struct with field autowiring
type OrderController struct {
    Service  *OrderService           `spring:"orderService"`
    Provider ioc.Provider[*Billing]  `spring:"billingService"`
}

spring:
  datasource:
    driver: "mysql"
    url: "${DB_DSN}"
    auto-migrate: true
    health-check: true
  additional-datasources:
    readonly:
      driver: "mysql"
      url: "${DB_READONLY_DSN}"
      health-check: true

// POST: OnCreate validation
r.Post("/", web.Dispatch(c.create,
    web.WithRoles("ADMIN"),
    web.WithValidationGroup(web.OnCreate{}),
))

// PUT: OnUpdate validation
r.Put("/{id}", web.Dispatch(c.update,
    web.WithValidationGroup(web.OnUpdate{}),
))

scheduler.Schedule("daily-report", "0 2 * * *", generateReports,
    scheduler.WithLockAtMostFor(10*time.Minute),
    scheduler.WithLockAtLeastFor(30*time.Second),
)

found, err := s.cache.Get(ctx, "users:10", &user)
if !found {
    user, _ = s.repo.FindByID(ctx, 10)
    _ = s.cache.Set(ctx, "users:10", user, 15*time.Minute)
}