Latest / ゆるITエンジニア道場 / #43 なぜSIerは設計書を作るのに、自社開発では作らないのか?
Transcript
- 0:00こ ん に ち は、 リ ド ル で す。 今 日 は X 上 で バ ズ っ て い た な ぜ sier
- 0:06で は ド キ ュ メ ン ト を 作 っ て、 自 社 開 発 企 業 で は ド キ ュ メ ン ト を 作 ら な い の
- 0:11か と い う こ と を 説 明 し た い と 思 い ま す。
- 0:14こ こ で 言 う ド キ ュ メ ン ト っ て い う の は 設 計 書 の こ と な ん で す け れ ど も、 確
- 0:19か に sier で は よ く 設 計 書 を 作 り ま す よ ね。
- 0:22ア プ リ だ っ た ら 基 本 設 計 詳 細 設 計 が あ っ て、 テ ス ト 仕 様 書 が あ っ て。
- 0:28で、 単 体 テ ス ト 仕 様 書 と か。 ま あ、 テ ス ト の 結 果 を 貼 り 付 け る エ ビ
- 0:32デ ン ス イ ン フ ラ で も 基 本 設 計 詳 細 設 計 パ ラ メ ー タ ー シ ー ト ネ ッ ト ワ ー ク
- 0:38構 成 図 加 電 表 配 線 表 ま あ、 い っ ぱ い あ り ま す よ ね。
- 0:44一方 で、 自 社 開 発 だ と そ う い っ た 類 の 設 計 書 を 作 る こ と は あ ま り あ り ま せ
- 0:50ん。 こ の 違 い に つ い て、 両 方 の 企 業 で 仕 事
- 0:53を し た こ と が あ る イ ド ル が 回 答 し た い と 思 い ま す。
- 0:56ま あ、 こ れ は 簡 単 で。 作 る 必 要 は な い か ら っ て だ け の 話 な
- 1:00ん で す け れ ど も、 そ も そ も な ぜ si ヤ ー は そ う い っ た 設 計 書 を 作 る の で し
- 1:05ょ う か。 こ れ は で す ね、 単 純 に 言 う と、 も と も
- 1:09と si ヤ ー っ て お 客 さ ん か ら こ う い う シ ス テ ム 作 っ て っ て 言 わ れ て 作 る も
- 1:12の な ん で す け ど、 そ の 際 に 定 期 的 に お 客 さ ん 側 か ら 確 認 が 入 る ん で す ね。
- 1:18ど う や っ て 確 認 す る か と い う と、 各 工 程 に お い て こ う い う も の を 作 っ て ほ
- 1:23し い っ て い う イ メ ー ジ が 一 致 し て る か ど う か。
- 1:26で、 そ の 一 致 し て い る か ど う か は、 設 計 書 を ベ ー ス に 判 断 さ れ る と い う 感
- 1:31じ な ん で す。 そ の た め、 設 計 書 を 作 ら な い と、 合 間、
- 1:35合 間 で ど う や っ て 作 る ん だ っ け? っ て い う 確 認 が お 互 い に 取 れ な い の
- 1:39で。 最 終 的 に 出 来 上 が っ た も の が 全 然 機
- 1:42体 と 違 う も の に な る っ て い う リ ス ク が あ る の で、 合 間 に 設 計 書 を 作 っ て レ
- 1:47ビ ュ ー し て 間 違 っ て な い で す よ ね っ て い う 感 じ で 進 め て い っ て い る と。
- 1:52い う も の に な り ま す。 ま た で す ね、 sier が 作 る シ ス テ ム の
- 1:55場 合 は 基 本 的 に 作 っ て 納 品 し て お し ま い っ て い う 感 じ に な る の で、 そ の 後
- 2:01の バ ー ジ ョ ン ア ッ プ だ っ た り、 更 新 と い う 作 業 は 別 の 費 用 を も ら わ な い 限
- 2:06り は 発 生 し な い ん で す よ ね。 要 す る に 作 り 切 り っ て い う こ と で す。
- 2:10そ う な る と、 そ の 時 点 の 設 計 書 っ て い う も の は、 そ の 時 に 作 っ た も の を 正 確
- 2:15に 反 映 し て い る の で 問 題 な い ん で す よ。
- 2:19で、 一方 で 自 社 開 発 企 業 の 場 合 だ と、 例 え ば サ ー ズ を 作 っ て そ こ か ら 収 益 を
- 2:25上 げ て い る 会 社 を 想 定 し ま す が、 最 初 に 作 っ た シ ス テ ム っ て 本 当 に ち っ ち
- 2:30ゃ い ん で す よ ね。 そ れ は 市 場 に ど う い う も の が フ ィ ッ
- 2:34ト す る か わ か ら な い の で、 ま ず 最 初 に 小 さ い も の を 作 っ て、 そ れ が 当 た れ ば
- 2:40も っ と い ろ ん な 機 能 を 足 し て い っ て、 ユ ー ザ ー に よ り 使 っ て も ら え た り と
- 2:44か、 ユ ー ザ ー に よ り 愛 さ れ る サ ー ビ ス に し て い こ う と い う よ う な。
- 2:49形 で や っ て い く の で、 最 初 に 作 っ た 設 計 と い う の は 徐 々 に 形 を 変 え て い っ
- 2:55た り、 な ん だ っ た ら まる っ と 作 り 直 す レ ベ ル で 変 わ る こ と も 珍 し く あ り ま
- 3:00せ ん。 そ う 考 え る と、 最 初 に 作 っ た タ イ ミ ン
- 3:04グ で 設 計 書 を 一 緒 に 作 っ て し ま う と、 設 計 書 の 更 新 も 必 要 に な り ま す し、 ま
- 3:09た サ ー ビ ス 自 体 が す ぐ ク ロ ー ズ す る 場 合 っ て、 設 計 書 を 作 っ た と こ ろ で 何
- 3:15の 意 味 も な く な っ ち ゃ う ん で す よ ね。 そ う 考 え る と。
- 3:18サ ー ビ ス の 成 長 と と も に だ ん だ ん 変 わ っ て い く も の で あ る に も か か わ ら
- 3:23ず、 設 計 書 と い う 全 然 変 わ ら な い も の。
- 3:26も ち ろ ん 更 新 す れ ば 変 わ っ て い き ま す け ど、 そ ち ら に も 更 新 コ ス ト が か か
- 3:31る わ け で。 っ て な っ て く る と、 別 に あ ん ま り 必 要
- 3:35な い よ ね と い っ た こ と が 挙 げ ら れ ま す。
- 3:37ま た、 そ も そ も で す ね、 自 社 開 発 企 業 で サ ー ビ ス を 作 る 際 の 普 通 の 流 れ と
- 3:42し て は、 プ ラ ン ナ ー と か PDM と か。 企 画 と 呼 ば れ る 人 は、 ま ず 仕 様 書 っ て
- 3:48も の を 作 り ま す。 こ う い う 機 能 を 足 し た い こ の 機 能 を
- 3:52こ う 変 え た い み た い な こ と を 書 い て あ る す ご い 詳 し い ド キ ュ メ ン ト で す
- 3:56ね。 こ れ は 設 計 書 で は な い で す。
- 3:59こ れ を ベ ー ス に、 例 え ば フ ロ ン ト エ ン ド だ っ た り、 モ バ イ ル の 修 正 が あ る 場
- 4:03合、 追 加 が あ る 場 合 は フ ィ グ マ な ど の ツ ー ル デ ザ イ ン ツ ー ル で こ う い う 画
- 4:08面 に し た い で す み た い な こ と を 認 識 合 わ せ ま す。
- 4:11今 挙 げ た よ う な 仕 様 書 と フ ィ グ マ に 関 し て は。
- 4:14サ ー ビ ス の 今 の 状 態 を 正 確 に 表 す も の な の で、 定 期 更 新 し て い き ま す。
- 4:21な の で、 育 て る ド キ ュ メ ン ト で す ね。 一方 で、 そ こ か ら 先 に 実 際 に そ れ を 実
- 4:26装 し よ う と い う フ ェ ー ズ に な る と。 ソ フ ト ウ ェ ア エ ン ジ ニ ア の 出 番 で し
- 4:29か な い の で、 PDM と か デ ザ イ ナ ー と か、 企 画 と い う メ ン バ ー は 一 切 そ ち ら
- 4:36に 関 し て は 関 与 し ま せ ん。 も と も と ソ フ ト ウ ェ ア エ ン ジ ニ ア 出
- 4:40身 の PDM と か だ っ た ら、 も し か し た ら 見 る か も し れ な い で す け ど も。
- 4:44基 本 的 に は 見 ま せ ん。 そ う な る と エ ン ジ ニ ア の 中 だ け で コ
- 4:49ミ ュ ニ ケ ー シ ョ ン が 取 れ れ ば 良 く な る の で、 か っ ち り と し た ド キ ュ メ ン ト
- 4:53を 作 る 必 要 は な く て。 例 え ば イ ン フ ラ で あ れ ば iac の 構 造
- 4:59だ っ た り、 ク バ ネ テ ス の マ ニ フ ェ ス ト さ え あ れ ば な ん と な く や っ て る こ と
- 5:03が わ か る し。 シ ス テ ム が 大 き く な っ て き て よ く わ
- 5:07か ん な い と き は、 シ ス テ ム の ネ ッ ト ワ ー ク の 構 成 図 み た い な も の を 書 い て
- 5:11運 用 す る こ と は あ り ま す け ど、 そ れ 以 上 に 細 か い も の。
- 5:14パ ラ メ ー タ ー シ ー ト と か は 作 ら な い で す。
- 5:17ま あ、 iac の コ ー ド が あ れ ば パ ラ メ ー タ ー シ ー ト と ほ ぼ 同 じ も の な の で、 二
- 5:22重 管 理 に な る と や や こ し い で す し、 管 理 コ ス ト も 増 え ま す し ね。
- 5:26ま た、 バ ッ ク エ ン ド だ っ た り フ ロ ン ト エ ン ド と い っ た も の に 関 し て も、 基 本
- 5:30的 に は 通 信 を す る 際 の オ ー プ ン。 ampi の ス キ ー マ と か プ ロ ト バ フ と
- 5:35か、 グ ラ フ ql の ス キ ー マ み た い な も の が あ れ ば、 ど う い う 通 信 を し て い る
- 5:39か は そ れ 見 れ ば 一 発 で わ か り ま す し、 バ ッ ク エ ン ド 側 の 中 の コ ー ド も。
- 5:44ま あ、 読 ん で し ま え ば、 こ の API は こ う い う ふ う に ア ク セ ス し て、 で デ ー タ
- 5:49ベ ー ス 問 い 合 わ せ る ん だ。 で、 デ ー タ ベ ー ス に ど う い う デ ー タ 入
- 5:52っ て る の か は ス キ ー マ 見 れ ば い い の で、 ま あ そ れ で わ か り ま す よ ね。
- 5:55で、 た ま に わ か ら な い も の と し て、 す ご い 複 雑 な シ ー ケ ン ス を た ど る よ う
- 6:00な 処 理 の 場 合、 例 え ば 複 数 の API を 叩 い て 初 め て 処 理 が 完 了 す る よ う な も
- 6:05の の 場 合 に 関 し て は、 シ ー ケ ン ス 図 を 作 っ て 管 理 す る こ と は あ り ま す。
- 6:10た だ や っ ぱ り。 そ れ が 正 し く 更 新 さ れ な い こ と も あ
- 6:14る の で、 最 近 で は も う コ ー ド を ベ ー ス に し て AI に 都 度 生 成 し て も ら う っ て
- 6:19方 が い い か も し れ ま せ ん ね。 フ ロ ン ト エ ン ド だ っ た り、 モ バ イ ル の
- 6:23場 合 で も、 基 本 的 に は フ ィ グ マ と か の デ ザ イ ン ツ ー ル の 方 に 完 成 形 の デ ザ
- 6:28イ ン が あ る の で、 基 本 的 に は そ ち ら が ベ ー ス に な り ま す。
- 6:32そ れ 以 外 の 設 計 に 関 し て は、 基 本 的 に コ ー ド を 見 ま し ょ う っ て 感 じ が 多 い
- 6:37で す か ね。 こ ち ら も ど ん ど ん 変 わ っ て い く も の
- 6:39な の で。 基 本 的 に ド キ ュ メ ン ト リ ー 管 理 す る
- 6:43こ と は あ り ま せ ん。 た だ で す ね、 ADR と い う ア ー キ テ ク チ
- 6:47ャ ー の 決 定 を ロ グ に 残 そ う と い う よ う な 考 え 方 が あ り ま し て。
- 6:52な ぜ グ ー グ ル ク ラ ウ ド を 選 ん だ の か。 AWS じ ゃ な く と か、 な ん で こ う い う ア
- 6:58ー キ テ ク チ ャ に し た ん だ ろ う っ て い う。
- 6:59私 た ち が そ の 決 断 に 至 っ た 理 由 み た い な も の に 関 し て は、 ど こ か に 残 し て
- 7:05お か な い と、 次 回 以 降、 あ れ、 実 は AWS で い い ん じ ゃ ね?
- 7:09み た い な。 話 が で き た 時 に い や、 実 は 過 去 の 経 緯
- 7:13で っ て い う 説 明 が で き な く な っ て し ま う の で、 そ う い っ た も の は GitHub
- 7:17で 管 理 す る チ ー ム 結 構 あ り ま す。 な の で、 ア ー キ テ ク チ ャ ー デ ィ シ ジ ョ
- 7:21ン レ コ ー ド で す か ね。 こ れ に つ い て は 管 理 し ま す し、 ま た
- 7:25API の 新 規 の 作 成 だ っ た り、 更 新、 ま た ク ラ イ ア ン ト と の い ろ ん な 連 携 の
- 7:31際 に 複 雑 に な り そ う な 場 合 は、 私 が 参 加 し て い た チ ー ム だ と GitHub の デ ィ
- 7:37ス カ ッ シ ョ ン み た い な と こ ろ で。 今 回 は こ う い う 設 計 で い き ま し ょ う
- 7:40み た い な テ ン ポ ラ リ ー の ド キ ュ メ ン ト を 作 っ て、 認 識 合 わ せ を し た 上 で 実
- 7:45装 す る と い う こ と を や っ て い ま し た。 た だ、 そ こ の ド キ ュ メ ン ト に つ い て
- 7:49は、 そ の 瞬 間 に 利 用 す る も の で、 終 わ っ た ら 別 に 更 新 し な い も の に な り ま
- 7:54す よ ね。 ど っ ち か っ て い う と、 こ れ を 決 め る の
- 7:57に い ろ ん な 設 計 を 考 え て ど れ に し よ う か な と い う 話 な の で、 最 終 的 に 決 ま
- 8:01っ た も の は 行 動 を 見 れ ば い い よ ね っ て い う 感 じ が 多 い で す ね。
- 8:06は い。 ま と め る と、 エ サ ヤ ー で ド キ ュ メ ン ト
- 8:09を 作 る 理 由 は、 お 客 様 と の 認 識 合 わ せ の た め っ て い う の と、 納 品 を す る の
- 8:15で、 そ の 瞬 間 の こ と が 正 し く 設 計 書 に 落 と し 込 み か ら と い う こ と で し た。
- 8:21ま た で す ね。 自 社 企 業 の 場 合 は、 そ も そ も 自 分 た ち
- 8:25が ど ん ど ん ど ん ど ん シ ス テ ム を ア ッ プ デ ー ト し て い っ た り、 改 善 し て い っ
- 8:29た り す る の で、 そ こ に ド キ ュ メ ン ト と い う も の が 相 性 が 悪 い と い う こ と と、
- 8:33ま あ、 あ と コ ー ド ベ ー ス を 見 れ ば 最 悪 判 断 で き る の で。
- 8:36な く て も 問 題 な い と い っ た と こ ろ で し た。
- 8:38そ う い っ た よ う な 商 慣 習 の 違 い が ド キ ュ メ ン ト を 作 る 作 ら な い 問 題 の ま
- 8:43あ 厳 正 に な っ て い る か な と。 こ ち ら も 働 い た 経 験 と し て 思 い ま す。
- 8:48は い、 こ の ポ ッ ド キ ャ ス ト は ハ ッ シ ュ タ グ い る IT で 皆 様 か ら の コ メ ン ト や
- 8:52ご 意 見 募 集 し て お り ま す。 ま た、 動 画 や エ ピ ソ ー ド の 概 要 欄 か ら
- 8:57グ ー グ ル フ ォ ー ム の リ ン ク も あ り ま す の で、 そ ち ら か ら の ご 意 見 ご 感 想 も
- 9:01い た だ け る と 大 変 嬉 し い で す。 あ り が と う ご ざ い ま し た。