High-Performance gRPC

syntax = "proto3";

package justkalm.valuation.v1;

import "google/protobuf/timestamp.proto";
import "google/protobuf/wrappers.proto";

option go_package = "github.com/justkalm/api-go/valuation/v1";

// ValuationService provides luxury goods valuation
service ValuationService {
  // Get a single valuation by ID
  rpc GetValuation(GetValuationRequest) returns (Valuation);
  
  // Create a new valuation request
  rpc CreateValuation(CreateValuationRequest) returns (Valuation);
  
  // Stream products for batch valuation
  rpc BatchValuate(stream BatchValuateRequest) returns (BatchValuateResponse);
  
  // Subscribe to real-time valuation updates
  rpc WatchValuations(WatchValuationsRequest) returns (stream Valuation);
}

message Valuation {
  string id = 1;
  string sku = 2;
  PriceRange estimated_value = 3;
  Confidence confidence = 4;
  repeated Factor factors = 5;
  google.protobuf.Timestamp created_at = 6;
}

message PriceRange {
  int64 min_cents = 1;
  int64 max_cents = 2;
  string currency = 3;
}

enum Confidence {
  CONFIDENCE_UNSPECIFIED = 0;
  CONFIDENCE_HIGH = 1;
  CONFIDENCE_MEDIUM = 2;
  CONFIDENCE_LOW = 3;
}

message Factor {
  string name = 1;
  double impact = 2;
  string description = 3;
}

message GetValuationRequest {
  string id = 1;
}

message CreateValuationRequest {
  string sku = 1;
  string brand = 2;
  string category = 3;
  Condition condition = 4;
  repeated string materials = 5;
}

enum Condition {
  CONDITION_UNSPECIFIED = 0;
  CONDITION_NEW = 1;
  CONDITION_LIKE_NEW = 2;
  CONDITION_EXCELLENT = 3;
  CONDITION_GOOD = 4;
  CONDITION_FAIR = 5;
}