E-Dobavki - שירות אינטרנט לחיפוש תוספי מזון ב-Java ו-Spring Boot, שנכתב על ידי התלמידים שלי

מבוא

כך קרה שבכמעט השנתיים האחרונות אני מלמד תכנות באחד מבתי הספר ל-IT בקייב. התחלתי לעשות את זה רק בשביל הכיף. פעם כתבתי בלוג תכנות ואז ויתרתי עליו. אבל הרצון לספר דברים שימושיים למתעניינים לא נעלם.

השפה העיקרית שלי היא ג'אווה. כתבתי בו משחקים לטלפונים ניידים, תוכנות לתקשורת רדיו ושירותי אינטרנט שונים. ואני מלמד ג'אווה.

כאן אני רוצה לספר את סיפור ההכשרה של הקבוצה האחרונה שלי. איך הם עברו מתחילת הכשרה לכתיבת שירות אינטרנט עובד. שירות אינטרנט שימושי למציאת תוספי תזונה. חינם, ללא פרסום, הרשמה ו-SMS.

השירות עצמו נמצא כאן - E-Dobavki.com.

הפרויקט הינו חינוכי ואינו מכיל פרסום. כפי שהבנתי מ פרסום זה, תוכל לספק קישורים לפרויקטים כאלה.

לפני תיאור הפרויקט עצמו, אספר לכם מעט על תהליך הלמידה של הקבוצה; בלעדיו, התמונה לא תהיה שלמה.

אימון של 9 חודשים

בבית הספר בו אני מלמד, קורס Java מחולק ל-2 חלקים. בסך הכל, הקורס אורך כ-9 חודשים, עם כל ההפסקות (חופשות ראש השנה, זמן כתיבת פרויקטי ביניים).

החלק הראשון מציג בפני התלמידים את המושגים הבסיסיים של השפה. משתנים, שיטות, יסודות OOP וכל הדברים האלה.

החלק השני של הקורס מספק שהתלמיד כבר פחות או יותר מבין איך לכתוב בג'אווה, וניתן לתת לו ערימת טכנולוגיה "למבוגרים". הכל מתחיל עם SQL, ואז JDBC, Hibernate. ואז HTTP, servlets. הבא הוא אביב, קצת על git and maven. וסטודנטים כותבים פרויקטי גמר.

כל ההכשרה מחולקת למודולים. העברתי שיעורים פעמיים בשבוע. משך שיעור אחד הוא שעתיים.

הגישה שלי ללמידה

שחררתי 5 קבוצות. זה נראה כמו הרבה במשך שנתיים, אבל כמעט תמיד הובלתי 2 קבוצות במקביל.

ניסיתי גישות שונות.

האפשרות הראשונה היא שמוקצה זוג אחד למצגת עם תיאוריה. הזוג השני הוא תרגול טהור. גישה זו עבדה איכשהו, אבל היא לא הייתה יעילה במיוחד, לדעתי.

האפשרות השנייה שהגעתי אליה ושאני עובדת עליה עכשיו היא לא להקדיש זוג שלם לתיאוריה. במקום זאת, אני מערבב קטעים קצרים של תיאוריה במשך 5-10 דקות, ומיד מחזק אותם בדוגמאות מעשיות. גישה זו עובדת טוב יותר.

אם יש מספיק זמן, אני קורא לתלמידים למקום שלי, מושיב אותם ליד המחשב הנייד שלי, והם עושים דוגמאות מעשיות בעצמם. זה עובד נהדר, אבל למרבה הצער זה לוקח הרבה זמן.

לא כולם מגיעים עד הסוף

גילוי עבורי היה העובדה שלא כל הקבוצה מגיעה לסוף הקורס.

לפי התצפיות שלי, רק מחצית מהסטודנטים כותבים את פרויקט הגמר. רובם מודחים במהלך החלק הראשון של הקורס. ומי שהגיע לחלק השני בדרך כלל לא נופל.

הם עוזבים מסיבות שונות.

הראשון הוא מורכבות. לא משנה מה יגידו, ג'אווה היא לא השפה הפשוטה ביותר. כדי לכתוב אפילו את התוכנית הפשוטה ביותר, אתה צריך להבין את הרעיון של מחלקה, שיטה. וכדי להבין למה צריך לכתוב public static void main(String[] arg) יש עוד כמה מושגים שצריך להבין.

