README

此 Symfony 扩展包可以将 Scrum 项目的数据导入到您的应用程序中。

您可以从 Trello 看板（很快还将支持 Github、Gitlab 等其他看板）检索您的史诗和用户故事，然后按需使用！

例如，您可以在网站上显示项目的路线图或当前的冲刺工作。

安装

您可以使用 Composer 安装此项目

composer require kalaxia/scrumban-bundle

配置

启用此扩展包后，您可以使用以下 YAML 行进行配置

scrumban:
    trello:
        has_plus_for_trello: true # use PlusForTrello extension way to extract estimations data
        boards:
            kanban: # board name, use it as identifier for your scrumban commands
                id: 0DxDo8vl # the Trello ID of your board. You can configure it in an environment variable if you like
        columns: # Columns configuration override, more details below
            ready:
                name: 'sprint_ready'
                type: 'user_story'
                status: 'ready'
            review:
                name: 'to_validate'
                type: 'user_story'
                status: 'review'
            to_release:
                name: 'to_deploy'
                type: 'user_story'
                status: 'to_release'

列映射用于将卡片与特定的故事类型和状态关联。

• name 字段是您看板列的别名。
• 目前 type 只能是 user_story。以后，史诗、技术故事、错误和反馈也将可配置。
• status 可以是预配置的状态之一。请参阅下面的 状态 部分。

此扩展包包含一个默认映射，您可以选择扩展或覆盖它。

默认映射如下

ready:
    name: 'ready'
    type: 'user_story'
    status: 'ready'
todo:
    name: 'todo'
    type: 'user_story'
    status: 'todo'
in_progress:
    name: 'in_progress'
    type: 'user_story'
    status: 'in_progress'
review:
    name: 'review'
    type: 'user_story'
    status: 'review'
to_release:
    name: 'to_release'
    type: 'user_story'
    status: 'to_release'
done:
    name: 'done'
    type: 'user_story'
    status: 'done'

与看板同步

您可以使用以下命令（使用配置好的看板名称）导入用户故事

./bin/console scrumban:trello:sync kanban

它将更新数据库中现有的用户故事，并创建其他用户故事。

冲刺

此扩展包允许您创建冲刺，包括开始和结束日期、演示 URL 等数据，以后还将添加更多功能。

您可以使用扩展包命令

./bin/console scrumban:sprint:create --begin 2018-10-10 --end 2018-10-09

或直接在代码中实现管理器

// src/Controller/DefaultController.php

// ...
use Scrumban\Manager\SprintManager;

class DefaultController extends Controller
{
    public function createSprintAction(SprintManager $sprintManager, Request $request)
    {
        $beginDate = new \DateTime($request->request->get('begin_date'));
        $endDate = new \DateTime($request->request->get('end_date'));

        $sprint = $sprintManager->createSprint($beginDate, $endDate);
    }
}

如果冲刺有相同的日期，它们将发生冲突。在这种情况下将抛出异常。

当您同步看板时，与特定状态关联的列中的卡片将与您创建的当前冲刺关联（如果您创建了冲刺）。

默认状态如下

• todo
• in_progress
• review
• to_release

目前这不可覆盖，但将来将会实现。

贡献

如果您有任何问题、反馈、想法，或者在扩展包中发现一些错误，请不要犹豫，打开问题。

目前还比较新，显然还不完美，因此欢迎各种贡献（:-）！

释放开源社区的强大力量 :D！