d03232c85c
Some checks failed
Veza CI / Backend (Go) (push) Failing after 0s
Veza CI / Frontend (Web) (push) Failing after 0s
Veza CI / Rust (Stream Server) (push) Failing after 0s
Security Scan / Secret Scanning (gitleaks) (push) Failing after 0s
Veza CI / Notify on failure (push) Failing after 0s
Phase 0 of the MinIO upload migration (FUNCTIONAL_AUDIT §4 item 2).
Schema + config only — Phase 1 will wire TrackService.UploadTrack()
to actually route writes to S3 when the flag is flipped.
Schema (migration 985):
- tracks.storage_backend VARCHAR(16) NOT NULL DEFAULT 'local'
CHECK in ('local', 's3')
- tracks.storage_key VARCHAR(512) NULL (S3 object key when backend=s3)
- Partial index on storage_backend = 's3' (migration progress queries)
- Rollback drops both columns + index; safe only while all rows are
still 'local' (guard query in the rollback comment)
Go model (internal/models/track.go):
- StorageBackend string (default 'local', not null)
- StorageKey *string (nullable)
- Both tagged json:"-" — internal plumbing, never exposed publicly
Config (internal/config/config.go):
- New field Config.TrackStorageBackend
- Read from TRACK_STORAGE_BACKEND env var (default 'local')
- Production validation rule #11 (ValidateForEnvironment):
- Must be 'local' or 's3' (reject typos like 'S3' or 'minio')
- If 's3', requires AWS_S3_ENABLED=true (fail fast, do not boot with
TrackStorageBackend=s3 while S3StorageService is nil)
- Dev/staging warns and falls back to 'local' instead of fail — keeps
iteration fast while still flagging misconfig.
Docs:
- docs/ENV_VARIABLES.md §13 restructured as "HLS + track storage backend"
with a migration playbook (local → s3 → migrate-storage CLI)
- docs/ENV_VARIABLES.md §28 validation rules: +2 entries for new rules
- docs/ENV_VARIABLES.md §29 drift findings: TRACK_STORAGE_BACKEND added
to "missing from template" list before it was fixed
- veza-backend-api/.env.template: TRACK_STORAGE_BACKEND=local with
comment pointing at Phase 1/2/3 plans
No behavior change yet — TrackService.UploadTrack() still hardcodes the
local path via copyFileAsync(). Phase 1 wires it.
Refs:
- AUDIT_REPORT.md §9 item (deferrals v1.0.8)
- FUNCTIONAL_AUDIT.md §4 item 2 "Stockage local disque only"
- /home/senke/.claude/plans/audit-fonctionnel-wild-hickey.md Item 3
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
74 lines
4.4 KiB
Go
74 lines
4.4 KiB
Go
package models
|
|
|
|
import (
|
|
"time"
|
|
|
|
"github.com/google/uuid"
|
|
"github.com/lib/pq"
|
|
"gorm.io/gorm"
|
|
)
|
|
|
|
// Track représente une piste audio dans le système
|
|
// MIGRATION UUID: Completée. ID et UserID sont des UUIDs.
|
|
type Track struct {
|
|
ID uuid.UUID `gorm:"type:uuid;primaryKey" json:"id" db:"id"`
|
|
UserID uuid.UUID `gorm:"type:uuid;not null;column:creator_id" json:"creator_id" db:"creator_id"`
|
|
FileID *uuid.UUID `gorm:"type:uuid" json:"file_id,omitempty" db:"file_id"` // NULL temporairement avant création fichier
|
|
Title string `gorm:"not null;size:255" json:"title" db:"title"`
|
|
Artist string `gorm:"size:255" json:"artist" db:"artist"`
|
|
Album string `gorm:"size:255" json:"album" db:"album"`
|
|
Duration int `gorm:"not null" json:"duration" db:"duration"` // seconds
|
|
Genre string `gorm:"size:100" json:"genre" db:"genre"`
|
|
Tags pq.StringArray `gorm:"type:text[]" json:"tags,omitempty" db:"tags"`
|
|
Year int `gorm:"default:0" json:"year" db:"year"`
|
|
BPM *int `gorm:"column:bpm" json:"bpm,omitempty" db:"bpm"`
|
|
MusicalKey string `gorm:"size:10" json:"musical_key,omitempty" db:"musical_key"`
|
|
FilePath string `gorm:"not null;size:500" json:"file_path" db:"file_path"`
|
|
FileSize int64 `gorm:"not null" json:"file_size" db:"file_size"` // bytes
|
|
Format string `gorm:"size:10" json:"format" db:"format"` // mp3, flac, wav, etc.
|
|
Bitrate int `gorm:"default:0" json:"bitrate" db:"bitrate"` // kbps
|
|
SampleRate int `gorm:"default:0" json:"sample_rate" db:"sample_rate"` // Hz
|
|
WaveformPath string `gorm:"size:500" json:"waveform_path" db:"waveform_path"`
|
|
WaveformURL *string `gorm:"size:500" json:"waveform_url,omitempty" db:"waveform_url"`
|
|
CoverArtPath string `gorm:"size:500" json:"cover_art_path" db:"cover_art_path"`
|
|
IsPublic bool `gorm:"default:true" json:"is_public" db:"is_public"`
|
|
Status TrackStatus `gorm:"default:'uploading'" json:"status" db:"status"`
|
|
StatusMessage string `gorm:"type:text" json:"status_message,omitempty" db:"status_message"`
|
|
StreamStatus string `gorm:"default:'pending'" json:"stream_status" db:"stream_status"` // pending, processing, ready, error
|
|
StreamManifestURL string `gorm:"size:500" json:"stream_manifest_url" db:"stream_manifest_url"`
|
|
// v1.0.8 Phase 0 — multi-backend storage. Schema added in migration 985.
|
|
// Values: "local" (default, file_path is the local FS path) or "s3"
|
|
// (storage_key is the S3/MinIO object key inside config.S3Bucket).
|
|
// Hidden from JSON responses — internal plumbing only.
|
|
StorageBackend string `gorm:"size:16;default:'local';not null" json:"-" db:"storage_backend"`
|
|
StorageKey *string `gorm:"size:512" json:"-" db:"storage_key"`
|
|
// SECURITY(CRIT-002): play_count and like_count are PRIVATE — visible only to the creator
|
|
// in their analytics dashboard. Never exposed in public API responses.
|
|
// Ref: CLAUDE.md rule #4, ORIGIN_UI_UX_SYSTEM.md §13
|
|
PlayCount int64 `gorm:"default:0" json:"-" db:"play_count"`
|
|
LikeCount int64 `gorm:"default:0" json:"-" db:"like_count"`
|
|
CreatedAt time.Time `gorm:"autoCreateTime" json:"created_at" db:"created_at"`
|
|
UpdatedAt time.Time `gorm:"autoUpdateTime" json:"updated_at" db:"updated_at"`
|
|
DeletedAt gorm.DeletedAt `json:"-" db:"deleted_at"`
|
|
|
|
// Relations
|
|
User User `gorm:"foreignKey:UserID;constraint:OnDelete:CASCADE" json:"-"`
|
|
Playlists []Playlist `gorm:"many2many:playlist_tracks;" json:"-"`
|
|
Likes []TrackLike `gorm:"foreignKey:TrackID;constraint:OnDelete:CASCADE" json:"-"`
|
|
Shares []TrackShare `gorm:"foreignKey:TrackID;constraint:OnDelete:CASCADE" json:"-"`
|
|
Versions []TrackVersion `gorm:"foreignKey:TrackID;constraint:OnDelete:CASCADE" json:"-"`
|
|
HLSStreams []HLSStream `gorm:"foreignKey:TrackID;constraint:OnDelete:CASCADE" json:"-"`
|
|
}
|
|
|
|
// TableName définit le nom de la table pour GORM
|
|
func (Track) TableName() string {
|
|
return "tracks"
|
|
}
|
|
|
|
// BeforeCreate hook GORM pour générer UUID si non défini
|
|
func (m *Track) BeforeCreate(tx *gorm.DB) error {
|
|
if m.ID == uuid.Nil {
|
|
m.ID = uuid.New()
|
|
}
|
|
return nil
|
|
}
|