store

type DetailView map[string][]*FinishedEntry

type DistView map[string][]*FinishedEntry

type EffortsView map[string]time.Duration

type FinishedEntry struct {
	*UnfinishedEntry
	End time.Time
}

type Store interface {
	// Start an entry.
	//  1. No new entry allowed if there is already an ongoing (unfinished) entry exists.
	//  2. Entry considered as duplicated and is not allowed to start,
	//     if there is already an entry with the same Title and Start.
	Start(*UnfinishedEntry) error

	// StartTitle starts an entry with given title and notes, and 'now' as Start.
	StartTitle(title, note string) error

	// Finish finishes the unfinished entry (if any).
	// If there was one, return it's title.
	// If no unfinished entry to finish, return empty string. This case is not treated as error.
	Finish(notes string) (string, error)

	// RecentTitles returns at most 'limit' number of distinct titles of recent finished entries.
	RecentTitles(limit uint8) ([]string, error)

	// Ongoing returns the ongoing entry (if any), otherwise return nil.
	Ongoing() (*UnfinishedEntry, error)

	// LastFinished returns the finished entry with the latest Start of given title, if any. Otherwise return nil.
	LastFinished(title string) (*FinishedEntry, error)

	// Finished queries entries with condition 'Start >= queryStart and Start <= queryEnd'.
	// Both queryStart and queryEnd must be UTC time
	// If 'titles' is not nil, only returns entries with 'title in titles'.
	Finished(queryStart, queryEnd time.Time, titles []string) ([]FinishedEntry, error)
}

type SummaryView map[string]map[string]time.Duration

type UnfinishedEntry struct {
	Title string
	Start time.Time
	Notes string
}