השווה את זה לטורבו פסקל, שזה מה שאנשים רבים התחילו איתו, כולל אני:

begin
    writeln("Первая программа");
end.

עד כמה שידוע לי, בית הספר יפתור בעיה זו על ידי הכנסת בדיקות נוספות. עכשיו לא כולם יכולים ללמוד ג'אווה. זה עדיין בשלב הרעיון, אבל ברור שהשלב הוא הנכון.

והסיבה השנייה היא כמו בתמונה למטה:

לעתים קרובות אנשים חושבים שתכנות עוסקת בהקלדת טקסט רב וקבלת כסף רב עבורו. כמו קופירייטר, רק יותר כסף.

המציאות היא קצת אחרת. הרבה קוד שגרתי, באגים לא ברורים, תהליך למידה מתמיד. זה מעניין, אבל לא לכולם.

אלו הסטטיסטיקות. בהתחלה זה הרגיז אותי, חשבתי שאולי אני עושה משהו לא בסדר. עכשיו אני מבין שהסטטיסטיקה זהה בערך עבור רוב הקורסים. עכשיו אני לא דואג לזה, אבל מלמד את האנשים שמתעניינים בזה.

רעיון שירות

לאחר שהתלמידים סיימו את כל הקורס, הגיע הזמן לכתוב את פרויקט הגמר. היו רעיונות שונים. הם הציעו גיליונות ToDo, פרויקטים של ניהול פרויקטים ומשהו אחר.

רציתי לעשות משהו פשוט אבל שימושי. הקריטריון שלי היה פשוט - האם אני וחבריי יכולים להשתמש בו. שירות אינטרנט לחיפוש תוספי מזון עמד בדרישות אלו.

הרעיון פשוט. כאשר אתה קונה מוצר בחנות, אתה רואה סוג של תוסף E בהרכב. לא ברור מהקוד עד כמה זה מסוכן או לא (ויש גם תוספים מסוכנים שאסורים במדינות רבות).

פותחים את האתר, מכניסים את שם המוסף (מספר, אחד מהשמות החלופיים), ומקבלים תקציר של המוסף:

יש פרויקטים דומים. אתה יכול גם פשוט להקליד את התוסף בגוגל, למרות שהוא לא תמיד מציג את המידע בצורה נכונה.

אבל מכיוון שהפרויקט הוא חינוכי, הקשיים למעלה לא עצרו אותנו :)

Реализация

כולם כתבו בג'אווה, קוד המקור של הפרויקט ב-Github.

היינו 7, כולל אני. כולם הגישו בקשת משיכה, ואני, או אדם אחר מהקבוצה, קיבלתי את בקשת המשיכה הזו.

יישום הפרויקט ארך כחודש - מהבעת הרעיון ועד למצב שאתה רואה כעת.

ניתוח תוספים

