server/graph/schema/log.gql

"""
A log is a chunk of logged work, on one or more issues.
"""
type Log {
    "The log's ID."
    id: String!
    "When the log is taking place."
    date: Time!
    "A description of the log."
    description: String!

    "The user that logged the work."
    user: User!
    "The tasks logged."
    tasks: [LogTask!]!
    "The items changed."
    items: [LogItem!]!
}

type LogTask {
    "Parent issue of the task."
    issue: Issue!
    "The issue task logged."
    task: IssueTask!
    "How many units of work is done, if applicable."
    units: Int
    "Time spent on the issue."
    duration: Duration!
}

"""
Log items are item changes related to a log.
"""
type LogItem {
    "Parent issue of the item."
    issue: Issue!
    "The item that has been acquired."
    item: IssueItem!
    "The amount of items acquired."
    amount: Int!
}

"Filter for the logs query."
input LogFilter {
    "Log IDs to select."
    logIds: [String!]
    "Limit to the user IDs."
    userIds: [String!]
    "The issue IDs to limit to."
    issueIds: [String!]
    "The issue task IDs to limit to."
    issueTaskIds: [String!]
    "The issue item IDs to limit to."
    issueItemIds: [String!]
    "Earliest date to get logs from (inclusive)."
    fromDate: Time
    "Latest date to get logs from (inclusive)."
    toDate: Time
}

"Input for the createLog mutation."
input LogCreateInput {
    "When did it take place."
    date: Time!
    "Describe the logged work."
    description: String!

    "Add issue items to the log."
    items: [LogItemInput!]
    "Add issue tasks to the log."
    tasks: [LogTaskInput!]
}

"Input for the editLog mutation."
input LogEditInput {
    "The log to update."
    logId: String!

    "Update the time of the log."
    setDate: Time
    "Update the description of the log."
    setDescription: String

    "Add/update one or more items to the log."
    updateItems: [LogItemInput!]
    "Remove one or more items from the log."
    removeItems: [String!]
    "Add/update one or more items to the log."
    updateTasks: [LogTaskInput!]
    "Remove one or more items from the log."
    removeTasks: [String!]
}

"Sub-input for the createLog and editLog mutation."
input LogItemInput {
    "The issue item to log ID."
    issueItemId: String!
    "The amount of items acquired."
    amount: Int!
}

"Sub-input for the createLog and editLog mutation."
input LogTaskInput {
    "The issue item to log ID."
    issueTaskId: String!
    "The amount of units done, if applicable."
    units: Int
    "How long did it take?"
    duration: Duration!
}