web

type Check struct {
	Text string `json:"text"`
	Done bool   `json:"done"`
}

type Epic struct {
	Name        string   `json:"name"`
	Title       string   `json:"title"`
	Description string   `json:"description"`
	Body        string   `json:"body"`
	Text        string   `json:"text"`
	Done        int      `json:"done"`
	Total       int      `json:"total"`
	Tickets     []Ticket `json:"tickets"`
}

type EpicEdit struct {
	Title       *string     `json:"title"`
	Description *string     `json:"description"`
	Body        *string     `json:"body"`
	Base        *EpicFields `json:"base"`
}

type EpicFields struct {
	Title       string `json:"title"`
	Description string `json:"description"`
	Body        string `json:"body"`
}

type Lane struct {
	ID   string `json:"id"`
	Name string `json:"name"`
	Kind string `json:"kind"`
}

type Note struct {
	At     time.Time `json:"at"`
	Author string    `json:"author"`
	Text   string    `json:"text"`
}

type Rejection struct {
	Kind string    `json:"kind"`
	Why  string    `json:"why"`
	By   string    `json:"by,omitzero"`
	At   time.Time `json:"at,omitzero"`
}

type Server struct {
	Source Source
	// Fetch brings the remote's refs into this clone; Push sends what Assign
	// queued. Either may be nil on a board with no remote.
	Fetch func() error
	Push  func() error
	// Log records every error answer, failed fetch or push, and panic, with
	// its time and cause. nil records nothing.
	Log *log.Logger
	// contains filtered or unexported fields
}

type Source interface {
	Epics() ([]Epic, error)
	// Unassigned is the open tickets in no epic; with all set, every ticket
	// in no epic that ever was — finished, logged and archived ones too.
	Unassigned(all bool) ([]Ticket, error)
	Ticket(id string) (TicketDetail, error)
	Lanes() ([]Lane, error)
	CreateEpic(name, title, description string) error
	SetEpic(name string, edit EpicEdit) error
	// Assign puts a ticket into epic; with from set it takes it out of that
	// epic as well, which is a move.
	Assign(epic, from, ticketID string) error
	Unassign(epic, ticketID string) error
}

type Sync struct {
	LastFetch  time.Time `json:"last_fetch,omitzero"`
	FetchError string    `json:"fetch_error,omitzero"`
	LastPush   time.Time `json:"last_push,omitzero"`
	PushError  string    `json:"push_error,omitzero"`
}

type Ticket struct {
	ID     string `json:"id"`
	Handle string `json:"handle"`
	Title  string `json:"title"`
	Lane   string `json:"lane"`
	Done   bool   `json:"done"`
	// Direct is false for a ticket that belongs to an epic only because it
	// follows, or is a child of, one of its members.
	Direct bool `json:"direct"`
	// Place is where the ticket lies: board, ref, logbook or archive. A
	// filed ticket is shown, never dragged.
	Place string `json:"place"`
	// The fields the page filters by.
	Goal      string    `json:"goal,omitzero"`
	Tags      []string  `json:"tags,omitempty"`
	Creator   string    `json:"creator,omitzero"`
	Assignee  string    `json:"assignee,omitzero"`
	UpdatedBy string    `json:"updated_by,omitzero"`
	CreatedAt time.Time `json:"created_at,omitzero"`
	UpdatedAt time.Time `json:"updated_at,omitzero"`
	// FiledAt is the day it left the board: the logbook folder's date, or
	// for the archive the day it was rejected. Zero when nobody knows.
	FiledAt time.Time `json:"filed_at,omitzero"`
	// Rejected is the kind of no, for a ticket 'jaira reject' archived.
	Rejected string `json:"rejected,omitzero"`
}

type TicketDetail struct {
	ID      string  `json:"id"`
	Handle  string  `json:"handle"`
	Title   string  `json:"title"`
	Lane    string  `json:"lane"`
	Place   string  `json:"place"`
	Goal    string  `json:"goal"`
	Context string  `json:"context"`
	DoD     []Check `json:"dod"`
	Notes   []Note  `json:"notes"`
	// Rejected is nil for a ticket that was never rejected.
	Rejected *Rejection `json:"rejected,omitempty"`
}