turash/bugulma/backend/internal/domain/resource_flow_version.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

44 lines
1.6 KiB
Go

package domain
import (
"context"
"time"
"gorm.io/datatypes"
)
// ResourceFlowVersion represents versioned snapshots of resource flows for temporal tracking
// This enables MRV (Monitoring, Reporting, Verification) compliance and historical analysis
type ResourceFlowVersion struct {
ID string `gorm:"primaryKey;type:text"`
ResourceFlowID string `gorm:"type:text;not null;index:idx_rfv_flow_version"`
VersionNumber int `gorm:"type:integer;not null;index:idx_rfv_flow_version"`
// Change tracking
Changes datatypes.JSON `gorm:"type:jsonb;not null"` // What changed (JSON diff)
ChangedBy string `gorm:"type:text"` // User ID who made the change
ChangeReason string `gorm:"type:text"` // Why the change was made
// Validity period
ValidFrom time.Time `gorm:"type:timestamp with time zone;not null;default:now()"`
ValidTo *time.Time `gorm:"type:timestamp with time zone"` // NULL means current version
// Timestamps
CreatedAt time.Time `gorm:"autoCreateTime;index"`
// Associations
ResourceFlow *ResourceFlow `gorm:"foreignKey:ResourceFlowID"`
}
// TableName specifies the table name for GORM
func (ResourceFlowVersion) TableName() string {
return "resource_flow_versions"
}
type ResourceFlowVersionRepository interface {
Create(ctx context.Context, version *ResourceFlowVersion) error
GetByResourceFlowID(ctx context.Context, flowID string) ([]*ResourceFlowVersion, error)
GetVersionAtTime(ctx context.Context, flowID string, timestamp time.Time) (*ResourceFlowVersion, error)
GetCurrentVersion(ctx context.Context, flowID string) (*ResourceFlowVersion, error)
}