新規サービスのWebAPI開発でスキーマ駆動開発を目指してみた話

by shibadog1121

Slide 1

Slide 1 text

৽نαʔϏεͷ8FC"1*։ൃͰ εΩʔϚۦಈ։ൃΛ໨ࢦͯ͠Έͨ࿩ !TIJCBEPH ᓎҪوԝ

Slide 2

Slide 2 text

ࣗݾ঺հ ᓎҪوԝ !TIJCBEPH ɾ೥݄೔͔ΒϝυϐΞࣾһ ɾ৽نࣄۀΛ୲౰͢ΔνʔϜͷΤϯδχΞ ɾ3BJMT7VFKT ɾ͸͡Ίͯͷ-5ొஃ

Slide 3

Slide 3 text

αʔϏε঺հ ʮLBLBSJʯ ױऀ͞ΜͷϦϐʔλʔԽΛ໨ࢦ͢ௐࡎༀہΛࢧԉ

Slide 4

Slide 4 text

LBLBSJͷఏڙՁ஋ ɾνϟοτ૬ஊ ɾ͓஌ΒͤҰ੪ૹ৴ FUD ɾॲํͤΜૹ৴ ɾళ಄νΣοΫΠϯ ɾࣄલ໰਍

Slide 5

Slide 5 text

େ͖ͳస׵ͷ࣌ظΛܴ͍͑ͯΔௐࡎༀہۀք ױऀ͞Μͷༀہ બఆཧ༝ ڝ૪ཁҼ ໳લༀہ පӃͷۙ͘Ͱศར ཱ஍͕த৺ ͳ͡ΈͷༀہͰ҆৺ ༀہػೳༀࡎࢣͷ࣭ࡏݿྔ FUD ͔͔Γ͚ͭༀہ පӃ ॲํͤΜ ༀہ ༀہ ॲํͤΜ පӃ ॲํͤΜͷԠधͷେ൒͕ ໨ͷલͷපӃɾΫϦχοΫ ༷ʑͳҩྍػ͔ؔΒ ॲํͤΜΛԠध͢Δༀہ ͜Ε·Ͱ ͜Ε͔Β

Slide 6

Slide 6 text

ༀہۀքͷಈ͖Λݟӽͯ͠ͲΜͲΜػೳ։ൃத

Slide 7

Slide 7 text

ༀہ༻8FCը໘ ױऀ༻ϞόΠϧΞϓϦ

Slide 8

Slide 8 text

LBLBSJͷ։ൃମ੍ 8FCϑϩϯτΤϯδχΞ ϞόΠϧΞϓϦΤϯδχΞ αʔόʔαΠυΤϯδχΞ º º º

Slide 9

Slide 9 text

