ç®æ¬¡ (9)
- FSDã¢ãŒããã¯ãã£ãžã®æ©ã¿
- ã¯ããã«
- åé¡
- åé¡ 1. èŠæ±ããã£ã³ã»ã«ãã Card ã³ã³ããŒãã³ãã®ã¬ã€ã€ãŒ
- åé¡2ã APIãã©ãã«çœ®ãã¹ãã§ããïŒ ïŒã€ã¥ãæ©ã¿äžïŒ
- åé¡3. 1ã€ã®ããŒãžã§ãã䜿çšããªããããªã³ãŒãããããŠentitiesã«çœ®ããªããã°ãªããªããã
- åé¡ã«é¢ããçµè«
- æŽç
- ä»äžã
FSDã¢ãŒããã¯ãã£ãžã®æ©ã¿
ã¯ããã«
äŒç€Ÿã§ã¯ãããã³ããšã³ãã¯FSDã¢ãŒããã¯ãã£ã§äœãããŠããŸããç§ã«ãšã£ãŠã¯2çªç®ã«é²ãFSDã¢ãŒããã¯ãã£ãããžã§ã¯ãã§ãã FSDã§çŽæ¥å®è£ ããŠã¿ãåã«ã¯ã¬ã€ã€ãŒãåããŠåœ¹å²ãåé¢ããäŸåæ§ãäžæ¹åã«æµããããŒã ã¡ã³ããŒèª°ãèŠãŠããã¡ã€ã«ãã©ãã«ããã®ãããæ¢ããã¡ã³ããã³ã¹ã容æã«ãªããšã¿ããªæããŸãã
ãããããã€ãã®ããã«ãå®åã§ã¬ã€ã€ãŒããã©ãã«çœ®ãããæ±ºå®ããããšèªäœãéåžžã«é£ããã§ãããã®æã¯å€æã®å€åãççŽã«ãŸãšããåé¡§ã§ãã
åé¡
åé¡ 1. èŠæ±ããã£ã³ã»ã«ãã Card ã³ã³ããŒãã³ãã®ã¬ã€ã€ãŒ
[æ¯æãèŠæ±æ å ±ã®è¡šç€º] + [ãªã¯ãšã¹ããã£ã³ã»ã«ã¢ã¯ã·ã§ã³]ã®åœ¹å²ãæããã«ãŒãã³ã³ããŒãã³ããäœæããŸããããã®æãæ±ºæžãªã¯ãšã¹ãæ å ±è¡šç€ºã¯Entityã¬ã€ã€ã§å®è£ ãããªã¯ãšã¹ããã£ã³ã»ã«ã¢ã¯ã·ã§ã³ã¯Featureã¬ã€ã€ã§å®è£ ããã°é©åœãªåé¢ã¿ããã§ããããããç§ã¯Cardã³ã³ããŒãã³ãèªäœãEntityã¬ã€ã€ãŒã«å«ããæ¹ãè¯ããšèããŠentitiesãããã£ã³ã»ã«ãŸã§å®è£ ããŸããã
entities/ payment-request/ ui/ PaymentRequestCard.tsx â ãã£ã³ã»ã«ãã¿ã³ã¯ãã¡ã model/ api/
äžèšã®æ§é ã®åé¡ã¯FSDã®ååãšã¯éã£ãŠããŸããã ïŒããããã«ã€ããŠåçºããã¢ãŒããã¯ãã£ã決ãŸã£ãéãã«äœ¿ãããã§ã¯ãªããšããããšã«100ïŒ
åæããŸãïŒç§ããã®ããã«äœ¿çšãããã®ããã«äœ¿çšããªããã°ãªããªããšæããŸãããããååçã«ã ã話ãã®ã§ããïŒ featuresã¬ã€ã€ãŒã§ãŠãŒã¶ãŒã®è¡åïŒactionïŒãåŠçããentityã§ããžãã¹ã¢ãã«ãŠãããã衚çŸããããšã«éäžããã°ã
ããã§ååã«åãããŠå€ããŸããã
features/ cancel-payment-request/ ui/ CancelPaymentRequestButton.tsx model/ useCancelPaymentRequest.tsâentities/ payment-request/ ui/ PaymentRequestCard.tsx â ãã¿ã³ãpropsã§æ³šå
¥ãããæ§é // widgetsã®çµã¿åãã<PaymentRequestCard data={data} action={<CancelPaymentRequestButton id={data.id} />} // å€éšæ³šå
¥/>ãã®ããã«å€ããŠã¿ããšãPaymentRequestCardã³ã³ããŒãã³ãã§ãã£ã³ã»ã«ãã¿ã³ã®äœçœ®ãã¬ã€ã¢ãŠãã§ã€ãã¿ãpropsãšããŠåãåã{action}ã¹ãããã«ã¬ã³ããªã³ã°ããæ§é ã«ãªããŸããã entitiesã§ã¯ãäºåã«ã©ããªã¢ã¯ã·ã§ã³ãæ¥ãã®ãããã®ã¢ã¯ã·ã§ã³ãå ¥ãå Žæããããããç¥ã£ãŠå®è£ ãããšããç¹ã§ãã§ã«äŸåæ§ãæã£ãŠãããããFSDã¢ãŒããã¯ãã£éå±€ã§ççŸããŠæããããŸããã
ã ããCardã³ã³ããŒãã³ããwidgetã«äžããæ¹ããã£ãšèªç¶ã ãšæã£ãŠWidgetã¬ã€ã€ãŒã«äžããŸããããªããªããaction + entityããã¹ãŠè¡šãã®ã§ããããã
const PaymentRequestCard = ({ data }) => { const { cancel } = usePaymentRequest(data.id); return ( <Card> <CardContent>{data.title}</CardContent> <Button onClick={cancel}>ãªã¯ãšã¹ãããã£ã³ã»ã«</Button> </Card> );};æçµçµæã¯
倿Žå: entities/payment-request/ui/PaymentRequestCard.tsx
倿ŽåŸ: widgets/payment-request-card/ui/PaymentRequestCard.tsx
ããå€ããŸããã ãããŒã¿è¡šçŸïŒã¢ã¯ã·ã§ã³ããäžç·ã«ãããšãã¯ãwidgetã¬ã€ã€ãŒã«äžããã®ãæ£ãããšæããŸãã
ã¢ãŒããã¯ãã£ã䜿çšããªããã³ãŒãã®äœçœ®ããããããšæããããšãã¢ãŒããã¯ãã£ã®æå³ã«åãããã«èããããªãå¯èœæ§ãé«ãããã§ããåœç¶ã®ããšã§ãããæ©èœåå²ã¢ãŒããã¯ãã£ã§ããã°ãæ©èœãšåœ¹å²ãèŠãŠåå²ãããªããã°ãªããŸããã
åé¡2ã APIãã©ãã«çœ®ãã¹ãã§ããïŒ ïŒã€ã¥ãæ©ã¿äžïŒ
FSDææžïŒå ¬åŒãã©ããã¯ããããŸãããïŒãšããã§
ç§ã¯FSDææžã®èª¬æãšã¯ç°ãªããapiã®å ŽæEintitiesã«è¿œã蟌ãŸããŸããããªããªããCRUD apiããã¹ãŠEntityãšå¯æ¥ãªé¢ä¿ãããã®ã§ããããã詳现ã«å¯æ¥ãªé¢é£ããããšããã«apiãé 眮ãããšãæ¢ãã®ãããé£ãããšæããŸããã
entities/ credit/ api/ index.ts fetchCreditXXX.ts postCreditXXX.ts keys/ getCreditOptions.ts â queryOptions chargeCreditOptions.ts â mutationOptions useCreditOptions.ts â mutationOptionsãããŠãapi layerã§ã¯ããã¹ãŠã®DTOãã¢ããªå éšã§äœ¿çšããEntityã¿ã€ãã«å€æãã責任ãäžç·ã«æã£ãŠããŸãã DTO => Entityã«å€æãããéšåãEntityã¬ã€ã€ãŒ1ç®æã«å§çž®ã§ããã®ã§ãã¯ããã«ç®¡çãæ¥œã ãšæããŸããã
ããããåã«æ©èœã«é¢ä¿ãªããEntityã¬ã€ã€ãŒã«apiã远ãããã®ã¯ãFSDã¢ãŒããã¯ãã£ã®ææ³ãšã¯å°ãåã£ãŠããªãããã§ãããè¯ãæ¹æ³ãããã®ã§ã¯ãªãããšå¿é ããŸããã
ããã§ãDTO => Entityã倿ãã責任ãqueryOptionsãšqueryMutaionsã«ç§»ããçŽç²ãªapiåŒã³åºã颿°ãšãšã³ããã€ã³ãã®äž¡æ¹ã/shared/apiã«ç§»ãæ¹æ³ãèããŸãããããã«ãããäŸç¶ãšããŠäŸåæ§ã®æ¹åã¯ãã®ãŸãŸç¶æããfetch颿°ã®åäžè²¬ä»»ååãšåå©çšæ§ãããã«ç¢ºä¿ã§ãããšèããŸããã
shared/ api/ credits/ fetchCredit.ts â çŽç²ãªHTTP颿°ã®ã¿ postChargeCredit.ts postUseCredit.tsâentities/ credit/ api/ getCreditOptions.ts â queryOptionsâfeatures/ charge-credit/ api/ chargeCreditOptions.ts â mutationOptions use-credit/ api/ useCreditOptions.ts â mutationOptions// entities/credit/api/getCreditOptions.tsexport const getCreditOptions = queryOptions({ queryFn: async () => { const dto = await fetchCredit(); return toCreditEntity(dto); // â倿ã¯ãã¡ã }});ãã®ããã«å®è£ ããã°ãåé¢FSDã®ååã¯ããå®ãããŸããããããAdaptorãšããŠæ©èœããã³ãŒãããã¡ãã¡ã«åºããããã®ããžãã¯ã¯queryOptionsã«é ããŸãããããŠã泚æãã¹ãäŸåã®æ¹åã远跡ããã®ã¯è€éã«ãªããŸãã
ã ããä»ã¯ãããªããšãã§ããªãç¶æ ã§ããç§ã®èãã«ã¯ãŸã FSDã«åããã»ã©ã³ãŒãããŒã¹ã倧ãããªãã®ã§äžäŸ¿ãæããŠãããšæããŸããçŸåšã®ã³ãŒãããŒã¹ã«åãããŠãã£ãšæ©ãã§ã¿ãã¹ãã ãšæããŸãã
ãŸãšãããšç§ã®èãã®æµãã¯ä»¥äžã®éãã§ãã
æåã¯entities/credit/apiã«å šéšè¿œã蟌ãã âãã¡ã€ã³åé床ã¯é«ããFSDã¢ãŒããã¯ãã£ææ³ãšåããªã
shared/apiã§çŽç²ãªhttpéä¿¡é¢æ°ãé€ããoptionsãã¬ã€ã€ãŒå¥ã«åããŠEntity責任ãŸã§äžãããã©ããâååã«ã¯è¿ããDTO倿äœçœ®ãæ£ãã°ã
æ¯å1ã€ã®åé¡ã解決ãããšãä»ã®åé¡ãã€ããŠããŠãã¬ãŒããªãé¢ä¿ã«çœ®ãããŸããã©ãããä»ã®ç¶æ ã§ã¯entitiesã«è¿œã蟌ãã§ãåé¡ãæããªãã®ã§ã1çªãæ£è§£ã§ãåŸã§ã³ãŒãããŒã¹ã倧ãããªããš2çªãæ£è§£ã«ãªããªãã§ããããïŒ
åé¡3. 1ã€ã®ããŒãžã§ãã䜿çšããªããããªã³ãŒãããããŠentitiesã«çœ®ããªããã°ãªããªããã
FSDã¢ãŒããã¯ãã£ã§ã1ã€ã®pageã§ã®ã¿äœ¿çšããã³ãŒãã¯pageã¬ã€ã€ãŒã«çœ®ããšãã¥ãŒããªã¢ã«ã«æç€ºããŠãããŠããŸããããããè¿·æãªã®ã¯ããã¡ã€ã³ã¢ãã«ã¯entityã«ãã¢ã¯ã·ã§ã³ã¯featuresã«é 眮ãããã®ãFSDã¢ãŒããã¯ãã£ãã¥ãŒããªã¢ã«ã§æ¬²ããã®ã§ãããããŠæŠå¿µçã«ãããã«æããã®ã¯entitiesãšfeaturesã§åé¢ããã®ã§ãããå®éã®ã³ãŒãçã«ãããã«ç¢ºèªå¯èœãªã®ã¯pageã¬ã€ã€ãŒã«ããåé¢ããŠã³ãŒããé 眮ãããã®ã§ãã
ããšãã°ãã¯ã¬ãžããããŒãžã§ã®ã¿ãæ®é«ãããŒãã䜿ããããšããŸãããšããã§ãCredit Entityãšæã坿¥ãªé¢ä¿ããããŸããã ãã以äžã®ããã«é 眮ããŸããã
entities/ credit/ ui/ CreditBalanceBanner.tsx â ãã©ã³ã¹ãã㌠CreditHistoryHeader.tsx â å±¥æŽãããããããæ®é«ãããŒã¯å®éã«ã¯1ããŒãžã§ã®ã¿äœ¿çšãããäžåºŠãå䜿çšãããããšããããŸããããããŠä»ã®ããŒãžã§åå©çšãããå¯èœæ§ããªãããã§ããã ããç§ã¯å®éã«entitiesããæ®é«ãããŒuiãpageã«äžããŠããŸããŸãããããã¯ã¯ããã«æ£ãããšæããŸããåå©çšããªãã³ãŒãããããŠãèªå宿ãã§apiãå ¬éããå¿ èŠã¯ãªãã§ããããã
pages/ credit/ ui/ CreditPage.tsx CreditBalanceBanner.tsx â ããã§ããæžããªããã CreditHistoryHeader.tsxã ããç§ã¯ãã®ãããªã³ãŒããè¯ããšæããŸããæ è»ããã°apiãããã¯ãŸã§äžç·ã«äžããŠããŸã£ãŠããããšæããŸãããããããç§ã¯apiãããã¯ãåæ¹å «æ¹ã«æ£ãã°ã£ãŠãããšãã³ãŒãã®ææ¡ããã£ãšå€§å€ã ãšæã£ãŠããŸããŸããã
åé¡ã«é¢ããçµè«
äžèšã®æ©ã¿ãããªããéèŠãªããšã¯ãããŸãã«ãã¢ãŒããã¯ãã£ã«éã蟌ããããããåé¢ããªããã°ãªããªã匷迫ã«éã蟌ããããããåäžè²¬ä»»åŒ·è¿«ã«éã蟌ãããããããããšãç§ã®æèã®èªç±ãå€ãé²ãããšãæããŸãããéèŠãªã®ã¯å€§ããªæµããªã®ã§ããããããããŠFSDãäœã®ããã«äœããããã®äœã解決ããããã«ããŸã掻çšããªããã°ãªããªããã§ããæ¹æ³ã«æ²¡é ãããæå³ã«ãã£ãšæ°ãã€ããŠæ©ãã¹ãã ãšæããŸãããã€ãã¹ãŒãã³ã¯ç®çã§ã¯ãªãã®ã«ã¹ãŒãã³ãæ©ãã§ããŸãããå®éã«ã¯ææ®µã掻çšããããšãç®çã§ã¯ãªããŠãã
æŽç
ç¶æ³ | æåã®å€æ | çµæ |
|---|---|---|
ãã£ã³ã»ã«ãã¿ã³ãå«ãã«ãŒã | entitiesãžã®ã«ãŒãã®é 眮 | widgetsã«è¡ããŸããããŒã¿è¡šçŸ+ã¢ã¯ã·ã§ã³ãäžç·ã«ããã°ãŠã£ãžã§ãã以äžã®ã¬ã€ã€ãŒã«ã |
Feature ãã¿ã³æ³šå ¥ | props injectionã§åé¢ | âãããè€éã«ãªã£ãŠèªã¿ããããè§£æ¶ |
ãã¡ã€ã³APIã®å Žæ | entities/credit/apiãžã®CRUDãã¹ãŠâshared/apiã®å颿§æ³ | â解決ãããšãDTO倿äœçœ®ã®åé¡ãçºçããŸãããã³ãŒãããŒã¹ã®èŠæš¡ã«ãã£ãŠæ£è§£ãå€ãããšæãããã |
ç¹å®ã®ããŒãžã®ã¿ã®UI | entities/credit/uiã«é 眮 | âå䜿çšãã§ããªãã³ã³ããŒãã³ããEntityã«ç©ã¿éãããããããŒãžã«çœ®ãã®ãè¯ããããããŸãã |
ä»äžã
ç§ã¯å®éã«FSDã¢ãŒããã¯ãã£ã奜ãŸãªãã FSDã¢ãŒããã¯ãã£ãã¥ãŒããªã¢ã«ãèŠããšæ§é ã匷å¶ããæãã§ããããã§ãäœå¹Žãã®éãããã€ãã®ã¬ã€ã€ãŒã¯ããã«å ¬åŒããå€ããããããŸããããããŠã人ã ã¯FSDã¢ãŒããã¯ãã£ã®ã¢ã€ãã¢ã ããæã£ãŠããŠãåäŒç€Ÿã®ã³ãŒããææ³ã«åãããŠã¬ã€ã€ãŒåãšåæ°ç®çãªã©ãåé¢ããããšãå€ãã§ãã
FSDã¢ãŒããã¯ãã£ã¯ç¢ºãã«åå¿è ãæžãã°ãããåå¿è ãå°ç¡ãã«ããããšãã§ããã¢ãŒããã¯ãã£ã®ããã§ããæ¬äººãæè»ã«ã¢ãŒããã¯ãã£ã®äžéšã ããåããŠé·æã ãåã£ãããã³ãŒãã«åãããŠäœ¿ãããšãç¥ãå¿ èŠããããŸããããããªèœåããªãã§ããããã ããããã圌ãã®ããã®ã¢ãŒããã¯ãã£ã®ããã§ããã³ã¹ããªããã€ããã®ã¢ãŒããã¯ãã£ã«ãŒã«ãã®ãŸãŸäœ¿çšããããã§ã¯ãªããå¿ èŠãªãšãã¯ææ³ãåããŠãæ¬äººãçµç¹ã®å³ããã«å€ããŠãããæè»ã«äœ¿ãããã§ãã