הדבר הראשון שאחד התלמידים עשה, מלבד יצירת מסגרת בסיסית סביב מסד הנתונים (ישויות, מאגרים וכו'), היה ניתוח תוספות מאתר מידע קיים.

זה היה נחוץ כדי לבדוק את הנקודות הנותרות. אין צורך בקוד נוסף כדי לאכלס את מסד הנתונים. לאחר ניתוח מהיר של מספר תוספים, נוכל להמשיך לבדוק את ממשק המשתמש, המיון והסינון.

Spring Boot מאפשר לך ליצור מספר פרופילים. פרופיל הוא קובץ עם הגדרות.

עבור סביבת הפיתוח, השתמשנו בפרופיל עם H2 DBMS מקומי ויציאת HTTP ברירת המחדל (8080). כך, בכל פעם שהאפליקציה הושקה, מסד הנתונים נוקה. המנתח במקרה הזה היה הדבר שהציל אותנו.

חיפוש וסינון

נקודה חשובה היא חיפוש וסינון. אדם בחנות חייב ללחוץ במהירות על הקוד של התוסף, או על אחד השמות, ולקבל את התוצאה.

לכן, לישות Additive יש מספר שדות. זהו הקוד התוסף, שמות חלופיים, תיאור. החיפוש מתבצע באמצעות Like בכל השדות בו זמנית. ואם תזין [123] או [אמרנט], תקבל את אותה תוצאה.

עשינו את כל זה על סמך מפרטים. זהו חלק מ-Spring המאפשר לך לתאר תנאי חיפוש בסיסיים (כמו שדה כלשהו, ​​למשל), ולאחר מכן לשלב את התנאים הללו (OR או AND).

לאחר שכתבת תריסר מפרטים, אתה יכול לשאול שאילתות מורכבות כמו "כל תוספי הצביעה המסוכנים שיש להם את המילה [אדום] בתיאור."

מבחינת עבודה עם מסד הנתונים של Spring, אני מוצא את זה מאוד נוח. זה נכון במיוחד כאשר עובדים עם שאילתות מורכבות. אני מבין שיש לזה תקורה משלו, וששאילתת SQL שנכתבה ידנית ומוטבת תפעל מהר יותר.

אבל אני גם דבק בנקודת המבט שאין צורך לייעל הכל מראש. הגרסה הראשונה חייבת להתחיל, לעבוד ולאפשר החלפה של חלקים בודדים. ואם יש עומס, יש לשכתב את החלקים הבודדים האלה.

אבטחה

זה פשוט. ישנם משתמשים עם תפקיד ADMIN - הם יכולים לערוך תוספות, למחוק אותן ולהוסיף חדשות.

ויש עוד משתמשים (רשומים או לא). הם יכולים רק לעיין ברשימת התוספים ולחפש את אלה שהם צריכים.

Spring Security שימש להפרדת זכויות. נתוני המשתמש מאוחסנים במסד נתונים.

משתמשים יכולים להירשם. עכשיו זה לא נותן כלום. אם התלמידים ימשיכו לפתח את השירות ולהציג כמה פונקציות מותאמות אישית, הרישום יהיה שימושי.

מהירות תגובה ו-Bootstrap

הנקודה הבאה היא הסתגלות. במקרה של השירות שלנו (לפחות כפי שראינו אותו), רוב המשתמשים יהיו עם טלפונים ניידים. ואתה צריך לראות במהירות את התוסף מהטלפון הנייד שלך.

כדי לא לסבול עם CSS, לקחנו Bootstrap. זול, עליז, ונראה הגון.

אני לא יכול לקרוא לממשק אידיאלי. העמוד הראשי אפילו פחות, והעמוד לתיאור מפורט של התוסף צר; בטלפונים ניידים צריך להרחיב אותו.

אני יכול רק לומר שניסיתי להפריע לעבודה כמה שפחות. זה עדיין פרויקט של סטודנטים. וכמובן, החבר'ה יוכלו לתקן רגעים כאלה אחר כך.

דקה של אופטימיזציה של SEO

מכיוון שאני מעורב באופן הדוק באתרים ובכל מה שקשור לקידום אתרים כבר יותר משנתיים, לא יכולתי לשחרר פרויקט ללא אופטימיזציה של SEO בסיסית לפחות.

למעשה, יצרתי יצירת תבנית של כותרת ותיאור עבור כל תוסף. כתובת האתר היא כמעט CNC, אם כי ניתן לקצר אותה.

הוספתי גם מוני נוכחות. הוסיף את האתר ל-Yandex Webmaster ול-Google Search Console כדי לנטר אזהרות ממנועי חיפוש.

זה לא מספיק. אתה צריך גם להוסיף robots.txt ו-sitemap.xml לאינדקס מלא. אבל שוב, זה פרויקט של סטודנטים. אני אגיד להם מה צריך לעשות, ואם הם רוצים, הם יעשו את זה.

עליך לצרף אישור SSL. גם ה-Let's Encrypt החינמי יעבוד. עשיתי את זה עבור Spring Boot. זה לא קשה לעשות, והאמון של ה-PS גובר.

מה הלאה בפרויקט?

ואז, למעשה, הבחירה היא של החבר'ה. הרעיון המקורי של הפרויקט כלל גם מאגר מוצרים עם קישורים לתוספים.

היכנסו ל"סניקרס" וראו אילו תוספים תזונתיים הוא מכיל.

כבר בתחילת הפרויקט ידעתי שלא יהיו לנו מוצרים :) לכן התחלנו רק עם תוספים.