8F`SFIJSJOH

Slide 10

Slide 10 text

͍ͭͰʹ

Slide 11

Slide 11 text

ༀہܦӦऀͷํ΋୳͍ͯ͠·͢

Slide 12

Slide 12 text

ΞδΣϯμ εΩʔϚۦಈΛ໨ࢦ͢ཧ༝ 0QFO"1*ͱ͸ ͳʹ͕Ͱ͖Δͷ͔ LBLBSJͷ"1*։ൃ ·ͱΊ

Slide 13

Slide 13 text

εΩʔϚۦಈ։ൃΛ໨ࢦ͢ཧ༝

Slide 14

Slide 14 text

8FC"1*։ൃ͸೉͍͠ εΩʔϚۦಈ։ൃΛ໨ࢦ͢ཧ༝

Slide 15

Slide 15 text

8FC"1*։ൃγʔϯ εΩʔϚۦಈ։ൃΛ໨ࢦ͢ཧ༝ υΩϡϝϯτͷϝϯς͞Εͯͳͯͭ͘Β͍ͷਤ よっしゃ開発するぜ ΫϥΠΞϯταΠυͪΌΜ 定義通りに実装したのに動かん αʔόʔαΠυ͘Μ 資料更新するの忘れてた

Slide 16

Slide 16 text

8FC"1*։ൃγʔϯ εΩʔϚۦಈ։ൃΛ໨ࢦ͢ཧ༝ ɾυΩϡϝϯτ௨ΓͷϨεϙϯεΛظ଴࣮ͯ͠૷ͨ͠ͷʹಈ͔ͳ͍ ɾυΩϡϝϯτ͡Όͳͯ͘ɺ࣮૷ݟͯͱ͔ݴΘΕΔ ɾͱ͸͍͑υΩϡϝϯτΛϝϯς͢Δͷ໘౗͍͘͞

Slide 17

Slide 17 text

8FC"1*։ൃγʔϯ εΩʔϚۦಈ։ൃΛ໨ࢦ͢ཧ༝ ΫϥΠΞϯταΠυ։ൃελʔτͰ͖ͳͯ͘ਏ͍ͷਤ αʔόʔαΠυ͘Μ よっしゃAPI開発するぜやばい思ったより時間かかりそう ΫϥΠΞϯταΠυͪΌΜ テトリスして待ってるわ

Slide 18

Slide 18 text

8FC"1*։ൃγʔϯ εΩʔϚۦಈ։ൃΛ໨ࢦ͢ཧ༝ ɾαʔόʔαΠυͷ࣮૷͕ऴΘΔ·ͰΫϥΠΞϯταΠυ͸଴ػ ɾΫϥΠΞϯταΠυ͔Βͷ'#͕஗͘ͳΔͷͰख໭Γίετ͕େ ɾؤு࣮ͬͯ૷ͨ͠෦෼͕࣮͸ෆཁͩͬͨΈ͍ͨͳ͜ͱ͕ى͖ͯ൵͍͠

Slide 19

Slide 19 text

8FC"1*։ൃͷେ໰୊ εΩʔϚۦಈ։ൃΛ໨ࢦ͢ཧ༝ υΩϡϝϯτͱ࣮૷͕ဃ཭ ฒྻͰ։ൃΛਐΊΒΕͣɺ։ൃޮ཰্͕͕Βͳ͍

Slide 20

Slide 20 text

8FC"1*։ൃͭΒ͍ εΩʔϚۦಈ։ൃΛ໨ࢦ͢ཧ༝

Slide 21

Slide 21 text

ͦΜͳ͋ͳͨʹ εΩʔϚۦಈ։ൃΛ໨ࢦ͢ཧ༝ εΩʔϚۦಈ։ൃ

Slide 22

Slide 22 text

εΩʔϚۦಈ։ൃͱ͸ ɾ޾ͤʹ"1*։ൃΛߦ͍ͬͯ͘͜ͱΛ໨ࢦͨ͠։ൃख๏ ɾ"1*هड़ݴޠ˞Λ༻͍ͯεΩʔϚ ʹ"1*ఆٛ Λදݱ ɾεΩʔϚ͔ΒυΩϡϝϯτɾίʔυΛγεςϚςΟοΫʹࣗಈੜ੒ ˞0QFO"1*"1*#MVF1SJOU3".-౳͕͋Δ εΩʔϚۦಈ։ൃΛ໨ࢦ͢ཧ༝

Slide 23

Slide 23 text

εΩʔϚۦಈ։ൃΛ໨ࢦ͢ཧ༝ ਐΊํͷΠϝʔδ ΫϥΠΞϯταΠυ αʔόʔαΠυ "1*ఆٛΛ ҰॹʹܾΊΔ ϞοΫͷఏڙ ࣮૷ ࣮૷ ݁߹ςετ ϦϦʔε ૣ͍λΠϛϯάͰ ૬ޓ'#

Slide 24

Slide 24 text

΍ͬͯΈ͍ͨ εΩʔϚۦಈ։ൃΛ໨ࢦ͢ཧ༝

Slide 25

Slide 25 text

0QFO"1*ͱ͸ ͳͥ࢖͏ͷ͔

Slide 26

Slide 26 text

0QFO"1*ͱ͸ ɾ8FC"1*ͷεΩʔϚΛهड़͢ΔͨΊͷϑΥʔϚοτ KTPOZBNMܗࣜ ɾ0QFO"1**OJUJBUJWFͱ͍͏ஂମ (PPHMF.JDSPTPGU*#.౳͕ࢀՃ ͕ਪ ਐ͍ͯ͠Δ ɾ΋ͱ΋ͱ͸ʮ4XBHHFSʯ˞ ೥ʹ0QFO"1*΁ϦωʔϜ͞Εͨ 0QFO"1*ͱ͸ ͳͥ࢖͏ͷ͔ ˞͜ͷ໊࢒Ͱ0QFO"1*ͷपลπʔϧͷ໊લʹ4XBHHFS͕࢒͍ͬͯͨΓ͢Δ IUUQTXXXPQFOBQJTPSH

Slide 27

Slide 27 text

0QFO"1*ͱ͸ ͳͥ࢖͏ͷ͔ IUUQTHJUIVCDPN0"*0QFO"1*4QFDJGJDBUJPOCMPCNBTUFSFYBNQMFTWQFUTUPSFZBNM ΤϯυϙΠϯτͷύ ε )551ϝιου ظ଴͞ΕΔϨεϙϯε ϦΫΤετύϥϝʔλʔ

Slide 28

Slide 28 text

पลπʔϧ͕ڧྗ εΩʔϚͷڞ༗ɾ֬ೝָ͕ʹͰ͖Δ 0QFO"1*ͱ͸ ͳͥ࢖͏ͷ͔ ˠεΩʔϚۦಈ։ൃʹॏཁͳཁૉ͕ଗ͍ͬͯΔ εΩʔϚ͔ΒίʔυΛࣗಈੜ੒ εΩʔϚͷฤूָ͕ʹͰ͖Δ IUUQTHJUIVCDPN0QFO"1*5PPMT PQFOBQJHFOFSBUPS IUUQTFEJUPSTXBHHFSJP IUUQTTXBHHFSJPUPPMTTXBHHFSVJ

Slide 29

Slide 29 text

ΫϥΠΞϯταΠυ αʔόʔαΠυ "1*ఆٛΛ ҰॹʹܾΊΔ ϞοΫͷఏڙ ࣮૷ ࣮૷ ݁߹ςετ ϦϦʔε 0QFO"1*ͱ͸ ͳͥ࢖͏ͷ͔ εΩʔϚͷڞ༗ɾ֬ೝָ͕ʹͰ͖Δ εΩʔϚ͔ΒίʔυΛࣗಈੜ੒ εΩʔϚͷฤूָ͕ʹͰ͖Δ

Slide 30

Slide 30 text

࢖ͬͯΈ͍ͨ εΩʔϚۦಈ։ൃΛ໨ࢦ͢ཧ༝

Slide 31

Slide 31 text

LBLBSJͷ"1*։ൃ

Slide 32

Slide 32 text

8FC"1*։ൃͷେ໰୊ υΩϡϝϯτͱ࣮૷͕ဃ཭ ฒྻͰ։ൃΛਐΊΒΕͣɺ։ൃޮ཰্͕͕Βͳ͍ LBLBSJͷ"1*։ൃ

Slide 33

Slide 33 text

8FC"1*։ൃͷେ໰୊ υΩϡϝϯτͱ࣮૷͕ဃ཭ ฒྻͰ։ൃΛਐΊΒΕͣɺ։ൃޮ཰্͕͕Βͳ͍ LBLBSJͷ"1*։ൃ

Slide 34

Slide 34 text

υΩϡϝϯτͱ࣮૷ͷဃ཭Λ๷͙ LBLBSJͷ"1*։ൃ ࡞ઓ"1*ϦΫΤετΛεΩʔϚ௨Γʹ͢Δ εΩʔϚ͔ΒΫϥΠΞϯτϥΠϒϥϦΛࣗಈੜ੒ ࡞ઓ"1*ϨεϙϯεΛεΩʔϚ௨Γʹ͢Δ εΩʔϚ௨Γͷܗࣜʹͳ͍ͬͯΔ͔ࣗಈςετͰνΣοΫ

Slide 35

Slide 35 text

υΩϡϝϯτͱ࣮૷ͷဃ཭Λ๷͙ ϦΫΤετฤ LBLBSJͷ"1*։ൃ ΫϥΠΞϯτϥΠϒϥϦΛ0QFO"1*(FOFSBUPSͰࣗಈੜ੒ ࣗಈੜ੒ͷ࢓૊Έ͸$*ʹऔΓࠐΜͰ͍Δ ˠεΩʔϚͷߋ৽ʹࣗಈͰ௥ਵ ίʔυ͚ͩͰ͸ͳ͘ɺϝιουͷҰཡ౳ ͷυΩϡϝϯτ΋Ұॹʹࣗಈੜ੒͞ΕΔ

Slide 36

Slide 36 text

LBLBSJͷ"1*։ൃ ΫϥΠΞϯταΠυ͸ ࣗಈੜ੒͞ΕͨϥΠϒϥϦͷϝιουΛୟ͚ͩ͘

Slide 37

Slide 37 text

LBLBSJͷ"1*։ൃ υΩϡϝϯτͱ࣮૷ͷဃ཭Λ๷͙ Ϩεϙϯεฤ ɾʮDPNNJUUFFʯͱ͍͏HFNΛಋೖ https://github.com/interagent/committee ɾ"1*ϦΫΤετɾϨεϙϯε͕εΩʔϚ௨Γ͔νΣοΫͰ͖Δ ɾϨεϙϯεͷςετͰBTTFSU@TDIFNB@DPOGPSNΛݺͿ͚ͩͰ͍͍

Slide 38

Slide 38 text

ɾܕνΣοΫ ɾSFRVJSFE υΩϡϝϯτͱ࣮૷ͷဃ཭Λ๷͙ Ϩεϙϯεฤ LBLBSJͷ"1*։ൃ

Slide 39

Slide 39 text

ɾOVMMBCMF ɾFOVN υΩϡϝϯτͱ࣮૷ͷဃ཭Λ๷͙ Ϩεϙϯεฤ LBLBSJͷ"1*։ൃ

Slide 40

Slide 40 text

ɾBEEJUJPOBM1SPQFSUJFT εΩʔϚʹఆٛ͞Ε͍ͯͳ͍QSPQFSUZ ͕Ϩεϙϯεʹؚ·Ε͍ͯͳ͍͔Ͳ͏ ͔νΣοΫͰ͖Δ υΩϡϝϯτͱ࣮૷ͷဃ཭Λ๷͙ Ϩεϙϯεฤ LBLBSJͷ"1*։ൃ

Slide 41

Slide 41 text

8FC"1*։ൃͷେ໰୊ υΩϡϝϯτͱ࣮૷͕ဃ཭ ฒྻͰ։ൃΛਐΊΒΕͣɺ։ൃޮ཰্͕͕Βͳ͍ LBLBSJͷ"1*։ൃ

Slide 42

Slide 42 text

ΫϥΠΞϯταΠυ αʔόʔαΠυ "1*ఆٛΛ ҰॹʹܾΊΔ ϞοΫͷఏڙ ࣮૷ ࣮૷ ݁߹ςετ ϦϦʔε ૣ͍λΠϛϯάͰ ૬ޓ'# ฒྻͰ։ൃΛਐΊͯޮ཰Λ্͛Δ LBLBSJͷ"1*։ൃ ͜ͷ෦෼ΛͲ͏΍ͬͯਐΊΔ͔

Slide 43

Slide 43 text

ฒྻͰ։ൃΛਐΊͯޮ཰Λ্͛Δ LBLBSJͷ"1*։ൃ ࡞ઓϞοΫΛૉૣ͘ఏڙ͢Δ 4XBHHFS6*ͷFYBNQMFΛར༻͢Δ ࡞ઓ"1*ఆٛͷڞ༗Λ؆୯ʹ TXBHHFSWJFXFSͱ͍͏$ISPNF֦ுΛར༻͢Δ

Slide 44

Slide 44 text

ϞοΫΛૉૣ͘ఏڙ͢Δ LBLBSJͷ"1*։ൃ ࣗಈੜ੒͞ΕΔFYBNQMFΛجʹ଎߈ͰϞοΫͷ࣮૷͕Ͱ͖Δ ίϐϖ͚ͨͩ͠ͰϞοΫͷ࣮૷͕׬ྃ 4XBHHFS6*Ͱࣗಈੜ੒͞Εͨ FYBNQMF

Slide 45

Slide 45 text

LBLBSJͷ"1*։ൃ ɾ޻਺Λ͔͚ͣʹϞοΫΛఏڙ˞ ɾૣ͍λΠϛϯάͰΫϥΠΞϯταΠυ͔Βͷ'#͕ಘΒΕΔͷͰ मਖ਼ίετ͕௿͍ ˞0QFO"1*(FOFSBUPSΛ༻͍ͯϞοΫαʔόʔΛఏڙ͢Δํ๏΋͋ΔͷͰ͕͢ɺϞοΫ༻ͷίϯςφ্ཱͪ͛ ΔΑ͏ʹͨ͠ΓΫϥΠΞϯταΠυͷ޲͚ઌΛม͑ͨΓͱ໘౗ͦ͏͔ͳͱࢥ͍ͬͯ·͢ɻ஌ݟٻΉʂ ϞοΫΛૉૣ͘ఏڙ͢Δ

Slide 46

Slide 46 text

ΫϥΠΞϯταΠυ αʔόʔαΠυ "1*ఆٛΛ ҰॹʹܾΊΔ ϞοΫͷఏڙ ࣮૷ ࣮૷ ݁߹ςετ ϦϦʔε εΩʔϚͷڞ༗ɾ֬ೝָ͕ʹͰ͖Δ LBLBSJͷ"1*։ൃ "1*ఆٛͷڞ༗

Slide 47

Slide 47 text

LBLBSJͷ"1*։ൃ 4XBHHFS6*͸ศར 公式のライブデモ： https://petstore.swagger.io/?_ga=2.240324099.1201964793.1566722432-82597943.1560763776#/ ͨͩɺTXBHHFSVJͷίϯςφΛ্ཱͪ͛Δඞཁ͕͋Δ "1*ఆٛͷڞ༗

Slide 48

Slide 48 text

LBLBSJͷ"1*։ൃ "1*ఆٛͷڞ༗ HJUIVC্ͷεΩʔϚΛ4XBHHFS6*ͷܗࣜͰ֬ೝͰ͖Δ✌

Slide 49

Slide 49 text

LBLBSJͷ"1*։ൃ σϞ ެࣜͷεΩʔϚFYBNQMFIUUQTHJUIVCDPN0"*0QFO"1* 4QFDJGJDBUJPOCMPCNBTUFSFYBNQMFTWQFUTUPSFZBNM

Slide 50

Slide 50 text

LBLBSJͷ8FC"1*։ൃ LBLBSJͷ"1*։ൃ 8FCϑϩϯτ 41"ը໘ "1* 0QFO"1*ܥಋೖࡁΈ 4XBHHFS6*&EJUPSར༻ ࣗಈςετͰϨεϙϯεͷόϦσʔγ ϣϯ࣮ࢪ 0QFO"1*(FOFSBUPSͰΫϥΠΞϯτ ϥΠϒϥϦࣗಈੜ੒ ϞόΠϧΞϓϦ"1* 0QFO"1*ܥಋೖࡁΈ 4XBHHFS6*&EJUPSར༻ ࣗಈςετͰϨεϙϯεͷόϦσʔγ ϣϯ࣮ࢪ

Slide 51

Slide 51 text

·ͱΊ

Slide 52

Slide 52 text

ɾυΩϡϝϯτΛϝϯς͢ΔͷͭΒ͍ͱ͍͏ؾ͔࣋ͪΒͷղ์ ɾυΩϡϝϯτ͕ஔ͍͚ͯ΅ΓʹͳΔڪා͔Βͷղ์ ɾϑϩϯτΤϯδχΞ଴ͨͤΔͷ೜ͼͳ͍ͱ͍͏ؾ͔࣋ͪΒͷղ์ ·ͱΊ εΩʔϚۦಈ͸๻ͨͪΛղ์ͯ͘͠ΕΔ

Slide 53

Slide 53 text

ɾपลπʔϧ͕ͱͯ΋ॆ࣮͍ͯ͠Δ ɾࣗ෼ͨͪͷ։ൃϑϩʔʹ͍͔ʹ૊ΈࠐΉͷ͔͸޻෉ͷ͠Ͳ͜Ζ ɾͰ͖Δͱ͜Ζ͔Βগͣͭ͠ಋೖ͢Δ͜ͱ͕Ͱ͖Δ ·ͱΊ 0QFO"1*͸ڧ͍

Slide 54

Slide 54 text

No content