statements

type BillingPeriod struct {
	From string `json:"from"`
	To   string `json:"to"`
}

type BuildResult struct {
	// Statements holds one entry per project that gets a document, sorted by
	// Key.
	Statements []Statement
	// Unregistered holds one entry per project id no registry row matched,
	// sorted by cloud and then by project id.
	Unregistered []UnregisteredProject
}

type Document struct {
	BillingPeriod BillingPeriod `json:"billing_period"`
	ProjectID     string        `json:"project_id"`
	Platform      string        `json:"platform"`
	LineItems     []LineItem    `json:"line_items"`
	RelatedCosts  []RelatedCost `json:"related_costs"`
	// BaseCost is what the line items and the related costs add up to before
	// the adjustments, NetCost what they come to after them, and KickbackTotal
	// what a partner is owed beside the net cost rather than as part of it. The
	// four members are nil on a statement no adjustment reached, whose bytes
	// hold none of them. Total is the net cost where they are there, which is
	// what the customer pays.
	//
	// None of them carries a currency of its own: every amount in the document
	// is in the currency Currency names, the way Total already renders.
	BaseCost      *money.Amount      `json:"base_cost,omitempty"`
	Adjustments   []adjustments.Line `json:"adjustments,omitempty"`
	NetCost       *money.Amount      `json:"net_cost,omitempty"`
	KickbackTotal *money.Amount      `json:"kickback_total,omitempty"`
	Total         money.Amount       `json:"total"`
	Currency      string             `json:"currency"`
}

type LineItem struct {
	ResourceType string       `json:"resource_type"`
	ResourceID   string       `json:"resource_id"`
	Platform     string       `json:"platform"`
	Description  string       `json:"description"`
	Periods      []Period     `json:"periods"`
	Total        money.Amount `json:"total"`
}

type Period struct {
	State         string                    `json:"state"`
	Hours         money.Amount              `json:"hours"`
	Usage         map[string]money.Quantity `json:"usage"`
	Cost          map[string]money.Amount   `json:"cost"`
	StateModifier money.Quantity            `json:"state_modifier"`
}

type RelatedCost struct {
	RelationType string       `json:"relation_type"`
	ProjectID    string       `json:"project_id"`
	Platform     string       `json:"platform"`
	LineItems    []LineItem   `json:"line_items"`
	Total        money.Amount `json:"total"`
}

type Statement struct {
	// Key is what the statement is stored under: the cloud and the external id
	// of its project, each percent-escaped and joined by a slash. External ids
	// are unique per cloud only, which is why the cloud is part of the key. It
	// is a database key rather than a file name.
	//
	// Neither half is constrained against the separator, which is why both are
	// escaped: os-prod paired with eu/acme would otherwise render what
	// os-prod/eu paired with acme does, and the two projects would meet on the
	// unique key over (run_id, project_id) with nothing but a duplicate-key
	// error to say which pairs produced it. Escaped, every pair renders a key no
	// other pair does.
	Key string
	// Document is the rendered document, marshalled once here. Go marshals a map
	// with its keys sorted, so the same input yields the same bytes.
	Document []byte
	// Total is the document's total, the same decimal the document shows.
	Total decimal.Decimal
	// Currency is the currency of the model the period was rated with.
	Currency string
	// Adjustments holds the adjustment lines the document shows, which the run
	// stores as the statement's adjustment records. It is nil on a statement no
	// adjustment reached.
	Adjustments []adjustments.Line
}

type UnregisteredProject struct {
	Cloud     string `json:"cloud"`
	ProjectID string `json:"project_id"`
	Resources int    `json:"resources"`
}