evmtools-node
Version:
このライブラリは、プライムブレインズ社で利用している「進捗管理ツール(Excel)」ファイルを読み込み、 プロジェクトの進捗状況や要員別の作業量を可視化するためのライブラリです。
261 lines (204 loc) • 34 kB
Markdown
<h1 align="center">Welcome to evmtools-node</h1>
<p>
<a href="#" target="_blank">
<img alt="License: ISC" src="https://img.shields.io/badge/License-ISC-yellow.svg" />
</a>
<a href="https://twitter.com/masatomix" target="_blank">
<img alt="Twitter: masatomix" src="https://img.shields.io/twitter/follow/masatomix.svg?style=social" />
</a>
</p>
このライブラリは、プライムブレインズ社で利用している「進捗管理ツール(Excel)」ファイルを読み込み、 プロジェクトの進捗状況や要員別の作業量を可視化するためのライブラリです。
WEBアプリ等で先のExcelファイルを読み書きできるように開発していますが、下記の通りコマンドラインから呼び出せるようにもしてあります。
```console
$ npx pbevm-show-project --help
Usage: npx pbevm-show-project [options]
Options:
--version Show version number [boolean]
--path Excel file Path [string] [default: "./now.xlsm"]
--help Show help [boolean]
Examples:
npx pbevm-show-project --path ./now.xlsm
```
例:
```console
$ npx pbevm-show-project --path ./now.xlsm
プロジェクト名: now
開始日: 2025/07/01
終了日: 2025/08/26
基準日: 2025/07/25
タスク数:19件
先頭19行データ:
┌─────────┬───────┬────┬───────┬──────────────┬───────────┬──────────┬──────────────┬───────────────────┬─────┬─────┬─────┬───────────┬───────────┬───────────┬────────┬──────────────┬──────────────┬──────────────┬──────────────┬──────────────┐
│ (index) │ sharp │ id │ level │ name │ assignee │ workload │ progressRate │ scheduledWorkDays │ pv │ ev │ spi │ delayDays │ remarks │ parentId │ isLeaf │ 予定開始日 │ 予定終了日 │ 実績開始日 │ 実績終了日 │ 進捗応当日 │
├─────────┼───────┼────┼───────┼──────────────┼───────────┼──────────┼──────────────┼───────────────────┼─────┼─────┼─────┼───────────┼───────────┼───────────┼────────┼──────────────┼──────────────┼──────────────┼──────────────┼──────────────┤
│ 0 │ 1 │ 1 │ 1 │ '要件定義' │ undefined │ 4 │ 1 │ 4 │ 4 │ 4 │ 1 │ undefined │ undefined │ undefined │ false │ '2025/07/01' │ '2025/07/04' │ '2025/07/01' │ '2025/07/04' │ '' │
│ 1 │ 2 │ 2 │ 2 │ '機能全体' │ '要員A' │ 4 │ 1 │ 4 │ 4 │ 4 │ 1 │ undefined │ undefined │ 1 │ true │ '2025/07/01' │ '2025/07/04' │ '2025/07/01' │ '2025/07/04' │ '' │
│ 2 │ 3 │ 3 │ 1 │ '設計' │ undefined │ 15 │ 1 │ 12 │ 15 │ 15 │ 1 │ undefined │ undefined │ undefined │ false │ '2025/07/07' │ '2025/07/18' │ '2025/07/04' │ '2025/07/16' │ '' │
│ 3 │ 4 │ 4 │ 2 │ '機能1' │ '要員A' │ 3 │ 1 │ 5 │ 3 │ 3 │ 1 │ undefined │ undefined │ 3 │ true │ '2025/07/07' │ '2025/07/11' │ '2025/07/07' │ '2025/07/11' │ '' │
│ 4 │ 5 │ 5 │ 2 │ '機能2' │ '要員A' │ 2 │ 1 │ 5 │ 2 │ 2 │ 1 │ undefined │ undefined │ 3 │ true │ '2025/07/07' │ '2025/07/11' │ '2025/07/04' │ '2025/07/10' │ '' │
│ 5 │ 6 │ 6 │ 2 │ '機能3' │ '要員B' │ 5 │ 1 │ 5 │ 5 │ 5 │ 1 │ undefined │ undefined │ 3 │ true │ '2025/07/14' │ '2025/07/18' │ '2025/07/04' │ '2025/07/10' │ '' │
│ 6 │ 7 │ 7 │ 2 │ '機能4' │ '要員A' │ 5 │ 1 │ 5 │ 5 │ 5 │ 1 │ undefined │ undefined │ 3 │ true │ '2025/07/14' │ '2025/07/18' │ '2025/07/14' │ '2025/07/16' │ '' │
│ 7 │ 8 │ 8 │ 1 │ '開発' │ undefined │ 30 │ 0.25 │ 12 │ 15 │ 7.5 │ 0.5 │ -2 │ undefined │ undefined │ false │ '2025/07/21' │ '2025/08/01' │ '2025/07/21' │ '' │ '2025/07/27' │
│ 8 │ 9 │ 9 │ 2 │ '機能1' │ '要員A' │ 10 │ 0.1 │ 10 │ 5 │ 1 │ 0.2 │ 3 │ undefined │ 8 │ true │ '2025/07/21' │ '2025/08/01' │ '2025/07/21' │ '' │ '2025/07/22' │
│ 9 │ 10 │ 10 │ 2 │ '機能2' │ '要員B' │ 5 │ 0.2 │ 10 │ 2.5 │ 1 │ 0.4 │ 2 │ undefined │ 8 │ true │ '2025/07/21' │ '2025/08/01' │ '2025/07/21' │ '' │ '2025/07/23' │
│ 10 │ 11 │ 11 │ 2 │ '機能3' │ '要員B' │ 5 │ 0.3 │ 10 │ 2.5 │ 1.5 │ 0.6 │ 1 │ undefined │ 8 │ true │ '2025/07/21' │ '2025/08/01' │ '2025/07/21' │ '' │ '2025/07/24' │
│ 11 │ 12 │ 12 │ 2 │ '機能4' │ '要員C' │ 10 │ 0.4 │ 10 │ 5 │ 4 │ 0.8 │ 0 │ undefined │ 8 │ true │ '2025/07/21' │ '2025/08/01' │ '2025/07/21' │ '' │ '2025/07/25' │
│ 12 │ 13 │ 13 │ 1 │ 'テスト' │ undefined │ 15 │ 0 │ 19 │ 0 │ 0 │ 0 │ undefined │ undefined │ undefined │ false │ '2025/08/04' │ '2025/08/22' │ '' │ '' │ '' │
│ 13 │ 14 │ 14 │ 2 │ '単体テスト' │ '要員A' │ 5 │ undefined │ 5 │ 0 │ 0 │ 0 │ undefined │ undefined │ 13 │ true │ '2025/08/04' │ '2025/08/08' │ '' │ '' │ '' │
│ 14 │ 15 │ 15 │ 2 │ '連結テスト' │ '要員A' │ 5 │ undefined │ 5 │ 0 │ 0 │ 0 │ undefined │ undefined │ 13 │ true │ '2025/08/11' │ '2025/08/15' │ '' │ '' │ '' │
│ 15 │ 16 │ 16 │ 2 │ '総合テスト' │ '要員A' │ 5 │ undefined │ 5 │ 0 │ 0 │ 0 │ undefined │ undefined │ 13 │ true │ '2025/08/18' │ '2025/08/22' │ '' │ '' │ '' │
│ 16 │ 17 │ 17 │ 1 │ 'リリース' │ undefined │ 2 │ 0 │ 2 │ 0 │ 0 │ 0 │ undefined │ undefined │ undefined │ false │ '2025/08/25' │ '2025/08/26' │ '' │ '' │ '' │
│ 17 │ 18 │ 18 │ 2 │ '準備' │ '要員C' │ 1 │ undefined │ 1 │ 0 │ 0 │ 0 │ undefined │ undefined │ 17 │ true │ '2025/08/25' │ '2025/08/25' │ '' │ '' │ '' │
│ 18 │ 19 │ 19 │ 2 │ '作業' │ '要員C' │ 1 │ undefined │ 1 │ 0 │ 0 │ 0 │ undefined │ undefined │ 17 │ true │ '2025/08/26' │ '2025/08/26' │ '' │ '' │ '' │
└─────────┴───────┴────┴───────┴──────────────┴───────────┴──────────┴──────────────┴───────────────────┴─────┴─────┴─────┴───────────┴───────────┴───────────┴────────┴──────────────┴──────────────┴──────────────┴──────────────┴──────────────┘
プロジェクト情報
┌─────────┬─────────────┬──────────────┬──────────────┬─────────────────┬────────────────────┬─────────────────────────┬─────────────────┬──────────────┬──────────────┬───────────────────┬─────────┬────────────────────┐
│ (index) │ projectName │ startDate │ endDate │ totalTasksCount │ totalWorkloadExcel │ totalWorkloadCalculated │ averageWorkload │ baseDate │ totalPvExcel │ totalPvCalculated │ totalEv │ spi │
├─────────┼─────────────┼──────────────┼──────────────┼─────────────────┼────────────────────┼─────────────────────────┼─────────────────┼──────────────┼──────────────┼───────────────────┼─────────┼────────────────────┤
│ 0 │ 'now' │ '2025/07/01' │ '2025/08/26' │ 14 │ 66 │ 66 │ 4.714 │ '2025/07/25' │ 34 │ 34 │ 26.5 │ 0.7794117647058824 │
└─────────┴─────────────┴──────────────┴──────────────┴─────────────────┴────────────────────┴─────────────────────────┴─────────────────┴──────────────┴──────────────┴───────────────────┴─────────┴────────────────────┘
要員ごと統計
┌─────────┬──────────┬─────────────────┬────────────────────┬─────────────────────────┬─────────────────┬──────────────┬──────────────┬───────────────────┬─────────┬────────────────────┐
│ (index) │ assignee │ totalTasksCount │ totalWorkloadExcel │ totalWorkloadCalculated │ averageWorkload │ baseDate │ totalPvExcel │ totalPvCalculated │ totalEv │ spi │
├─────────┼──────────┼─────────────────┼────────────────────┼─────────────────────────┼─────────────────┼──────────────┼──────────────┼───────────────────┼─────────┼────────────────────┤
│ 0 │ '要員A' │ 8 │ 39 │ 39 │ 4.875 │ '2025/07/25' │ 19 │ 19 │ 15 │ 0.7894736842105263 │
│ 1 │ '要員B' │ 3 │ 15 │ 15 │ 5 │ '2025/07/25' │ 10 │ 10 │ 7.5 │ 0.75 │
│ 2 │ '要員C' │ 3 │ 12 │ 12 │ 4 │ '2025/07/25' │ 5 │ 5 │ 4 │ 0.8 │
└─────────┴──────────┴─────────────────┴────────────────────┴─────────────────────────┴─────────────────┴──────────────┴──────────────┴───────────────────┴─────────┴────────────────────┘
$ ls -lrt
-rw-r--r-- 1 sysmgr sysmgr 468256 Jul 9 15:24 now.xlsm
-rw-r--r-- 1 sysmgr sysmgr 50950 Jul 11 16:00 now-summary.xlsx <-上記情報
$
```
```console
$ npx pbevm-show-pv --help
Usage: npx pbevm-show-pv [options]
Options:
--version Show version number [boolean]
--path Excel file Path [string] [default: "./now.xlsm"]
--fromDate From Date [string] [default: "2025-07-01"]
--toDate To Date [string]
--assignee Assignee [string]
--help Show help [boolean]
Examples:
npx pbevm-show-pv --path now.xlsm --fromDate 2025-07-07 --toDate 2025-07-11
--assignee '要員A'
```
例:
```
$ npx pbevm-show-pv --path now.xlsm \
--fromDate 2025-07-07 \
--toDate 2025-07-11 \
--assignee '要員A'
(toDate未指定時はfromDateの日のみ、assignee未指定時は全員)
┌─────────┬───────┬────┬───────┬─────────┬──────────┬──────────┬──────────────┬───────────────────┬────┬────┬─────┬───────────┬───────────┬──────────┬────────┬──────────────┬──────────────┬──────────────┬──────────────┬────────────┐
│ (index) │ sharp │ id │ level │ name │ assignee │ workload │ progressRate │ scheduledWorkDays │ pv │ ev │ spi │ delayDays │ remarks │ parentId │ isLeaf │ 予定開始日 │ 予定終了日 │ 実績開始日 │ 実績終了日 │ 進捗応当日 │
├─────────┼───────┼────┼───────┼─────────┼──────────┼──────────┼──────────────┼───────────────────┼────┼────┼─────┼───────────┼───────────┼──────────┼────────┼──────────────┼──────────────┼──────────────┼──────────────┼────────────┤
│ 0 │ 4 │ 4 │ 2 │ '機能1' │ '要員A' │ 3 │ 1 │ 5 │ 3 │ 3 │ 1 │ undefined │ undefined │ 3 │ true │ '2025/07/07' │ '2025/07/11' │ '2025/07/07' │ '2025/07/11' │ '' │
│ 1 │ 5 │ 5 │ 2 │ '機能2' │ '要員A' │ 2 │ 1 │ 5 │ 2 │ 2 │ 1 │ undefined │ undefined │ 3 │ true │ '2025/07/07' │ '2025/07/11' │ '2025/07/04' │ '2025/07/10' │ '' │
└─────────┴───────┴────┴───────┴─────────┴──────────┴──────────┴──────────────┴───────────────────┴────┴────┴─────┴───────────┴───────────┴──────────┴────────┴──────────────┴──────────────┴──────────────┴──────────────┴────────────┘
$ ls -lrt
-rw-r--r-- 1 sysmgr sysmgr 468256 Jul 9 15:24 now.xlsm
-rw-r--r-- 1 sysmgr sysmgr 7183 Jul 11 16:07 now-pv.xlsx
$
```
```
$ npx pbevm-diff --help
Usage: npx pbevm-diff [options]
Options:
--version Show version number [boolean]
--path Excel file Path [string] [default: "./now.xlsm"]
--prevPath Excel file Path [string] [default: "./prev.xlsm"]
--help Show help [boolean]
Examples:
npx pbevm-diff --path now.xlsm --prevPath prev.xlsm
```
例:
```
$ npx pbevm-diff \
--path now.xlsm \
--prevPath prev.xlsm
プロジェクトDiff
┌─────────┬─────────┬─────────┬────────┬────────┬───────────┬───────────┬───────────────┬────────────┬──────────────┬─────────┬──────────┐
│ (index) │ deltaPV │ deltaEV │ prevPV │ prevEV │ currentPV │ currentEV │ modifiedCount │ addedCount │ removedCount │ hasDiff │ finished │
├─────────┼─────────┼─────────┼────────┼────────┼───────────┼───────────┼───────────────┼────────────┼──────────────┼─────────┼──────────┤
│ 0 │ 30 │ 19.6 │ 0 │ 2.9 │ 30 │ 22.5 │ 8 │ 0 │ 0 │ true │ false │
└─────────┴─────────┴─────────┴────────┴────────┴───────────┴───────────┴───────────────┴────────────┴──────────────┴─────────┴──────────┘
担当Diff
┌─────────┬──────────┬─────────┬─────────┬────────┬────────┬───────────┬───────────┬───────────────┬────────────┬──────────────┬─────────┬──────────┐
│ (index) │ assignee │ deltaPV │ deltaEV │ prevPV │ prevEV │ currentPV │ currentEV │ modifiedCount │ addedCount │ removedCount │ hasDiff │ finished │
├─────────┼──────────┼─────────┼─────────┼────────┼────────┼───────────┼───────────┼───────────────┼────────────┼──────────────┼─────────┼──────────┤
│ 0 │ '要員A' │ 15 │ 10.6 │ 0 │ 0.4 │ 15 │ 11 │ 4 │ 0 │ 0 │ true │ false │
│ 1 │ '要員B' │ 10 │ 5 │ 0 │ 2.5 │ 10 │ 7.5 │ 3 │ 0 │ 0 │ true │ false │
│ 2 │ '要員C' │ 5 │ 4 │ 0 │ 0 │ 5 │ 4 │ 1 │ 0 │ 0 │ true │ false │
└─────────┴──────────┴─────────┴─────────┴────────┴────────┴───────────┴───────────┴───────────────┴────────────┴──────────────┴─────────┴──────────┘
タスクDiff
┌─────────┬────┬─────────┬──────────────┬──────────┬──────────┬───────────────────┬─────────┬─────────┬────────┬────────┬───────────┬───────────┬──────────────────┬─────────────────────┬─────────┬─────────────────────┬───────────┬───────────┬────────────┬──────────┬─────────────┬──────────────────────────┬──────────────────────────┬──────────────────────────┬───────────────┬──────────────────┬─────────────┬───────────┐
│ (index) │ id │ name │ fullName │ assignee │ parentId │ deltaProgressRate │ deltaPV │ deltaEV │ prevPV │ prevEV │ currentPV │ currentEV │ prevProgressRate │ currentProgressRate │ hasDiff │ hasProgressRateDiff │ hasPvDiff │ hasEvDiff │ diffType │ finished │ isOverdueAt │ prevBaseDate │ currentBaseDate │ baseDate │ daysOverdueAt │ daysStrOverdueAt │ currentTask │ prevTask │
├─────────┼────┼─────────┼──────────────┼──────────┼──────────┼───────────────────┼─────────┼─────────┼────────┼────────┼───────────┼───────────┼──────────────────┼─────────────────────┼─────────┼─────────────────────┼───────────┼───────────┼────────────┼──────────┼─────────────┼──────────────────────────┼──────────────────────────┼──────────────────────────┼───────────────┼──────────────────┼─────────────┼───────────┤
│ 0 │ 4 │ '機能1' │ '設計/機能1' │ '要員A' │ 3 │ 1 │ 3 │ 3 │ 0 │ 0 │ 3 │ 3 │ undefined │ 1 │ true │ true │ true │ true │ 'modified' │ true │ false │ 2025-07-03T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ -14 │ '14 日前' │ [TaskRow] │ [TaskRow] │
│ 1 │ 5 │ '機能2' │ '設計/機能2' │ '要員A' │ 3 │ 0.8 │ 2 │ 1.6 │ 0 │ 0.4 │ 2 │ 2 │ 0.2 │ 1 │ true │ true │ true │ true │ 'modified' │ true │ false │ 2025-07-03T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ -14 │ '14 日前' │ [TaskRow] │ [TaskRow] │
│ 2 │ 6 │ '機能3' │ '設計/機能3' │ '要員B' │ 3 │ 0.5 │ 5 │ 2.5 │ 0 │ 2.5 │ 5 │ 5 │ 0.5 │ 1 │ true │ true │ true │ true │ 'modified' │ true │ false │ 2025-07-03T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ -7 │ '7 日前' │ [TaskRow] │ [TaskRow] │
│ 3 │ 7 │ '機能4' │ '設計/機能4' │ '要員A' │ 3 │ 1 │ 5 │ 5 │ 0 │ 0 │ 5 │ 5 │ undefined │ 1 │ true │ true │ true │ true │ 'modified' │ true │ false │ 2025-07-03T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ -7 │ '7 日前' │ [TaskRow] │ [TaskRow] │
│ 4 │ 9 │ '機能1' │ '開発/機能1' │ '要員A' │ 8 │ 0.1 │ 5 │ 1 │ 0 │ 0 │ 5 │ 1 │ undefined │ 0.1 │ true │ true │ true │ true │ 'modified' │ false │ false │ 2025-07-03T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ 7 │ '7 日後' │ [TaskRow] │ [TaskRow] │
│ 5 │ 10 │ '機能2' │ '開発/機能2' │ '要員B' │ 8 │ 0.2 │ 2.5 │ 1 │ 0 │ 0 │ 2.5 │ 1 │ undefined │ 0.2 │ true │ true │ true │ true │ 'modified' │ false │ false │ 2025-07-03T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ 7 │ '7 日後' │ [TaskRow] │ [TaskRow] │
│ 6 │ 11 │ '機能3' │ '開発/機能3' │ '要員B' │ 8 │ 0.3 │ 2.5 │ 1.5 │ 0 │ 0 │ 2.5 │ 1.5 │ undefined │ 0.3 │ true │ true │ true │ true │ 'modified' │ false │ false │ 2025-07-03T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ 7 │ '7 日後' │ [TaskRow] │ [TaskRow] │
│ 7 │ 12 │ '機能4' │ '開発/機能4' │ '要員C' │ 8 │ 0.4 │ 5 │ 4 │ 0 │ 0 │ 5 │ 4 │ undefined │ 0.4 │ true │ true │ true │ true │ 'modified' │ false │ false │ 2025-07-03T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ 2025-07-24T15:00:00.000Z │ 7 │ '7 日後' │ [TaskRow] │ [TaskRow] │
└─────────┴────┴─────────┴──────────────┴──────────┴──────────┴───────────────────┴─────────┴─────────┴────────┴────────┴───────────┴───────────┴──────────────────┴─────────────────────┴─────────┴─────────────────────┴───────────┴───────────┴────────────┴──────────┴─────────────┴──────────────────────────┴──────────────────────────┴──────────────────────────┴───────────────┴──────────────────┴─────────────┴───────────┘
$ ls -lrt
-rw-r--r-- 1 sysmgr sysmgr 463539 Jul 9 15:24 prev.xlsm
-rw-r--r-- 1 sysmgr sysmgr 468256 Jul 9 15:24 now.xlsm
-rw-r--r-- 1 sysmgr sysmgr 15937 Jul 11 16:14 now-diff.xlsx
```
👤 **Masatomi KINO**
<!-- * Twitter: [@masatomix](https://twitter.com/masatomix) -->
* Github: [@masatomix](https://github.com/masatomix)
Contributions, issues and feature requests are welcome!<br />Feel free to check [issues page](https://github.com/masatomix/evmtools-node/issues).
Give a ⭐️ if this project helped you!
- 0.0.13 Diffのプロパティに工数(workload)を追加。
- 0.0.12 時系列の統計データを読み込む ProjectStatisticsCreator を追加。
- 0.0.11 指定した基準日のSPI/SV(EV-PV)を返すメソッドをTaskRowに追加。
- 0.0.10 内部処理の見直し(ログ関連)。
- 0.0.8 Projectに休日データを保持するプロパティを追加。Projectに日付を指定して祝日かを返すメソッドを追加。
- 0.0.7 内部のリファクタリング(キャッシュして処理改善)
- 0.0.6 README.md(このファイル)を更新。Project
- 0.0.5 初回リリース(絶賛開発中)
このライブラリは `pino` を使ってログを出力しています。
ログ出力レベルやフォーマットを変更したい場合は、``config/default.json`` を作成して設定を記述してください。
```json
{
"evmtools-node-logger": {
"level": "warn",
"moduleLogLevels": {
"main": "info"
},
"transport": {
"target": "pino-pretty",
"options": {
"translateTime": "SYS:standard",
"ignore": "id,hostname",
"levelFirst": true
}
}
}
}
```
```
"level": "warn", // 全体のログレベルを指定
"moduleLogLevels": // ソースごとにlevelを変えたい場合、この中に記述
"transport": // pino のtransport設定などを記述
"target": "pino-pretty", // この場合は npm install --save-dev pino-pretty すること
```
***
_This README was generated by [readme-md-generator](https://github.com/kefranabg/readme-md-generator)_