comentado código

core/errs/dispatcher.go

@@ -1,92 +0,0 @@
-// =============================================================================
-//  Active-GO Framework
-//  Copyright (c) 2025 ActiveThing (https://activething.com)
-//  Author: Juan V. Navarro juanvnl@activething.com
-// =============================================================================
-//
-//  Permission is hereby granted, free of charge, to any person obtaining a copy
-//  of this software and associated documentation files (the "Software"), to deal
-//  in the Software without restriction, including without limitation the rights
-//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-//  copies of the Software, and to permit persons to whom the Software is
-//  furnished to do so, subject to the following conditions:
-//
-//  The above copyright notice and this permission notice shall be included in
-//  all copies or substantial portions of the Software.
-//
-//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-//  THE SOFTWARE.
-//
-// =============================================================================
-// Date Create  19/05/2025
-// =============================================================================
-
-package errs
-
-import (
-	"fmt"
-	"sync"
-)
-
-type (
-
-	Dispatcher 		struct {
-		mu 			sync.RWMutex
-		processors 	map[string]Processor
-		formatters 	map[string]Formatter
-		bufferSize 	int
-
-		cacheMu 	sync.Mutex
-		cacheEnable map[string]struct{}
-		formatCache	map[string]map[uintptr][]byte
-	}
-
-	DispatcherFnc 	func (dispatcher *Dispatcher) error
-)
-
-
-func NewDispatcher(options ...DispatcherFnc) (*Dispatcher,error) {
-	dp := &Dispatcher{
-		processors : make(map[string]Processor),
-		formatters : make(map[string]Formatter),
-		formatCache: make(map[string]map[uintptr][]byte),
-		cacheEnable: make(map[string]struct{}),
-	}
-	for _,o := range options {
-		if e := o(dp); e != nil {
-			return nil,e
-		}
-	}
-	return dp,nil
-}
-
-
-func (d *Dispatcher) RegisterProcessor(processor Processor, options ...ProcessorEntryFnc) error {
-	d.mu.Lock()
-	defer d.mu.Unlock()
-
-	if processor == nil {
-		return CreateParamNilErr("processor")
-	}
-	if _,ex := d.formatters[processor.FormatterID()]; !ex {
-		//
-		//todo create newerror formatter_not_registered
-	}
-	if _,ex := d.processors[processor.ID()]; ex {
-		//
-		//todo create newerror processor_registered
-	}
-
-	pe,er := NewProcessorEntry(options...)
-	if er != nil {
-		return er
-	}
-	d.processors[processor.ID()] = pe
-
-	return nil
-}

go.work

@@ -1,8 +0,0 @@
-go 1.24
-
-use (
-	app
-	core
-	tests
-	.
-)

readme.md