עכשיו אתה יכול להוסיף מוצרים ולהציג מוצרים נוספים. לחמניות. אם מדובר במסד נתונים נרחב, יהיו משתמשים.

פְּרִיסָה

הפרויקט נפרס ב-VPS, Aruba Cloud. זהו ה-VPS הזול ביותר שיכולנו למצוא. אני משתמש בספק זה יותר משנה עבור הפרויקטים שלי, ואני מרוצה ממנו לטובה.

מאפייני VPS: 1 GB RAM, 1 CPU (אני לא יודע לגבי התדר), 20 GB SSD. לפרויקט שלנו זה מספיק.

הפרויקט נבנה באמצעות החבילה הרגילה של mvn clean. התוצאה היא fat jar - קובץ הפעלה עם כל התלות.

כדי להפוך את כל זה קצת לאוטומטי, כתבתי כמה סקריפטים של bash.

הסקריפט הראשון מוחק את קובץ ה-jar הישן ובונה קובץ חדש.

הסקריפט השני מפעיל את הצנצנת המורכבת, ומעביר לו את שם הפרופיל הנדרש. פרופיל זה מכיל מידע על חיבור מסד נתונים.

DB - MySQL על אותו VPS.

סה"כ הפעלה מחדש של הפרויקט כוללת:

• היכנס ל-VPS באמצעות SSH
• הורד את השינויים האחרונים ב-Git
• הפעל את local-jar.sh
• להרוג יישום פועל
• להפעיל launch-production.sh

הליך זה נמשך שלוש דקות. זו נראית לי בחירה חכמה לפרויקט כל כך קטן.

קשיים

הקשיים העיקריים ביצירת הפרויקט היו בעלי אופי ארגוני.

יש קבוצה של אנשים שנראה שהם יודעים לתכנת, אבל לא כל כך טוב. הם יודעים משהו, אבל הם עדיין לא באמת יכולים ליישם אותו. ועכשיו הם צריכים להשלים את הפרויקט בעוד חודש.

זיהיתי ראש צוות מותנה בקבוצה הזו. הוא שמר על Google Doc עם רשימה של משימות, הפיץ משימות ושלט בקבלה שלהן. הוא גם קיבל בקשות משיכה.

כמו כן ביקשתי מהתלמידים לכתוב מדי ערב דוח קצר על העבודה שהם עשו בפרויקט. אם לא עשית כלום, בסדר, פשוט כתוב "לא עשית כלום". זהו תרגול נהדר ומכניס אותך מעט למתח. לא כולם פעלו לפי הכלל הזה, למרבה הצער.

המטרה של כל התנועה הזו הייתה פשוטה. להקים צוות, גם אם רק לזמן קצר, לעבוד יחד.

רציתי שהחבר'ה ירגישו שהעבודה שלהם חשובה. להבין שהם לא כותבים קוד כדורי בחלל ריק. ומה שהם עושים ביחד זה פרויקט שאנשים ישתמשו בו.

השבוע-שבועיים הראשונים היו הצטברות. ישויות והתחייבויות קטנות נעשו באיטיות. לאט לאט ערשתי אותם, והעבודה הפכה למהנה יותר. התקשורת בצ'אט הפכה חיה יותר, התלמידים הציעו את התוספות שלהם.

אני מאמין שהמטרה הושגה. הפרויקט הסתיים, החבר'ה קיבלו קצת ניסיון בעבודה בצוות. יש תוצאה גלויה, מוחשית שאפשר להראות לחברים ולפתח עוד.

ממצאים

הלמידה היא מעניינת.

אחרי כל שיעור חזרתי נסערת רגשית. אני מנסה להפוך כל זוג לייחודי ולהעביר כמה שיותר ידע.

זה נחמד כשהקבוצה שאני מלמד מגיעה לגמר. זה מגניב במיוחד כשחבר'ה כותבים "קיבלתי עבודה, הכל בסדר, תודה." גם אם זה זוטר, גם אם זה לא הכסף הכי גדול בהתחלה. אבל הכי חשוב שהם עשו צעד לקראת הרצונות שלהם, והם הצליחו.

למרות שהכתבה התבררה כענפה למדי, בהחלט לא ניתן היה לכסות את כל הנקודות. לכן, כתוב את שאלותיך בתגובות.

מקור: www.habr.com