turash/bugulma/backend/internal/graph/calculator.go
Damir Mukimov 000eab4740
Major repository reorganization and missing backend endpoints implementation
Repository Structure:
- Move files from cluttered root directory into organized structure
- Create archive/ for archived data and scraper results
- Create bugulma/ for the complete application (frontend + backend)
- Create data/ for sample datasets and reference materials
- Create docs/ for comprehensive documentation structure
- Create scripts/ for utility scripts and API tools

Backend Implementation:
- Implement 3 missing backend endpoints identified in gap analysis:
  * GET /api/v1/organizations/{id}/matching/direct - Direct symbiosis matches
  * GET /api/v1/users/me/organizations - User organizations
  * POST /api/v1/proposals/{id}/status - Update proposal status
- Add complete proposal domain model, repository, and service layers
- Create database migration for proposals table
- Fix CLI server command registration issue

API Documentation:
- Add comprehensive proposals.md API documentation
- Update README.md with Users and Proposals API sections
- Document all request/response formats, error codes, and business rules

Code Quality:
- Follow existing Go backend architecture patterns
- Add proper error handling and validation
- Match frontend expected response schemas
- Maintain clean separation of concerns (handler -> service -> repository)
2025-11-25 06:01:16 +01:00

93 lines
3.1 KiB
Go

package graph
import (
"context"
"bugulma/backend/internal/domain"
)
// Calculator is the main interface for graph operations
type Calculator interface {
// Resource chain operations
FindResourceChains(ctx context.Context, resourceType domain.ResourceType, maxLength int, minValue float64) ([]*ResourceChain, error)
// Symbiosis network operations
FindSymbiosisNetworks(ctx context.Context, minOrgs int, maxSize int) ([]*SymbiosisNetwork, error)
// Path finding operations
FindOptimalResourcePaths(ctx context.Context, sourceOrgID, targetOrgID string, resourceType domain.ResourceType, maxHops int) ([]*ResourceChain, error)
// Network analysis operations
AnalyzeNetworkCentrality(ctx context.Context) (map[string]*CentralityMetrics, error)
GetNetworkStatistics(ctx context.Context) (*NetworkStatistics, error)
FindCircularEconomyCycles(ctx context.Context) ([]*CircularEconomyCycle, error)
}
// GraphCalculator implements the Calculator interface with proper separation of concerns
type GraphCalculator struct {
config *Config
traversal *Traversal
pathFinder *PathFinder
networkAnalyzer *NetworkAnalyzer
}
// NewGraphCalculator creates a new graph calculator with all dependencies
func NewGraphCalculator(
config *Config,
traversal *Traversal,
pathFinder *PathFinder,
networkAnalyzer *NetworkAnalyzer,
) Calculator {
return &GraphCalculator{
config: config,
traversal: traversal,
pathFinder: pathFinder,
networkAnalyzer: networkAnalyzer,
}
}
// FindResourceChains finds chains of resource flows
func (gc *GraphCalculator) FindResourceChains(
ctx context.Context,
resourceType domain.ResourceType,
maxLength int,
minValue float64,
) ([]*ResourceChain, error) {
return gc.traversal.FindResourceChains(ctx, resourceType, maxLength, minValue)
}
// FindSymbiosisNetworks identifies interconnected industrial symbiosis networks
func (gc *GraphCalculator) FindSymbiosisNetworks(
ctx context.Context,
minOrgs int,
maxSize int,
) ([]*SymbiosisNetwork, error) {
return gc.traversal.FindSymbiosisNetworks(ctx, minOrgs, maxSize)
}
// FindOptimalResourcePaths finds the most cost-effective paths
func (gc *GraphCalculator) FindOptimalResourcePaths(
ctx context.Context,
sourceOrgID string,
targetOrgID string,
resourceType domain.ResourceType,
maxHops int,
) ([]*ResourceChain, error) {
return gc.pathFinder.FindOptimalResourcePaths(ctx, sourceOrgID, targetOrgID, resourceType, maxHops)
}
// AnalyzeNetworkCentrality calculates centrality measures
func (gc *GraphCalculator) AnalyzeNetworkCentrality(ctx context.Context) (map[string]*CentralityMetrics, error) {
return gc.networkAnalyzer.AnalyzeNetworkCentrality(ctx)
}
// GetNetworkStatistics provides overall network statistics
func (gc *GraphCalculator) GetNetworkStatistics(ctx context.Context) (*NetworkStatistics, error) {
return gc.networkAnalyzer.GetNetworkStatistics(ctx)
}
// FindCircularEconomyCycles finds circular resource flow cycles
func (gc *GraphCalculator) FindCircularEconomyCycles(ctx context.Context) ([]*CircularEconomyCycle, error) {
return gc.networkAnalyzer.FindCircularEconomyCycles(ctx)
}