@@ -0,0 +1,35 @@
+# **GOAT: Go Active Thing Framework**
+
+![GOAT Logo](/docs/img/goat-logo.png "GOAT")
+
+## **Bienvenido a GOAT** — **Go Active Thing Framework**.
+
+GOAT es un framework moderno y potente para el desarrollo de aplicaciones en Go, concebido para afrontar los retos más exigentes de los sistemas distribuidos y concurrentes actuales. Desde su núcleo, está diseñado para ofrecer una experiencia de desarrollo donde la **observabilidad**, la **resiliencia** y el **rendimiento extremo** no son añadidos, sino fundamentos.
+
+Con GOAT, no solo construyes sistemas que escalan: creas software que **respira con claridad**, **resiste con elegancia** y **corre con velocidad**. Es un framework nacido de la experiencia real en ActiveThing.com, donde lidiar con sistemas complejos es el día a día. GOAT no se limita a seguir buenas prácticas: las redefine con herramientas que van más allá de lo convencional.
+
+---
+
+## **🐐 Filosofía y Principios Fundamentales**
+
+En el corazón de GOAT está una convicción: la complejidad debe enfrentarse con diseño inteligente, no con capas de parches. Por eso se apoya en cinco pilares esenciales:
+
+- **Observabilidad sin fisuras:** Transforma errores y logs en datos estructurados y trazables, dándote visibilidad total para detectar, entender y solucionar cualquier anomalía.
+- **Resiliencia de fábrica:** Permite construir sistemas que absorben fallos, se adaptan y continúan funcionando con gracia ante lo inesperado.
+- **Rendimiento al límite:** Minimiza la presión sobre la memoria y el recolector de basura, alcanzando una eficiencia digna de entornos críticos.
+- **Composición flexible:** Ofrece componentes modulares y reutilizables que se adaptan a tu arquitectura, en lugar de imponer una.
+- **Claridad sin concesiones:** Favorece patrones idiomáticos de Go, priorizando la legibilidad, el mantenimiento y la colaboración.
+
+---
+
+## **🌟 Módulos Clave**
+
+GOAT se estructura en módulos especializados que abordan con precisión quirúrgica los aspectos críticos del desarrollo moderno...
+
+## **📜 Licencia**
+
+GOAT (Go Active Thing Framework) se distribuye bajo la **Licencia MIT**. Esto significa que tienes la libertad de usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y/o vender copias del software, siempre que incluyas el aviso de copyright y el permiso en todas las copias sustanciales.
+
+¡Esperamos sinceramente que GOAT te ayude a construir aplicaciones Go más **robustas, observables y eficientes**\!
+
+Copyright (c) 2025 ActiveThing (https://activething.com)  

src/core/logs/dispatcher.go

@@ -0,0 +1,203 @@
+// =============================================================================
+//  Active-GO Framework
+//  Copyright (c) 2025 ActiveThing (https://activething.com)
+//  Author: Juan V. Navarro juanvnl@activething.com
+// =============================================================================
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+//
+// =============================================================================
+// Date Create  19/05/2025
+// =============================================================================
+
+package logs
+
+import (
+	"context"
+	"core/errs"
+	"fmt"
+	"reflect"
+	"sync"
+)
+
+type (
+
+	Dispatcher 		struct {
+		mu 			sync.RWMutex
+		processors 	map[string]*ProcessorEntry
+		formatters 	map[string]errs.Formatter
+		bufferSize 	int
+
+		cacheMu      sync.Mutex
+		cacheEnabled map[string]struct{}
+		formatCache  map[string]map[uintptr][]byte
+
+		inputChan 	chan error
+		ctx 		context.Context
+		cancel 		context.CancelFunc
+		wg			sync.WaitGroup
+	}
+
+	DispatcherFnc 	func (dispatcher *Dispatcher) error
+)
+
+
+func NewDispatcher(options ...DispatcherFnc) (*Dispatcher,error) {
+	dp := &Dispatcher{
+		processors :  make(map[string]*ProcessorEntry),
+		formatters :  make(map[string]errs.Formatter),
+		formatCache:  make(map[string]map[uintptr][]byte),
+		cacheEnabled: make(map[string]struct{}),
+
+		inputChan  : make(chan error,100),
+	}
+	for _,o := range options {
+		if e := o(dp); e != nil {
+			return nil,e
+		}
+	}
+	return dp,nil
+}
+
+
+func (d *Dispatcher) Start () {
+	d.mu.Lock()
+	defer d.mu.Unlock()
+
+	if d.ctx != nil {
+		//todo
+		//panic dispatcher already started
+	}
+
+	d.ctx,d.cancel = context.WithCancel(context.Background())
+	d.wg.Add(1)
+	go d.run()
+
+	for _,entry := range d.processors {
+		d.wg.Add(1)
+		go d.processErrors(d.ctx, entry)
+	}
+}
+
+
+
+
+
+func (d *Dispatcher) RegisterProcessor(processor Processor, options ...ProcessorEntryFnc) error {
+	d.mu.Lock()
+	defer d.mu.Unlock()
+
+	if processor == nil {
+		return errs.CreateParamNilErr("processor")
+	}
+	if _,ex := d.formatters[processor.FormatterID()]; !ex {
+		//
+		//todo create newerror formatter_not_registered
+	}
+	if _,ex := d.processors[processor.ID()]; ex {
+		//
+		//todo create newerror processor_registered
+	}
+
+	pe,er := NewProcessorEntry(options...)
+	if er != nil {
+		return er
+	}
+	d.processors[processor.ID()] = pe
+
+	return nil
+}
+
+
+func (d *Dispatcher) processErrors (entry *ProcessorEntry) {
+	defer d.wg.Done()
+
+	for {
+
+		select {
+		case <- d.ctx.Done():
+			// todo existing
+			//
+		case er,ok := <-entry.channel:
+			if !ok {
+				// channel closed
+				return
+			}
+			fi := entry.Processor.FormatterID()
+
+		}
+	}
+}
+
+
+
+// getFormattedError retrieves the formatted error from the cache or formats it if not found.
+// It uses the dispatcher's formatters and cache.
+// This function is called by the processor's dedicated goroutine.
+func (d *Dispatcher) getFormattedError(err error, formatterID string) ([]byte, error) {
+	// Use the error's underlying value's pointer address as a unique identifier for this specific error instance.
+	// This is the correct and idiomatic way to get a stable ID for caching error instances.
+	errID := reflect.ValueOf(err).Pointer() // Using reflect.ValueOf().Pointer() for errID
+
+	// Check if caching is enabled for this formatter ID.
+	d.mu.RLock() // Use RLock to check cacheEnabled map
+	_, cachingEnabled := d.cacheEnabled[formatterID]
+	d.mu.RUnlock() // Release RLock
+
+	if cachingEnabled {
+		d.cacheMu.Lock() // Acquire cache lock to read from cache
+		// Check if the formatted error is already in the cache for this formatter ID and error.
+		if formatterCache, ok := d.formatCache[formatterID]; ok {
+			if formatted, ok := formatterCache[errID]; ok {
+				d.cacheMu.Unlock() // Release cache lock before returning
+				return formatted, nil // Found in cache
+			}
+		}
+		d.cacheMu.Unlock() // Release cache lock before accessing formatters (which require d.mu)
+	}
+
+	// Formatted error not in cache or caching is disabled, find the formatter and format it.
+	d.mu.RLock() // Need RLock to access the formatters map
+	formatter, exists := d.formatters[formatterID]
+	d.mu.RUnlock() // Release RLock
+
+	if !exists {
+		// This should ideally not happen if RegisterProcessor checks were sufficient,
+		// but handle defensively.
+		return nil, fmt.Errorf("formatter with ID '%s' not found", formatterID)
+	}
+
+	// Format the error using the found formatter.
+	formatted, formatErr := formatter.Format(err)
+	if formatErr != nil {
+		return nil, fmt.Errorf("failed to format error using formatter '%s': %w", formatterID, formatErr)
+	}
+
+	// Store the formatted error in the cache only if caching is enabled for this formatter.
+	if cachingEnabled {
+		d.cacheMu.Lock() // Acquire cache lock to write to cache
+		if _, ok := d.formatCache[formatterID]; !ok {
+			d.formatCache[formatterID] = make(map[uintptr][]byte)
+		}
+		d.formatCache[formatterID][errID] = formatted
+		d.cacheMu.Unlock() // Release cache lock after writing to cache
+	}
+
+	return formatted, nil
+}

src/core/logs/processor.go

@@ -26,7 +26,7 @@
 // Date Create  19/05/2025
 // =============================================================================
 
-package errs
+package logs
 
 
 type (

src/core/logs/processor_entry.go

@@ -26,14 +26,14 @@
 // Date Create  20/05/2025
 // =============================================================================
 
-package errs
+package logs
 
 import "time"
 
 type (
 
 	ProcessorEntry 	struct {
-		processor 	Processor
+		Processor
 		channel  chan error
 		state    ProcessorState
 		failures int

src/core/logs/processor_state.go

@@ -26,7 +26,7 @@
 // Date Create  19/05/2025
 // =============================================================================
 
-package errs
+package logs
 
 
 

src/go.work

@@ -0,0 +1,8 @@
+go 1.24
+
+use (
+	./app
+	./src/core
+	./src/tests
+	.
+)