Summarize this content to 400 words in Persian Lang <\/p>\n
\u06a9\u062f \u0628\u0627 \u0642\u0627\u0628\u0644\u06cc\u062a \u062a\u0633\u062a \u0628\u06cc\u0634\u062a\u0631<\/p>\n
\u0645\u0634\u0627\u0647\u062f\u0627\u062a \u0627\u0648\u0644\u06cc\u0647<\/p>\n
\u0628\u0647\u0628\u0648\u062f \u062f\u0631 \u0646\u0648\u0634\u062a\u0646 \u062a\u0633\u062a \u0648 \u0642\u0627\u0628\u0644\u06cc\u062a \u062a\u0633\u062a \u06a9\u062f \u0628\u0633\u062a\u06af\u06cc \u0628\u0647 \u0628\u0644\u0648\u063a \u062a\u06cc\u0645 \u0628\u0627 \u0645\u0648\u0627\u0631\u062f \u0632\u06cc\u0631 \u062f\u0627\u0631\u062f:<\/p>\n
\u0645\u062d\u06cc\u0637 \u062a\u0648\u0633\u0639\u0647
\n\u062a\u0648\u0633\u0639\u0647 \u062a\u0633\u062a
\n\u0645\u0639\u0645\u0627\u0631\u06cc \u0633\u06cc\u0633\u062a\u0645
\n\u062f\u0631\u06a9 \u0648 \u0648\u0636\u0648\u062d \u0627\u0644\u0632\u0627\u0645\u0627\u062a<\/p>\n
\u0646\u06a9\u0627\u062a \u062a\u062d\u062a \u067e\u0648\u0634\u0634 \u062f\u0631 \u0627\u06cc\u0646 \u0633\u0646\u062f \u0628\u0631 \u0627\u0633\u0627\u0633 \u0645\u0637\u0627\u0644\u0639\u0647 \u0646\u0638\u0631\u06cc \u0648 \u062f\u0627\u0646\u0634 \u06a9\u0633\u0628 \u0634\u062f\u0647 \u062f\u0631 \u0637\u0648\u0644 \u062a\u0645\u0631\u06cc\u0646 \u062c\u0627\u0645\u0639 \u062a\u0648\u0633\u0639\u0647 \u0622\u0632\u0645\u0648\u0646 \u0627\u0633\u062a:<\/p>\n
\u0686\u0646\u06cc\u0646 \u0634\u06cc\u0648\u0647\u200c\u0647\u0627\u06cc\u06cc \u0645\u0641\u06cc\u062f \u0648 \u0645\u0631\u062a\u0628\u0637 \u062e\u0648\u0627\u0647\u0646\u062f \u0628\u0648\u062f\u060c \u0628\u0627 \u0627\u06cc\u0646 \u062d\u0627\u0644\u060c \u0627\u0633\u062a\u0627\u0646\u062f\u0627\u0631\u062f\u0647\u0627\u06cc\u06cc \u0628\u0627\u06cc\u062f \u062a\u0648\u0633\u0637 \u062a\u06cc\u0645\u200c\u0647\u0627 \u0627\u06cc\u062c\u0627\u062f \u0648 \u062d\u0641\u0638 \u0634\u0648\u062f \u062a\u0627 \u06af\u0631\u062f\u0634 \u06a9\u0627\u0631 \u062a\u0648\u0633\u0639\u0647 \u06a9\u062f \u0648 \u062a\u0633\u062a\u200c\u0647\u0627\u06cc \u0646\u0648\u0634\u062a\u0646 \u0628\u0647 \u06cc\u06a9 \u062c\u0631\u06cc\u0627\u0646 \u0631\u0627\u06cc\u062c \u062a\u0628\u062f\u06cc\u0644 \u0634\u0648\u062f \u06a9\u0647 \u0628\u0631\u0627\u06cc \u0647\u0645\u0647 \u0622\u0633\u0627\u0646 \u0627\u0633\u062a.<\/p>\n
\u0622\u0632\u0645\u0627\u06cc\u0634 \u0647\u0627 \u0628\u0631\u0627\u06cc \u0686\u06cc\u0633\u062a\u061f<\/p>\n
\u0622\u0632\u0645\u0627\u06cc\u0634 \u0647\u0627 \u0628\u0647 \u0639\u0646\u0648\u0627\u0646 \u0645\u0633\u062a\u0646\u062f \u0628\u0631\u0627\u06cc \u062a\u0648\u0633\u0639\u0647 \u062f\u0647\u0646\u062f\u06af\u0627\u0646 \u062f\u06cc\u06af\u0631 \u0639\u0645\u0644 \u0645\u06cc \u06a9\u0646\u0646\u062f:<\/p>\n
\u062f\u0631\u06a9 \u0648 \u0646\u06af\u0647\u062f\u0627\u0631\u06cc \u0627\u0632 \u0645\u062d\u0635\u0648\u0644\u0627\u062a \u06cc\u06a9 \u0634\u0631\u06a9\u062a \u0631\u0627 \u062a\u0633\u0647\u06cc\u0644 \u0645\u06cc \u06a9\u0646\u062f.<\/p>\n
\u0622\u0632\u0645\u0627\u06cc\u0634\u200c\u0647\u0627 \u0627\u0637\u0645\u06cc\u0646\u0627\u0646 \u0631\u0627 \u062f\u0631 \u062a\u0648\u0633\u0639\u0647 \u0648 \u0646\u06af\u0647\u062f\u0627\u0631\u06cc \u062c\u0631\u06cc\u0627\u0646 \u0645\u062d\u0635\u0648\u0644 \u0646\u0634\u0627\u0646 \u0645\u06cc\u200c\u062f\u0647\u0646\u062f.<\/p>\n
\u062a\u0633\u062a \u0647\u0627 \u0646\u0634\u0627\u0646 \u0645\u06cc \u062f\u0647\u062f \u06a9\u0647 \u0622\u06cc\u0627 \u06a9\u062f \u0634\u0645\u0627 \u0628\u0647 \u062e\u0648\u0628\u06cc \u0646\u0648\u0634\u062a\u0647 \u0634\u062f\u0647 \u0627\u0633\u062a \u06cc\u0627 \u062e\u06cc\u0631:<\/p>\n
\u0627\u06af\u0631 \u0646\u0648\u0634\u062a\u0646 \u062a\u0633\u062a \u0628\u0631\u0627\u06cc \u06a9\u062f \u062f\u0634\u0648\u0627\u0631 \u0627\u0633\u062a\u060c \u0645\u0645\u06a9\u0646 \u0627\u0633\u062a \u0628\u062f \u0646\u0648\u0634\u062a\u0647\u060c \u067e\u06cc\u0686\u06cc\u062f\u0647\u060c \u067e\u0631\u0645\u062e\u0627\u0637\u0628\u060c \u0628\u06cc\u0634 \u0627\u0632 \u062d\u062f \u0647\u0645\u0631\u0627\u0647 \u06cc\u0627 \u067e\u06cc\u0686\u06cc\u062f\u0647 \u062a\u0631 \u0627\u0632 \u0622\u0646 \u0686\u06cc\u0632\u06cc \u0628\u0627\u0634\u062f \u06a9\u0647 \u0645\u06cc \u062a\u0648\u0627\u0646\u062f \u0628\u0627\u0634\u062f.<\/p>\n
\u062a\u0633\u062a \u0647\u0627 \u062f\u0631 \u0645\u0631\u062d\u0644\u0647 \u062a\u0648\u0633\u0639\u0647\u060c \u062e\u0631\u0627\u0628\u06cc \u0647\u0627 \u0631\u0627 \u062a\u0634\u062e\u06cc\u0635 \u0645\u06cc \u062f\u0647\u0646\u062f:<\/p>\n
\u0622\u0646\u0647\u0627 \u0627\u0632 \u0645\u0648\u0627\u062c\u0647 \u0634\u062f\u0646 \u06a9\u0627\u0631\u0628\u0631\u0627\u0646 \u0628\u0627 \u0627\u06cc\u0646 \u0646\u0642\u0635 \u0647\u0627 \u062c\u0644\u0648\u06af\u06cc\u0631\u06cc \u0645\u06cc \u06a9\u0646\u0646\u062f.<\/p>\n
\u0686\u0631\u0627 \u062f\u0627\u0634\u062a\u0646 \u06a9\u062f \u0642\u0627\u0628\u0644 \u0622\u0632\u0645\u0627\u06cc\u0634 \u0628\u0631\u0627\u06cc \u0639\u0645\u0631 \u0645\u0641\u06cc\u062f \u06cc\u06a9 \u0646\u0631\u0645 \u0627\u0641\u0632\u0627\u0631 \u0645\u062b\u0628\u062a \u0627\u0633\u062a\u061f<\/p>\n
\u062c\u0631\u06cc\u0627\u0646 \u0646\u0631\u0645 \u0627\u0641\u0632\u0627\u0631 \u0647\u0645\u06cc\u0634\u0647 \u0628\u0631\u0627\u06cc \u0647\u0645\u0627\u0647\u0646\u06af\u06cc \u0628\u0627 \u062f\u0646\u06cc\u0627\u06cc \u0648\u0627\u0642\u0639\u06cc \u0648 \u0646\u06cc\u0627\u0632\u0647\u0627\u06cc \u06a9\u0627\u0631\u0628\u0631 \u062a\u063a\u06cc\u06cc\u0631 \u0645\u06cc \u06a9\u0646\u062f:<\/p>\n
\u062d\u0641\u0638 \u0641\u0631\u0647\u0646\u06af \u062a\u0633\u062a \u0632\u0646\u06cc \u06cc\u06a9 \u062a\u06cc\u0645 \u0628\u0647 \u0646\u0633\u0628\u062a \u0632\u0645\u0627\u0646\/\u0641\u0627\u06cc\u062f\u0647 \u0646\u0648\u0634\u062a\u0646 \u062a\u0633\u062a \u0647\u0627 \u0628\u0633\u062a\u06af\u06cc \u062f\u0627\u0631\u062f.<\/p>\n
\u062f\u0627\u0634\u062a\u0646 \u06a9\u062f \u0642\u0627\u0628\u0644 \u0622\u0632\u0645\u0627\u06cc\u0634 \u0628\u0647 \u0645\u0639\u0646\u0627\u06cc \u067e\u0630\u06cc\u0631\u0634 \u0648 \u0646\u06af\u0647\u062f\u0627\u0631\u06cc \u06cc\u06a9 \u0633\u0627\u062e\u062a\u0627\u0631\/\u0645\u0639\u0645\u0627\u0631\u06cc \u067e\u0627\u06cc\u0647 \u06a9\u062f \u0627\u0633\u062a \u06a9\u0647 \u0628\u0627\u0639\u062b \u0627\u06cc\u062c\u0627\u062f:<\/p>\n
\u062f\u0631\u06a9 \u0648 \u062a\u0648\u0633\u0639\u0647 \u0622\u0633\u0627\u0646
\n\u06a9\u0627\u0647\u0634 \u0632\u0645\u0627\u0646 \u0628\u0631\u0627\u06cc \u06cc\u0627\u0641\u062a\u0646 \u0639\u06cc\u0648\u0628
\n\u062f\u0631\u06a9 \u0628\u0647\u062a\u0631 \u062c\u0631\u06cc\u0627\u0646 \u0647\u0627\u06cc \u067e\u06cc\u0686\u06cc\u062f\u0647
\n\u06af\u0631\u062f\u0634 \u06a9\u0627\u0631 \u06a9\u0645 \u0647\u0632\u06cc\u0646\u0647\u060c \u062e\u0633\u062a\u0647 \u06a9\u0646\u0646\u062f\u0647 \u0648 \u0628\u06cc \u0646\u0638\u0645<\/p>\n
\u0627\u0633\u062a\u0631\u0627\u062a\u0698\u06cc \u0647\u0627\u06cc\u06cc \u0628\u0631\u0627\u06cc \u0628\u0647\u0628\u0648\u062f \u062a\u0633\u062a \u067e\u0630\u06cc\u0631\u06cc \u06a9\u062f<\/p>\n
\u062f\u0631\u06a9 \u06a9\u0627\u0645\u0644 \u0627\u0644\u0632\u0627\u0645\u0627\u062a \u0648 \u0637\u0631\u0627\u062d\u06cc \u0633\u06cc\u0633\u062a\u0645<\/p>\n
\u0627\u06cc\u0646 \u0634\u0627\u0645\u0644 \u0632\u06cc\u0631\u0633\u0627\u062e\u062a \u0627\u0631\u0627\u0626\u0647 \u0634\u062f\u0647 \u062a\u0648\u0633\u0637 \u06a9\u062f \u0645\u06cc \u0634\u0648\u062f
\n\u0646\u062d\u0648\u0647 \u062a\u0639\u0627\u0645\u0644 \u0627\u062c\u0632\u0627\u06cc \u062f\u0627\u062e\u0644\u06cc \u0648 \u062e\u0627\u0631\u062c\u06cc<\/p>\n
\u0627\u0633\u062a\u0627\u0646\u062f\u0627\u0631\u062f\u0633\u0627\u0632\u06cc \u062e\u0637\u0627 (\u0646\u062d\u0648\u0647 \u0628\u0627\u0632\u06af\u0631\u062f\u0627\u0646\u062f\u0646 \u0622\u0646)<\/p>\n
\u0627\u0633\u062a\u0627\u0646\u062f\u0627\u0631\u062f \u0633\u0627\u0632\u06cc \u067e\u06cc\u0627\u0645 \u062e\u0637\u0627<\/p>\n
\u062a\u0639\u0631\u06cc\u0641 “\u0646\u0642\u0627\u0637 \u0634\u06a9\u0633\u062a”.<\/p>\n
\u0627\u0633\u062a\u0627\u0646\u062f\u0627\u0631\u062f\u0633\u0627\u0632\u06cc \u062e\u0637\u0627 (\u0642\u0627\u0644\u0628)<\/p>\n
\u0627\u0633\u062a\u0627\u0646\u062f\u0627\u0631\u062f\u0633\u0627\u0632\u06cc \u067e\u06cc\u0627\u0645 \u062e\u0637\u0627<\/p>\n
\u0646\u0631\u0645\u0627\u0644 \u0633\u0627\u0632\u06cc \u062f\u0627\u062f\u0647 \u0647\u0627<\/p>\n
\u062c\u062f\u0627\u0633\u0627\u0632\u06cc \u0627\u062c\u0632\u0627\u06cc \u062f\u0627\u062e\u0644\u06cc \u0648 \u062e\u0627\u0631\u062c\u06cc \u0628\u0647 \u062e\u0648\u0628\u06cc \u062c\u062f\u0627 \u0634\u062f\u0647 \u0627\u0633\u062a<\/p>\n
\u0628\u06cc\u0627\u06cc\u06cc\u062f \u0646\u06a9\u0627\u062a \u0628\u0627\u0644\u0627 \u0631\u0627 \u062a\u062c\u0632\u06cc\u0647 \u06a9\u0646\u06cc\u0645:<\/p>\n
\u0632\u06cc\u0631\u0633\u0627\u062e\u062a \u0647\u0627\u06cc \u0645\u0648\u062c\u0648\u062f<\/p>\n
\u062f\u0631\u06a9 \u0632\u06cc\u0631\u0633\u0627\u062e\u062a \u0645\u0633\u062a\u0644\u0632\u0645 \u062f\u0627\u0646\u0633\u062a\u0646 \u0645\u0646\u0627\u0628\u0639 \u0645\u0648\u062c\u0648\u062f\u060c \u0645\u0627\u0646\u0646\u062f \u0633\u0631\u0648\u0631\u0647\u0627\u060c \u0633\u0631\u0648\u06cc\u0633\u200c\u0647\u0627\u06cc \u0627\u0628\u0631\u06cc\u060c \u067e\u0627\u06cc\u06af\u0627\u0647\u200c\u0647\u0627\u06cc \u062f\u0627\u062f\u0647 \u0648 \u0646\u062d\u0648\u0647 \u0627\u062c\u0631\u0627\u06cc \u06a9\u062f \u0627\u0633\u062a. \u0627\u06cc\u0646 \u0627\u0645\u0631 \u0628\u0631 \u062a\u0635\u0645\u06cc\u0645\u0627\u062a \u0637\u0631\u0627\u062d\u06cc\u060c \u062a\u0635\u0645\u06cc\u0645 \u06af\u06cc\u0631\u06cc \u062a\u0648\u0633\u0639\u0647 \u0648 \u0633\u0646\u0627\u0631\u06cc\u0648\u0647\u0627\u06cc \u0622\u0632\u0645\u0627\u06cc\u0634 \u062a\u0623\u062b\u06cc\u0631 \u0645\u06cc \u06af\u0630\u0627\u0631\u062f.<\/p>\n
\u062a\u0639\u0627\u0645\u0644 \u0628\u06cc\u0646 \u0627\u062c\u0632\u0627\u06cc \u062f\u0627\u062e\u0644\u06cc \u0648 \u062e\u0627\u0631\u062c\u06cc<\/p>\n
\u062f\u0627\u0646\u0633\u062a\u0646 \u0646\u062d\u0648\u0647 \u062a\u0639\u0627\u0645\u0644 \u062f\u0627\u062e\u0644\u06cc (\u0645\u0627\u0698\u0648\u0644 \u0647\u0627\u060c \u062e\u062f\u0645\u0627\u062a) \u0648 \u0627\u062c\u0632\u0627\u06cc \u062e\u0627\u0631\u062c\u06cc (API \u0647\u0627\u060c \u067e\u0627\u06cc\u06af\u0627\u0647 \u0647\u0627\u06cc \u062f\u0627\u062f\u0647\u060c \u0633\u06cc\u0633\u062a\u0645 \u0647\u0627\u06cc \u0634\u062e\u0635 \u062b\u0627\u0644\u062b) \u0628\u0631\u0627\u06cc \u062a\u0635\u0645\u06cc\u0645 \u06af\u06cc\u0631\u06cc\u060c \u0637\u0631\u0627\u062d\u06cc \u0633\u06cc\u0633\u062a\u0645 \u0648 \u0633\u0646\u0627\u0631\u06cc\u0648\u0647\u0627\u06cc \u0622\u0632\u0645\u0627\u06cc\u0634 \u0628\u0633\u06cc\u0627\u0631 \u0645\u0647\u0645 \u0627\u0633\u062a. \u0628\u0647 \u0639\u0646\u0648\u0627\u0646 \u0645\u062b\u0627\u0644\u060c \u0647\u0646\u06af\u0627\u0645 \u0627\u062f\u063a\u0627\u0645 \u0628\u0627 \u06cc\u06a9 API \u0634\u062e\u0635 \u062b\u0627\u0644\u062b\u060c \u0645\u0647\u0645 \u0627\u0633\u062a \u06a9\u0647 \u0628\u0647 \u0648\u0636\u0648\u062d \u0646\u062d\u0648\u0647 \u0631\u0633\u06cc\u062f\u06af\u06cc \u0628\u0647 \u062e\u0631\u0627\u0628\u06cc \u0647\u0627 \u06cc\u0627 \u062a\u0623\u062e\u06cc\u0631\u0647\u0627 \u0631\u0627 \u0628\u0631\u0627\u06cc \u062d\u0641\u0638 \u0627\u0633\u062a\u062d\u06a9\u0627\u0645 \u0633\u06cc\u0633\u062a\u0645 \u062a\u0639\u0631\u06cc\u0641 \u06a9\u0646\u06cc\u062f. \u062f\u0631 \u0645\u0648\u0631\u062f \u062f\u0648\u0645\u060c \u0627\u062c\u0632\u0627\u06cc \u062f\u0627\u062e\u0644\u06cc \u0631\u0627 \u0628\u0647 \u062e\u0648\u0628\u06cc \u0627\u0632 \u0627\u062c\u0632\u0627\u06cc \u062e\u0627\u0631\u062c\u06cc \u062c\u062f\u0627 \u0646\u06af\u0647 \u062f\u0627\u0631\u06cc\u062f\u0628\u0647 \u0645\u0627 \u06a9\u0645\u06a9 \u0645\u06cc \u06a9\u0646\u062f \u062a\u0627 \u0645\u0633\u062e\u0631\u0647 \u06a9\u0646\u06cc\u0645\u060c \u0627\u062d\u062a\u0645\u0627\u0644\u0627\u062a \u0631\u0627 \u0634\u0628\u06cc\u0647 \u0633\u0627\u0632\u06cc \u06a9\u0646\u06cc\u0645 \u0648 \u06a9\u0646\u062a\u0631\u0644 \u0647\u0645\u0647 \u0633\u0646\u0627\u0631\u06cc\u0648\u0647\u0627\u06cc \u0645\u0645\u06a9\u0646 \u062f\u0631 \u0648\u06cc\u0698\u06af\u06cc \u0631\u0627 \u062f\u0627\u0634\u062a\u0647 \u0628\u0627\u0634\u06cc\u0645.\u06a9\u0647 \u062f\u0631 \u062d\u0627\u0644 \u062a\u0648\u0633\u0639\u0647 \u0647\u0633\u062a\u06cc\u0645<\/p>\n
\u0627\u0633\u062a\u0627\u0646\u062f\u0627\u0631\u062f\u0633\u0627\u0632\u06cc \u062e\u0637\u0627 \u0648 \u067e\u06cc\u0627\u0645 \u062e\u0637\u0627<\/p>\n
\u0686\u0631\u0627 \u062e\u0637\u0627\u0647\u0627 \u0648 \u067e\u06cc\u0627\u0645 \u0647\u0627\u06cc \u062e\u0637\u0627 \u0631\u0627 \u0627\u0633\u062a\u0627\u0646\u062f\u0627\u0631\u062f \u0645\u06cc \u06a9\u0646\u06cc\u0645\u061f<\/p>\n
\u0633\u0627\u0632\u06af\u0627\u0631\u06cc: \u062a\u0636\u0645\u06cc\u0646 \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0627\u0632 \u0627\u0635\u0637\u0644\u0627\u062d\u0627\u062a \u06cc\u06a9\u0633\u0627\u0646 \u062f\u0631 \u0633\u0631\u0627\u0633\u0631 \u0633\u06cc\u0633\u062a\u0645.<\/p>\n
\u0633\u0647\u0648\u0644\u062a \u062a\u0639\u0645\u06cc\u0631 \u0648 \u0646\u06af\u0647\u062f\u0627\u0631\u06cc: \u062a\u063a\u06cc\u06cc\u0631\u0627\u062a \u0627\u06cc\u062c\u0627\u062f \u0634\u062f\u0647 \u062f\u0631 \u06cc\u06a9 \u0645\u06a9\u0627\u0646\u060c \u0628\u062f\u0648\u0646 \u0646\u06cc\u0627\u0632 \u0628\u0647 \u062c\u0633\u062a\u062c\u0648 \u0648 \u062c\u0627\u06cc\u06af\u0632\u06cc\u0646\u06cc \u062f\u0631 \u0633\u0631\u0627\u0633\u0631 \u06a9\u062f.<\/p>\n
\u0628\u06cc\u0646 \u0627\u0644\u0645\u0644\u0644\u06cc \u0634\u062f\u0646: \u062a\u0631\u062c\u0645\u0647 \u0631\u0627 \u0628\u0627 \u0645\u062a\u0645\u0631\u06a9\u0632 \u06a9\u0631\u062f\u0646 \u067e\u06cc\u0627\u0645 \u0647\u0627 \u0648 \u0646\u0645\u0648\u0646\u0647 \u0633\u0627\u0632\u06cc \u0622\u0646\u0647\u0627 \u0641\u0642\u0637 \u06cc\u06a9 \u0628\u0627\u0631 \u062a\u0633\u0647\u06cc\u0644 \u0645\u06cc \u06a9\u0646\u062f.<\/p>\n
\u0622\u0632\u0645\u0627\u06cc\u0634 \u067e\u0630\u06cc\u0631\u06cc: \u067e\u06cc\u0627\u0645 \u0647\u0627\u06cc \u0642\u0627\u0628\u0644 \u067e\u06cc\u0634 \u0628\u06cc\u0646\u06cc \u0627\u0639\u062a\u0628\u0627\u0631 \u0633\u0646\u062c\u06cc \u0627\u0633\u062a\u062b\u0646\u0627\u0647\u0627 \u0631\u0627 \u062f\u0631 \u062a\u0633\u062a \u0647\u0627 \u0622\u0633\u0627\u0646 \u062a\u0631 \u0645\u06cc \u06a9\u0646\u062f.<\/p>\n
\u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0645\u062c\u062f\u062f: \u067e\u06cc\u0627\u0645 \u0647\u0627\u06cc \u062e\u0637\u0627 \u0631\u0627 \u0645\u06cc \u062a\u0648\u0627\u0646 \u0628\u0647 \u0635\u0648\u0631\u062a \u06cc\u06a9\u0633\u0627\u0646 \u062f\u0631 \u0642\u0633\u0645\u062a \u0647\u0627\u06cc \u0645\u062e\u062a\u0644\u0641 \u0628\u0631\u0646\u0627\u0645\u0647 \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u06a9\u0631\u062f.<\/p>\n
export const createErrors = (error_message: string, status_code: number) => {
\n const error = new Error(error_message);<\/p>\n
return {
\n error: error,
\n status_code,
\n };
\n};<\/p>\n
export const ErrorMessages = {
\n INVALID_PASSWORD: “Invalid password”,
\n USER_ALREADY_EXISTS: “User already exists”,
\n} as const;<\/p>\n
export const createUser = async ({
\n email,
\n password,
\n}: {
\n email: string;
\n password: string;
\n}) => {
\n const validPassword = validatePassword(password);<\/p>\n
if (!validPassword) {
\n return createErrors(ErrorMessages.INVALID_PASSWORD, 422); \/\/ breakpoint
\n }<\/p>\n
const userExists = await findUserByEmail(email);<\/p>\n
if (userExists) {
\n return createErrors(ErrorMessages.USER_ALREADY_EXISTS, 412); \/\/breakpoint
\n }
\n};<\/p>\n
\u0648\u0627\u0631\u062f \u062d\u0627\u0644\u062a \u062a\u0645\u0627\u0645 \u0635\u0641\u062d\u0647 \u0634\u0648\u06cc\u062f<\/p>\n
\u0627\u0632 \u062d\u0627\u0644\u062a \u062a\u0645\u0627\u0645 \u0635\u0641\u062d\u0647 \u062e\u0627\u0631\u062c \u0634\u0648\u06cc\u062f<\/p>\n
\u0646\u0631\u0645\u0627\u0644 \u0633\u0627\u0632\u06cc \u062f\u0627\u062f\u0647 \u0647\u0627<\/p>\n
\u0646\u0631\u0645\u0627\u0644 \u0633\u0627\u0632\u06cc \u062f\u0627\u062f\u0647 \u0647\u0627 \u0686\u06cc\u0633\u062a\u061f<\/p>\n
\u0646\u0631\u0645\u0627\u0644\u200c\u0633\u0627\u0632\u06cc \u062f\u0627\u062f\u0647\u200c\u0647\u0627 \u0641\u0631\u0622\u06cc\u0646\u062f \u062a\u0628\u062f\u06cc\u0644 \u062f\u0627\u062f\u0647\u200c\u0647\u0627\u06cc \u0628\u062f\u0648\u0646 \u0633\u0627\u062e\u062a\u0627\u0631 \u0628\u0647 \u0642\u0627\u0644\u0628\u06cc \u0633\u0627\u0632\u06af\u0627\u0631 \u0648 \u0633\u0627\u062e\u062a\u0627\u0631\u06cc\u0627\u0641\u062a\u0647 \u0642\u0628\u0644 \u0627\u0632 \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0627\u0632 \u0622\u0646 \u062f\u0631 \u0628\u0642\u06cc\u0647 \u0633\u06cc\u0633\u062a\u0645 \u0627\u0633\u062a. \u0627\u06cc\u0646 \u06a9\u0645\u06a9 \u0645\u06cc \u06a9\u0646\u062f \u062a\u0627 \u0627\u0637\u0645\u06cc\u0646\u0627\u0646 \u062d\u0627\u0635\u0644 \u0634\u0648\u062f \u06a9\u0647 \u0633\u06cc\u0633\u062a\u0645 \u0628\u0647 \u0637\u0648\u0631 \u0642\u0627\u0628\u0644 \u067e\u06cc\u0634 \u0628\u06cc\u0646\u06cc\u060c \u067e\u06cc\u0648\u0633\u062a\u0647 \u0648 \u062c\u062f\u0627 \u0627\u0632 \u0627\u062c\u0632\u0627\u06cc \u062e\u0627\u0631\u062c\u06cc \u06a9\u0627\u0631 \u0645\u06cc \u06a9\u0646\u062f. \u0627\u06cc\u0646 \u0628\u0631\u0627\u06cc \u0647\u0631 \u0645\u0624\u0644\u0641\u0647 \u062e\u0627\u0631\u062c\u06cc\u060c \u0645\u0646\u0628\u0639 \u062d\u0627\u0641\u0638\u0647 \u067e\u0646\u0647\u0627\u0646\u060c \u0645\u0646\u0628\u0639 \u062f\u0627\u062f\u0647\u060c \u067e\u06cc\u0627\u0645 \u0631\u0633\u0627\u0646\u06cc\u060c \u0630\u062e\u06cc\u0631\u0647 \u0633\u0627\u0632\u06cc … \u0627\u0639\u0645\u0627\u0644 \u0645\u06cc \u0634\u0648\u062f.<\/p>\n
\u0686\u0631\u0627 \u062f\u0627\u062f\u0647 \u0647\u0627 \u0631\u0627 \u0639\u0627\u062f\u06cc \u06a9\u0646\u06cc\u0645\u061f<\/p>\n
\u062a\u0641\u06a9\u06cc\u06a9 \u0645\u0633\u0626\u0648\u0644\u06cc\u062a \u0647\u0627: \u062a\u0635\u0645\u06cc\u0645 \u06af\u06cc\u0631\u06cc \u0641\u0642\u0637 \u0628\u0631\u0627\u06cc \u0627\u062c\u0632\u0627\u06cc \u062e\u0627\u0631\u062c\u06cc \u0627\u0645\u06a9\u0627\u0646 \u067e\u0630\u06cc\u0631 \u0627\u0633\u062a\u060c \u0628\u0631\u0646\u0627\u0645\u0647 \u0628\u0647 \u0639\u0646\u0648\u0627\u0646 \u06cc\u06a9 \u0645\u0648\u062c\u0648\u062f\u06cc\u062a \u0645\u0633\u062a\u0642\u0644 \u062f\u0631 \u0646\u0638\u0631 \u06af\u0631\u0641\u062a\u0647 \u0645\u06cc \u0634\u0648\u062f.<\/p>\n
\u0622\u0632\u0645\u0627\u06cc\u0634 \u067e\u0630\u06cc\u0631\u06cc: \u0627\u0646\u0648\u0627\u0639 \u0648 \u0648\u0627\u0633\u0637 \u0647\u0627\u06cc\u06cc \u0631\u0627 \u0627\u06cc\u062c\u0627\u062f \u0645\u06cc \u06a9\u0646\u062f \u06a9\u0647 \u0628\u0647 \u0637\u0648\u0631 \u06a9\u0627\u0645\u0644 \u0628\u0647 \u0628\u0631\u0646\u0627\u0645\u0647 \u0645\u0631\u062a\u0628\u0637 \u0647\u0633\u062a\u0646\u062f\u060c \u067e\u06cc\u0634 \u0628\u06cc\u0646\u06cc \u067e\u0630\u06cc\u0631\u06cc \u0648 \u062a\u0645\u0633\u062e\u0631 \u0646\u062a\u0627\u06cc\u062c \u0631\u0627 \u062a\u0633\u0647\u06cc\u0644 \u0645\u06cc \u06a9\u0646\u062f.<\/p>\n
\u0645\u0633\u062a\u0646\u062f\u0627\u062a: \u0639\u0627\u062f\u06cc \u0633\u0627\u0632\u06cc \u06cc\u06a9 \u0645\u0633\u062a\u0646\u062f \u0636\u0645\u0646\u06cc \u0627\u0632 \u0642\u0627\u0644\u0628 \u062f\u0627\u062f\u0647 \u0645\u0648\u0631\u062f \u0627\u0646\u062a\u0638\u0627\u0631 \u0627\u06cc\u062c\u0627\u062f \u0645\u06cc \u06a9\u0646\u062f.<\/p>\n
const orders = await db.order.findMany();<\/p>\n
\/\/ [
\n\/\/ {
\n\/\/ “id”: 1,
\n\/\/ “customer_id”: 101,
\n\/\/ “product_id”: 202,
\n\/\/ “quantity”: 2,
\n\/\/ “total_price”: 59.99,
\n\/\/ “created_at”: “…”,
\n\/\/ “status”: “shipped”,
\n\/\/ “delivery_date”: “…”,
\n\/\/ “notes”: “FR\u00c1GIL”
\n\/\/ },
\n\/\/ …
\n\/\/ ]\n
type NormalizedOrder = {
\n orderId: number;
\n customerId: number;
\n productId: number;
\n quantity: number;
\n totalPrice: number;
\n status: string;
\n deliveryDate: string | null;
\n notes?: string;
\n};<\/p>\n
\/\/ normalizando generalizando
\nfunction normalizeOrders(orders: any[]): NormalizedOrder[] {
\n return orders.map((order) => ({
\n orderId: order.id,
\n customerId: order.customer_id,
\n productId: order.product_id,
\n quantity: order.quantity,
\n totalPrice: Number(order.total_price),
\n status: order.status,
\n deliveryDate: order.delivery_date
\n ? new Date(order.delivery_date).toISOString()
\n : null,
\n notes: order.notes,
\n }));
\n}<\/p>\n
\/\/ normalizando por adapter<\/p>\n
import { Order as PrismaOrder } from “@prisma\/client”;
\nimport { Order as MongoOrder } from “mongodb”;<\/p>\n
function normalizePrismaOrder(order: PrismaOrder[]): NormalizedOrder {
\n return {
\n orderId: order.id,
\n customerId: order.customer_id,
\n productId: order.product_id,
\n quantity: order.quantity,
\n totalPrice: Number(order.total_price),
\n status: order.status,
\n deliveryDate: order.delivery_date
\n ? new Date(order.delivery_date).toISOString()
\n : null,
\n notes: order.notes,
\n };
\n}<\/p>\n
function normalizeOrmOrder(order: MongoOrder[]): NormalizedOrder {
\n return {
\n orderId: order._id,
\n customerId: order.customerId,
\n productId: order.productId,
\n quantity: order.quantity,
\n totalPrice: order.totalPrice,
\n status: order.status,
\n deliveryDate: order.deliveryDate ? order.deliveryDate.toISOString() : null,
\n notes: order.notes,
\n };
\n}<\/p>\n
\u0648\u0627\u0631\u062f \u062d\u0627\u0644\u062a \u062a\u0645\u0627\u0645 \u0635\u0641\u062d\u0647 \u0634\u0648\u06cc\u062f<\/p>\n
\u0627\u0632 \u062d\u0627\u0644\u062a \u062a\u0645\u0627\u0645 \u0635\u0641\u062d\u0647 \u062e\u0627\u0631\u062c \u0634\u0648\u06cc\u062f<\/p>\n
\u062a\u0631\u062f\u0645\u06cc\u0644 \u062f\u0633\u062a\u0648\u0631\u0627\u0644\u0639\u0645\u0644 \u0647\u0627\u06cc\u06cc \u06a9\u0647 \u0645\u0646\u0637\u0642 \u0628\u06cc\u0634 \u0627\u0632 \u062d\u062f \u067e\u06cc\u0686\u06cc\u062f\u0647 \u0627\u06cc \u0646\u062f\u0627\u0631\u0646\u062f.<\/p>\n
import client as mailClient from “@sendgrid\/mail”;
\nimport { db } from “.\/db”;
\nimport dotenv from ‘dotenv’<\/p>\n
dotenv.config()<\/p>\n
const processOrder = async(data: {
\n order,
\n user_id
\n}, {
\n order: {
\n quantity: number;
\n item: string
\n }[],
\n user_id: string
\n}) => {<\/p>\n
const user = await db.user.findUnique({
\n where: {id: user_id}
\n })
\n if (order.quantity 0) {
\n console.log(“Invalid quantity”);
\n return;
\n }<\/p>\n
const validItems = [“Laptop”, “Smartphone”, “Tablet”];
\n if (!validItems.includes(order.item)) {
\n console.log(“Invalid item”);
\n return;
\n }<\/p>\n
const message = {
\n from: “store@gmail.com”,
\n to: user.email,
\n subject: “Compra realizada”,
\n body: `corpo do email`,
\n };<\/p>\n
const mailClient = mailClient.setApiKey(process.env.SENDGRID_KEY);<\/p>\n
const data = await client.send(message);<\/p>\n
return {ok: true}
\n}<\/p>\n
\u0648\u0627\u0631\u062f \u062d\u0627\u0644\u062a \u062a\u0645\u0627\u0645 \u0635\u0641\u062d\u0647 \u0634\u0648\u06cc\u062f<\/p>\n
\u0627\u0632 \u062d\u0627\u0644\u062a \u062a\u0645\u0627\u0645 \u0635\u0641\u062d\u0647 \u062e\u0627\u0631\u062c \u0634\u0648\u06cc\u062f<\/p>\n
import client as mailClient from “@mail”;
\nimport { db } from “.\/db”;
\nimport dotenv from ‘dotenv’<\/p>\n
dotenv.config()<\/p>\n
const ErrorMessages = {
\n INVALID_QUANTITY: “Invalid quantity”,
\n INVALID_ITEM: “Invalid item”,
\n USER_NOT_FOUND: “User not found”,
\n MAIL_NOT_SENT: “Mail not sent”,
\n} as const; \/\/ mensagem de erros instanciadas em uma \u00fanica fonte<\/p>\n
const getUserById = async(id: number) => {
\n const user = await db.user.findUnique({
\n where: { id }
\n })<\/p>\n
if (!user) {
\n console.log(ErrorMessages.USER_NOT_FOUND) \/\/ mensagem de erro padronizada
\n return null
\n }<\/p>\n
return user;
\n}<\/p>\n
const validateOrder = (order: {
\n quantity: number;
\n item: string;
\n}) => {
\n if (order.quantity 0) {
\n console.log(ErrorMessages.INVALID_QUANTITY); \/\/ mensagem de erro padronizada
\n return false;
\n }<\/p>\n
const validItems = [“Laptop”, “Smartphone”, “Tablet”];
\n if (!validItems.includes(order.item)) {
\n console.log(ErrorMessages.INVALID_ITEM);
\n return false;
\n }<\/p>\n
return true;
\n}<\/p>\n
const sendOrderRequestedMail = async (email_to: string) => {
\n const message = {
\n from: “store@gmail.com”,
\n to: email_to,
\n subject: “Compra realizada”,
\n body: “corpo do email”,
\n }<\/p>\n
const mailClient = mailClient.setApiKey(process.env.MAIL_CLIENT_KEY);<\/p>\n
const mailSent = await client.send(message);<\/p>\n
if(!mailSent) {
\n console.log(ErrorMessages.MAIL_NOT_SENT)
\n return { ok: false }
\n }
\n}<\/p>\n
const processOrder = async({
\n orders,
\n user_id
\n }: {
\n orders: {
\n quantity: number;
\n item: string;
\n }[],
\n user_id: number;
\n } ) => {<\/p>\n
const user = await getUserById(user_id); \/\/ desacoplamento do db<\/p>\n
if (!user) {
\n return {ok: false} \/\/ breakpoint
\n }<\/p>\n
for( const order of orders) {
\n if (!validateOrder(order)) {
\n return {ok: false} \/\/ breakpoint
\n }
\n }<\/p>\n
await sendOrderRequestedMail(user.email); \/\/ desacoplamento do mail<\/p>\n
return { ok: true }
\n}<\/p>\n
\u0648\u0627\u0631\u062f \u062d\u0627\u0644\u062a \u062a\u0645\u0627\u0645 \u0635\u0641\u062d\u0647 \u0634\u0648\u06cc\u062f<\/p>\n
\u0627\u0632 \u062d\u0627\u0644\u062a \u062a\u0645\u0627\u0645 \u0635\u0641\u062d\u0647 \u062e\u0627\u0631\u062c \u0634\u0648\u06cc\u062f<\/p>\n
\u0645\u0632\u0627\u06cc\u0627\u06cc \u0628\u0627\u0632\u0633\u0627\u0632\u06cc \u0645\u062c\u062f\u062f<\/p>\n
\u0627\u0646\u0639\u0637\u0627\u0641 \u067e\u0630\u06cc\u0631\u06cc : \u0628\u0627 \u0645\u0639\u0645\u0627\u0631\u06cc \u0645\u0627\u0698\u0648\u0644\u0627\u0631 \u0648 \u067e\u06cc\u0627\u0645 \u0647\u0627\u06cc \u062e\u0637\u0627\u06cc \u0627\u0633\u062a\u0627\u0646\u062f\u0627\u0631\u062f\u060c \u0627\u0636\u0627\u0641\u0647 \u06a9\u0631\u062f\u0646 \u0648\u06cc\u0698\u06af\u06cc \u0647\u0627\u06cc \u062c\u062f\u06cc\u062f \u0648 \u0627\u06cc\u062c\u0627\u062f \u062a\u063a\u06cc\u06cc\u0631\u0627\u062a \u062f\u0631 \u06a9\u062f \u0628\u062f\u0648\u0646 \u062a\u0623\u062b\u06cc\u0631\u06af\u0630\u0627\u0631\u06cc \u0628\u0631 \u0633\u0627\u06cc\u0631 \u0642\u0633\u0645\u062a \u0647\u0627\u06cc \u0633\u06cc\u0633\u062a\u0645 \u0622\u0633\u0627\u0646 \u062a\u0631 \u0627\u0633\u062a.
\n\u0642\u0627\u0628\u0644\u06cc\u062a \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u0645\u062c\u062f\u062f: \u062a\u0648\u0627\u0628\u0639 \u0631\u0627 \u0645\u06cc \u062a\u0648\u0627\u0646 \u062f\u0631 \u0632\u0645\u06cc\u0646\u0647 \u0647\u0627\u06cc \u0645\u062e\u062a\u0644\u0641 \u0627\u0633\u062a\u0641\u0627\u062f\u0647 \u06a9\u0631\u062f (\u0628\u0647 \u0639\u0646\u0648\u0627\u0646 \u0645\u062b\u0627\u0644 getUserById)
\n\u0628\u06cc\u0636\u0647 \u0647\u0627: \u062a\u0642\u0633\u06cc\u0645 \u06a9\u062f \u0628\u0647 \u0627\u06cc\u0646 \u0635\u0648\u0631\u062a \u0628\u0627\u0639\u062b \u0645\u06cc \u0634\u0648\u062f \u06a9\u0647 \u0633\u0627\u062e\u062a mock\u060c stub \u0648 spy \u0648 \u0633\u0646\u0627\u0631\u06cc\u0648\u0647\u0627\u06cc \u0622\u0632\u0645\u0627\u06cc\u0634\u06cc \u06a9\u0627\u0645\u0644 \u0628\u0627 \u06cc\u06a9 \u062a\u0634\u06a9 \u0633\u0627\u062f\u0647 \u0648 \u0648\u0627\u0636\u062d \u0622\u0633\u0627\u0646 \u0634\u0648\u062f\u060c \u0639\u0644\u0627\u0648\u0647 \u0628\u0631 \u0627\u06cc\u0646 \u0627\u0645\u06a9\u0627\u0646 \u062a\u0633\u062a \u062f\u0631 \u0645\u062d\u062f\u0648\u062f\u0647 \u0647\u0627\u06cc \u06a9\u0648\u0686\u06a9 \u062a\u0634\u06a9 \u0631\u0627 \u0646\u06cc\u0632 \u0641\u0631\u0627\u0647\u0645 \u0645\u06cc \u06a9\u0646\u062f \u06a9\u0647 \u0627\u0633\u0627\u0633\u0627\u064b \u0627\u0632 \u0639\u0644\u0644 \u0627\u06cc\u062c\u0627\u062f \u0646\u0642\u0627\u0637 \u0634\u06a9\u0633\u062a \u0647\u0633\u062a\u0646\u062f.<\/p>\n