Share
Embed
Webアプリケーション設計の第一歩は ディレクトリの整理から / Encraft 1
2023/3/24、Encraft #1 フロントエンド×設計にて発表した資料です。
OKUNOKENTARO
March 24, 2023
Transcript
30 slides
-
ઃܭͱ w ࣙॻͰઃܭΛҾ͘ ͱ ʁ ʢখֶؗਫ਼બ൛ຊࠃޠେࣙయʣ • せっ-けい【設計】
• ⼯事 ・ ⼯作などで、 ⼯費 ・ 材料 ・ 敷地 ・ 形式などの計画を⽴て、 図⾯その他に よ って具体的に⽰すこと。 みつも り。 も く ろみ。 •(⽐喩的に) ⼈⽣ ・ ⽣活などの計画を⽴てること。 • 明治20年代後半からdesignの訳語と して登場、 中国洋学書の影響 -
ઃܭͱ w ࣙॻͰઃܭΛҾ͘ ͱ ʁ ʢখֶؗਫ਼બ൛ຊࠃޠେࣙయʣ • せっ-けい【設計】
• ⼯事 ・ ⼯作などで、 ⼯費 ・ 材料 ・ 敷地 ・ 形式などの計画を⽴て、 図⾯その他に よ って具体的に⽰すこと。 みつも り。 も く ろみ。 •(⽐喩的に) ⼈⽣ ・ ⽣活などの計画を⽴てること。 • 明治20年代後半からdesignの訳語と して登場、 中国洋学書の影響 -
ݐͱΞϓϦέʔγϣϯͷ૬ҧ w ݐઃܭͱΞϓϦέʔγϣϯઃܭΛࠞಉ͍͚ͯ͠ͳ͍ w ઃܭण໋ w ݐे ʢͱ ͘ʹ8FCʣ
ΞϓϦέʔγϣϯͰɺ ेΛఆ͢Δ͜ͱࣄ্࣮ෆՄೳ w ݐங ɾ ։ൃͷϓϩηε w ݐஙશͳΥʔλʔϑ Υʔϧɺ ։ൃࡢࠓΞδϟΠϧ͕Ұൠత w ॡޙ ɾ Ϧ Ϧʔεޙͷѻ͍ w Ϗϧϝϯςφϯεͷจ຺ผจ຺ɺ ΞϓϦέʔγϣϯ ʮػೳՃʯ ʮෛՙରࡦʯ ͷ֓೦͕͋Δ -
ΞϓϦέʔγϣϯ ʮҡ࣋ʯ Ͱ͋Δ w զʑ͕ΞϓϦέʔγϣϯઃܭͱड़Δจ຺ͷେ ࣮ΞϓϦέʔγϣϯ ʮҡ࣋ʯ Λతͱ͍ͯ͠Δ͜ͱ͕ଟ͍ wʮˠʯ
Α Γ ʮˠɺ ˠʯ ͕ػձͱͯ͠ѹతʹଟ͍ w ˠ/ͷஈ֊ʹ͓͍ͯ ʮΞϓϦέʔγϣϯઃܭʯ ͱ ʮ͜ͷΞϓϦέʔγϣϯΛࠓޙͲ͏ ͍͖͍͔ͯͨ͠ʯ Λߟ͑Δ͜ͱ w σʔλϕʔε ɾ εΩʔϚͳͲͷݕ౼ͱɺ ΞϓϦέʔγϣϯίʔ υͷઃܭผ ʮσʔλϕʔεઃܭʯ ʹ͍ͭͯࠓճ͍ͯ͡ͳ͍ -
ཧղ͘͢͠ ͋Ε w ػೳՃ͍͢͠ɺ मਖ਼͍͢͠ɺ આ໌͍͢͠ɺ νʔϜʹՃೖ͍͢͠ w ͯ͢ ʮཧղ͍͢͠ʯ
͜ͱ͕લఏͰΓཱͭ w ཧղ͕͍ͨ͠ঢ়ଶΛܧଓͤ͞Δͳ w ഇᆣʹ͢Δͳ https://docs.google.com/presentation/d/1hDY2pb-nYVSLr0HrtQ4EVyrDU4QGgwp4-VRG-Rf26DA -
ͳΜͨΒΞʔΩςΫνϟʹͩ͜ΘΔͳ wʮͳΜͨΒΞʔΩςΫνϟʯ ͷ࠾༻ͱݫकʹͩ͜ΘΔਓΛ͠͠Έ͔͚Δ w ͯ͢҉ه͠ͳ͘ ͍͍ͯ w Ϋ Ϧʔϯ ɾ
ΞʔΩςΫνϟ w ϔΩαΰφϧ ɾ ΞʔΩςΫνϟ w ΦχΦϯ ɾ ΞʔΩςΫνϟ w ϨΠϠʔ υ ɾ ΞʔΩςΫνϟ w ྺ࢙తʹ ʮͲ͏͍͏ ͜ͱ͕ٻΊΒΕͯੜ·Εͨͷ͔ʯ ͷഎܠΛֶͿ w ԿΛ͖͢ͳͷ͔ߟ͑Δ -
ཧ͞Εཧղ͚͢͠ΕΑ͍ w ΞʔΩςΫνϟͷେ ʮґଘཧʯ ͱ ʮཧղʯ Λॿ͚ΔͨΊͷཧͷϧʔϧ w ཧ͞Ε͍ͯΔঢ়ଶ
ˠཧղ͕͢͠͞ҡ࣋͞Ε͍ͯΔঢ়ଶ ˠΞϓϦέʔγϣϯઃܭʹޭ͍ͯ͠Δঢ়ଶ wʮΞϓϦέʔγϣϯઃܭʹࣦഊͯ͠͠·ͬͨʯ ͱΑ ͘ฉ͘ w ϦΞʔΩςΫνϟͲ͏ ͜͏ Λߟ͑ΔΑ Γɺ ·ͣཧͷ࠶։Λ w ཧͯ͠ɺ ၆ᛌͯ͠ཧղ͔ͯ͠Β ʮ࣍ʹվળ͖͢͜ͱʯ ͕ු͔ͼ্͕ͬͯ͘ Δ -
ཧղ͍͢͠σΟ ϨΫ τ Ϧߏ w σΟ ϨΫ τ ϦߏͱΞʔΩςΫνϟີ w
σΟ ϨΫ τ Ϧߏ͕͍ͬͯΔͱ ͦͷલఏͰ ʮ৽ػೳͷઃܭʯ ʮमਖ਼ํͷܾఆʯ ͕ߦ͍͍͢ wʮΞϓϦέʔγϣϯͷݱࡏʯ Λද͢ਤͱͳΔ w ͳΜͨΒΞʔΩςΫνϟͷશ฿Λࢦ͢Α Γ ·ͣσΟ ϨΫ τ ϦΛཧ͢Δ -
QBHFTʹͳΜͰஔ͔ͳ͍ • ./src/client • ./src/pages • ./src/pages/api • ./src/server pagesΤϯ
τ ϦϙΠϯ τ͚ͩஔ͘ serverόοΫΤϯ υॲཧͷΈஔ͘ clientϑϩϯ τΤϯ υॲཧͷΈஔ͘ -
ίϯςΩε τ͝ͱͷσΟ ϨΫ τ Ϧ • ./src/client • ./src/client/user-page •
./src/client/todo-page • ./src/server • ./src/server/handlers/users/get • ./src/server/handlers/todos/get • ./src/server/handlers/todos/post -
CPVOEBSZΛઃ͚Δ • ./src/client • ./src/client/boundary • ./src/client/user-page • ./src/client/todo-page •
./src/server • ./src/server/boundary • ./src/server/handlers/users/get • ./src/server/handlers/todos/get • ./src/server/handlers/todos/post client͔Β֎෦ڥͷґଘ ྫ͑ɺ 'JSFCBTF 4USJQF 4FOUSZ server͔Β֎෦ڥͷґଘ ྫ͑ɺ ࣾͷόοΫΤϯ υͷ֎෦γεςϜ "VUI 3FEJT $.4 ϝʔϧૹ৴αʔϏε -
ڞ௨Խ͍ͨ͠ཉٻΛͲ͏ѻ͏͔ • ./src/client • ./src/client/boundary • ./src/client/user-page • ./src/client/shared •
./src/models • ./src/server • ./src/server/boundary • ./src/server/handlers/users/get • ./src/server/shared w sharedͱmodelsͱ͍͏֓೦Λઃ͚Δ w modelsɻ w ͋ΒΏΔ֎෦ϥΠ ϒϥ Ϧ ʢ3FBDU "QPMMPʣ ʹ Ұґଘͯ͠ͳΒͳ͍ w OQNΠϯε τʔϧͳ͘ ͱղऍՄೳͳ७ਮͳ5ZQF4DSJQU ίʔ υͷΈ͜͜ w sharedɻ w ֎෦ϥΠ ϒϥ Ϧʹগ͠Ͱґଘ͢Δίʔ υ͜͜ w 3FBDUͷ)PPLίϯϙʔωϯ τͷڞ௨Խ w "QPMMPͷΤϥʔϋϯ υ Ϧ ϯάͷڞ௨Խ -
DMJFOUͱTFSWFSΛ·͙ͨఆٛͲ͜ ʁ • ./src/client • ./src/client/boundary • ./src/client/user-page • ./src/client/shared
• ./src/models • ./src/schema • ./src/schema/handlers/users-get • ./src/server • ./src/server/boundary • ./src/server/handlers/users/get • ./src/server/shared w modelsͱผʹschemaͱ͍͏֓೦Λઃ͚Δ w ajv, json-schema-to-tsͷґଘΛڐՄ͢Δ w +40/εΩʔϚఆٛͱ5ZQF4DSJQUܕఆٛશ෦͜͜ w /handlers/users-get/request-body-schema.ts w /handlers/users-get/request-body.ts w /handlers/users-get/response-body-schema.ts w /handlers/users-get/response-body.ts w /handlers/users-get/make-path.ts -
ѻ͍ʹࠔΔϑ ΝΠϧ ʁ • ./src/client • ./src/env • ./src/models •
./src/pages • ./src/schema • ./src/server • ./src/utils w envͱutilsͱ͍͏֓೦Λઃ͚Δ w envɻ w ͋ΒΏΔڥมprocess.env.SOMETHINGΛ ͋ͪͪ͜ʹॻ͘ Α Γɺ ఆͱͯ͠·ͱΊ͓͍ͯͨ΄͏͕ ཧ ɾ ݕࡧ͍͢͠ w ͯ͢stringͷ··ʹ͢ΔΑ Γ Ͱ͋ΕࣄલʹparseInt()͓ͯ͘͠ͳͲ w boundarymodelsʹόϥ͚ͤ͞Δͱɺ ٯʹѲ͕ࠔ w utilsɻ w ࣗࣾυϝΠϯʹӨڹ͠ͳ͍ॲཧ ྫ͑ɺ ʮΦϒδΣΫ τͷ%FFQ&RVBMʯ ͩͬͨΓ Array<T>͔ΒTΛٻΊΔܕͩͬͨΓ w ͜͜ʹೖΕΔ͜ͱ͔ͳΓ৻ॏʹͳΔ͖ w Ұ൪ ʮͳΜͰശʯ ʹͳΔ -
कΕͳ͍ϧʔϧͳΒ͍Βͳ͍ wʮͲͷσΟ ϨΫ τ ϦʹԿΛೖΕ͍ͯͩ͘͞ʯ ͱ͍͏ޱ಄ͷઆ໌͚ͩͰ ͍ͣΕकΕͳ͍ਓ͕Ͱͯ͘ Δ w
ѱҙʹݶΒͣɺ ৽ਓͷप࿙Εɺ ͏ ͔ͬΓΕ͕͋Δ w ίʔ υ ϨϏϡʔ࣌ʹϨϏϡΞʔݟಀ͔͢͠Εͳ͍ ʢ(JU)VCσΟ ϨΫ τ ϦύεϑΝΠϧ໊ࣗମͷϨϏϡʔ͕Γʹ͍͘ʣ w FTMJOUͰ͔ͬ͠ΓकΕΔͷʹ͢Δ w ਓʹػցʹཧղ͍͢͠ϧʔϧΛҡ࣋͢Δ -
JNQPSUOPSFTUSJDUFEQBUIT w eslint-plugin-importʹखࠒͳϧʔϧ͕͋Δ https://github.com/import-js/eslint-plugin-import/blob/main/docs/rules/ no-restricted-paths.md w ͜ͷϧʔϧΛ࠾༻͢Δͱ ʮҙͷσΟ ϨΫ
τ Ϧ͔ΒผͷσΟ ϨΫ τ ϦͷґଘΛ ېࢭ͢Δʯ ͜ͱ͕Ͱ͖Δ w αϒσΟ ϨΫ τ Ϧಉ࢜ͷېࢭࢦఆͰ͖Δ w ྫ͑handlers/users/getͷॲཧ͕handlers/users/postʹ ґଘͯ͠ͳΒͳ͍ͱ͍͏ϧʔϧॻ͚Δ -
ҡ࣋ͷͨΊͷҰ w import/no-restricted-pathsͷܽېࢭϦ ε τͷཧͰ͋Δ͜ͱ w ېࢭϦ ε τͷཧͩͱɺ αϒσΟ
ϨΫ τ Ϧͷ૿ݮʹԠͯ͡ϝϯς͕ඞཁ w ڐՄϦ ε τͷཧʹ͢Εɺ ݪଇېࢭͰɺ ՃڐՄ͍ͨ͠ͱ͖͚ͩϝϯςφϯε͢ΕΑ͍ w ڐՄϦ ε τΛఆͱͯ͠ఆٛ͠ɺ ҙͷεΫ Ϧ ϓτΛ࣮ߦ͢Δ͜ͱͰ .eslintrc.jsΛࣗಈੜ͢ΔΑ ͏ʹΈΛ͑ͨ w ڐՄϦ ε τΛͱʹɺ సͤ͞શېࢭϦ ε τΛࣗಈੜ w npm iͷࡍʹৗʹ࣮ߦ͢ΔΑ ͏ʹख͢Δ -
σΟ ϨΫ τ ϦΛύοέʔδͱଊ͑Δ w ͏ͻͱͭFTMJOUϧʔϧΛಋೖ͢Δ w eslint-plugin-import-access https://zenn.dev/uhyo/articles/eslint-plugin-import-access
w @packageσΟ ϨΫςΟ ϒΛ༩͢Δ͜ͱͰɺ ଞͷσΟ ϨΫ τ Ϧ͔Βࢀরͨ͠ࡍʹ-JOUΤϥʔʹͰ͖Δ wʮexportͨ͘͠ͳ͍͔ΒϑΝΠϧʹେྔʹॻ͘ʯ ͱ͍͏ඞཁ͕ͳ͘ͳΔ -
ϧʔϧΛकΔͱͲ͏ͳΔ͔ w ґଘํӨڹൣғΛཧղ͍͢͠ w schemaσΟ ϨΫ τ Ϧʹґଘ͍ͯ͠ΔclientͱserverԼ͔ΒӨڹൣғಛఆ w Ͳͷ3FBDU)PPL͕͜ͷΤϯ
υϙΠϯ τΛݺΜͰΔ ʁ ͜ͷΤϯ υϙΠϯ τͲͷΤϥʔΛฦ͠͏ Δ ʁ w όοΫΤϯ υॲཧͷͳ͔ͰೝূܥΛ୲͍ͯ͠ΔͷͲ͔͜ ʁ w server/boundary/authͷϑΝΠϧ͔ɺ ͦ͜ʹґଘ͍ͯ͠ΔϑΝΠϧΛݕࡧ͢Εػցతʹચ͍ग़ͤΔ w औΓҧ͑ͷࢭ w server/handlers/users/getͰserver/handlers/todos/getͷॲཧʹґଘ͍ͯͨ͠ΒऔΓҧ͑ w ϑΝΠϧઌ಄ͷimportจͱɺexport͞ΕΔม໊ ɾ ໊ؔΛோΊΔ͚ͩͰ ʮ͜ͷϑΝΠϧԿ͕͍͔ͨ͠ʯ ͕ҰྎવͱͳΔ -
ίʔ υ ϨϏϡΞʔʹ༏͍͠ w มߋϑΝΠϧҰཡ͕ཁΛຬͨͨ͢Ίɺ ϨϏϡΞʔ·ͣมߋ͞ΕͨϑΝΠϧҰཡΛோΊΔͱཧղ͍͢͠ w client/**, client/shared, modelsͷมߋ
w ʮը໘ଆʹ৽ͨͳ֓೦Λදࣔͤ͞ΔͨΊɺ ৽͍͠ίϯϙʔωϯ τ࣮Λͨ͠Μͩͳʯ w server/handlers/**, server/shared, server/boundaryͷมߋ w ʮೝՄܥͷमਖ਼ͷͨΊʹɺ όοΫΤϯ υΛԣஅతʹมߋͨ͠Μͩͳʯ w client/**, client/shared, models, server/**, server/sharedͷมߋ w ʮൣғ͕͍ ʂ Ϋϥε໊൚༻໊ؔͷվ໊͔ ʁ ͋Δ͍Կ͔େֻ͔Γͳ͜ͱΛΓ͍͗ͯ͢ͳ͍͔ ʁ ʯ -
ςε τʹ༏͍͠ w σΟ ϨΫ τ Ϧ ͝ͱʹ ʮͲ͏͍͏ ςε
τΛॻ͚Α͍͔ʯ ͕ٻ· Γ͍͢ w ίϯϙʔωϯ τͷݟͨΛςε τ͍ͨ͠ͷ͔ w ෳͷ֎෦αʔϏεΛͭͳ͍Ͱ͍Δͱ͖ʹɺ Τϥʔϋϯ υ Ϧ ϯάΛϞοΫΛͬͨ ݁߹ςε τͱͯ͠ݕূ͍ͨ͠ͷ͔ w ࣮ࡍʹ֎෦αʔϏεʹରͯ͠ϦΫΤε τΛ͛ͯ &OEUP&OEͳςε τΛ࣮ࢪ͍ͨ͠ͷ͔ w ͲͷσΟ ϨΫ τ Ϧʹ͋ΔϑΝΠϧΛϞοΫʹ͢ΕΑ͍͔͕ٻ· Γ͍͢ w boundaryͷґଘΛϞοΫ͢Δɺ envͷґଘΛϞοΫ͢Δɺ ͳͲ -
$PODMVTJPO w ΞϓϦέʔγϣϯཧղ͍͢͠ঢ়ଶΛҡ͖࣋͢Ͱ͋Δ w σΟ ϨΫ τ Ϧߏ͕ཧ͞Ε͍ͯΔͱɺ ػೳͷଟ͞ෳࡶ͕͞ࢹ֮తʹཧղ͍͢͠
w ґଘํʹ-JOUʹΑΔଋറΛՃ͑Δͱɺ աͳີ݁߹Λ͍͗͢ w ςε τͷ࡞Ϧ ϑΝΫλ Ϧ ϯάͷ࣮ࢪ͕༰қ w ݁Ռతʹ ʮͳΜͨΒΞʔΩςΫνϟʯ ͷཁΛຬͨ͢͜ͱ͕Ͱ͖Δ w ·ͣσΟ ϨΫ τ ϦΛཧ͠Α ͏