path: root/app/class/issue.class.php

<?php

/*
 * SCROTT IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 * IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 * OTHER DEALINGS IN THE SOFTWARE.
 *
 * For more information, please refer to UNLICENSE
 */

require_once "class/object.class.php";
require_once "class/stage.class.php";
require_once "class/user.class.php";
require_once "class/mesg.class.php";

/*
 * This class models Scrott issues.  Issues represent units of work, can
 * be assigned to users, and advance through a pipeline.
 */
class issue extends object
{
    /*
     * Constructor
     */
    public function __construct(?string $guid = NULL)
    {
        $this->fields['issues'] = array(
            "guid",
            "numb",
            "assignee",
            "seen",
            "description",
            "due",
            "tags",
        );

        parent::__construct($guid);
        $this->expectType("issue");
    }

    /*
     * Initialize a new issue object with the given name, parent, and
     * owner.
     */
    public static function initNew(string $name, user $owner, stage $parent) : issue
    {
        $pad = $parent->getParent();
        $numb = $pad->issueNumb++;
        $pad->saveObj();

        $issue = new issue();
        $issue->setOwner($owner);
        $issue->setParent($parent);
        $issue->name = $name;
        $issue->objtype = "issue";
        $issue->numb = $numb;
        $issue->saveObj();
        return $issue;
    }

    /*
     * Get the assignee for this issue
     */
    public function getAssignee() : ?user
    {
        if (!isset($this->assignee) || $this->assignee == "")
            return NULL;

        return new user($this->assignee);
    }

    /*
     * Reset the seen flag and reassign this issue.
     */
    public function assignTo(user $assignee) : void
    {
        $this->seen = 0;
        $this->assignee = $assignee->guid;
        $this->saveObj();
    }

    /*
     * Get the pad this issue exists under
     */
    public function getPad() : pad
    {
        $parent = $this->getParent();

        if ($parent->objtype == "pad")
            return $parent;

        return $parent->getParent();
    }

    /*
     * Advance this issue in the pipeline, closing it if already in the
     * last stage.
     */
    public function advance() : void
    {
        $stage = $this->getParent();

        if ($stage->objtype != "stage")
            return;

        if (!($next = $stage->getNext()))
            $this->close();
        else
            $this->setParent($next);
    }

    /*
     * Mark this issue as completed and closed.
     */
    public function close() : void
    {
        $pad = $this->getParent()->getParent();

        if ($pad)
            $this->setParent($pad);
    }
}

?>