ticketnumber

type AutoIncrement ¶

type AutoIncrement struct {
	// contains filtered or unexported fields
}

func NewAutoIncrement(cfg Config) *AutoIncrement

func (g *AutoIncrement) IsDateBased() bool

func (g *AutoIncrement) Name() string

func (g *AutoIncrement) Next(ctx context.Context, store CounterStore) (string, error)

type Clock ¶

type Clock interface{ Now() TimeParts }

Clock allows deterministic testing.

type Config ¶

type Config struct {
	SystemID                string
	MinCounterSize          int
	DateUseFormattedCounter bool
}

Config needed by generators.

type CounterStore ¶

type CounterStore interface {
	// Add returns next counter given offset (>=1).
	Add(ctx context.Context, dateScoped bool, offset int64) (int64, error)
}

CounterStore abstraction over ticket_number_counter algorithm.

type DBStore ¶

type DBStore struct {
	// contains filtered or unexported fields
}

We maintain exactly one row per counter_uid and atomically increment using dialect specific UPSERT:

Postgres: INSERT ... ON CONFLICT(counter_uid) DO UPDATE SET counter = ticket_number_counter.counter + EXCLUDED.counter RETURNING counter
MySQL: INSERT ... ON DUPLICATE KEY UPDATE counter = LAST_INSERT_ID(counter + VALUES(counter)); SELECT LAST_INSERT_ID()

dateScoped controls daily UID suffix (YYYYMMDD) for date-based generators.

func NewDBStore(db *sql.DB, systemID string) *DBStore

func (s *DBStore) Add(ctx context.Context, dateScoped bool, offset int64) (int64, error)

type Date ¶

type Date struct {
	// contains filtered or unexported fields
}

func NewDate(cfg Config, clk Clock) *Date

func (g *Date) IsDateBased() bool

func (g *Date) Name() string

func (g *Date) Next(ctx context.Context, store CounterStore) (string, error)

type DateChecksum ¶

type DateChecksum struct {
	// contains filtered or unexported fields
}

DateChecksum: yyyymmdd + SystemID + zero-padded counter (min 5) + single check digit. Check digit: sum over digits with multipliers 1,2,1,2... ; sum each product directly; checksum = 10 - (sum % 10); if result == 10 => 1.

func NewDateChecksum(cfg Config, clk Clock) *DateChecksum

func (g *DateChecksum) IsDateBased() bool

func (g *DateChecksum) Name() string

func (g *DateChecksum) Next(ctx context.Context, store CounterStore) (string, error)

type Generator ¶

type Generator interface {
	Name() string
	Next(ctx context.Context, store CounterStore) (string, error)
	IsDateBased() bool
}

Generator defines contract for ticket number generators.

func Resolve(name string, systemID string, clk Clock) (Generator, error)

type Random ¶

type Random struct {
	// contains filtered or unexported fields
}

Random generator: SystemID + 8 random digits (collision resolved by retry via store if needed).

func NewRandom(cfg Config, seed int64) *Random

func (g *Random) IsDateBased() bool

func (g *Random) Name() string

func (g *Random) Next(ctx context.Context, store CounterStore) (string, error)

type SetupResult ¶

type SetupResult struct {
	Generator Generator
	SystemID  string
	Name      string
}

func SetupFromConfig(configDir string) SetupResult

type TimeParts ¶

type TimeParts struct {
	Year  int
	Month int
	Day   int
}

TimeParts minimal date parts.