apigo

Backend monolitico en Go para Muy del Campo.

La arquitectura actual del repo es:

• un solo ApiService en protobuf
• un solo servidor gRPC
• un solo nucleo de aplicacion en internal/app
• un borde de transporte en api/*

Estructura

• cmd/server
  • bootstrap principal
• api/okgrpc
  • borde gRPC
  • interceptors
  • auth del transporte
  • mapping de errores publicos
• internal/app
  • dominio
  • inputs y data internos
  • use cases
  • repositorio
  • errores semanticos
• internal/modules
  • infraestructura y clientes externos
• internal/platforms
  • config, logger, crypto, validacion y utilidades
• protobuf/def/v1
  • contrato protobuf
• protobuf/gen/v1
  • codigo generado

Contrato

El contrato externo se concentra en un unico service:

• ApiService

Regla actual:

• nuevos metodos gRPC se agregan al mismo ApiService
• el borde se implementa en api/okgrpc

Flujo interno

El patron actual del proyecto es:

gRPC -> api/okgrpc -> internal/app/UseService -> internal/app/Repository -> PostgreSQL

Dentro de internal/app el flujo preferido es:

input del transporte -> input interno -> data interna -> repository

Variables de entorno

Requeridas por confx.Load():

• ENV
• PORT
• WHATSAPP_TOKEN
• WHATSAPP_PHONE
• PG_DATABASE_URL

Opcional:

• GOOGLE_MAPS_API_KEY

Desarrollo local

Ejecutar:

make run

Eso carga .env y levanta cmd/server/main.go.

Protobuf

Generar Go:

make _gen_proto_v1

Generar Dart:

make _gen_proto_dart_v2

Deploy

El pipeline gRPC actual vive en:

• infrax/grpc/cloudbuild.yaml

Regla rapida para cambios

Si el cambio toca transporte:

• empieza en api/*

Si el cambio toca negocio, auth, usuarios o persistencia:

• empieza en internal/app

Si el cambio toca infraestructura:

• empieza en internal/modules/* o internal/platforms/*

Documentacion interna

• AGENTS.md
• plan.md
• requirements.md