CodeQuest: ბიტის თავგადასავალი
სასწავლო თამაში, რომელიც პროგრამირებას ნულიდან გასწავლის — 19 ენაზე: JavaScript, TypeScript, Node.js, Python, Java, C, C++, C#, Go, Rust, PHP, Ruby, Swift, Kotlin, Lua, Dart, HTML, CSS და React. რობოტ ბიტს კოდით მართავ: წერ ბრძანებებს, უშვებ და უყურებ, როგორ ასრულებს მათ ბიტი რუკაზე. HTML-სა და CSS-ში ბიტის ვებგვერდს აწყობ, React-ში კი ინტერაქტიურ აპს — და შედეგს მაშინვე ხედავ. თამაში მთლიანად ქართულადაა, შეცდომების ახსნის ჩათვლით.
ყოველ ენაზე კურსი 500 ლეველია (19 ენაზე სულ 9500), იხ. 500 ლეველი ყოველ ენაზე.
ბმული იმუშავებს მას შემდეგ, რაც რეპოში GitHub Pages ჩაირთვება (იხ. GitHub Pages-ზე გამოქვეყნება).
როგორ ვსწავლობთ: ნახე → ააწყე → შენით
ყოველი ახალი თემა სამ ნაბიჯად ისწავლება:
- 👀 ნახე — ახსნა მოკლე ბარათებად და კოდი, რომელიც თვალწინ იწერება. მაგალითი ნამდვილად ეშვება: ან ბიტი ასრულებს მას დაფაზე, ან ეკრანზე ჩანს, რა დაიბეჭდა.
- 🧩 ააწყე — Duolingo-ს სტილი: იგივე კოდში ყველაზე მნიშვნელოვანი სიტყვები (ბრძანებები, საკვანძო სიტყვები, რიცხვები, HTML-ის ტეგები, CSS-ის თვისებები) ცარიელ ადგილებად იქცევა, ქვემოთ კი ბლოკებია. დააჭერ ბლოკს და ის მოციმციმე ადგილზე ჩაჯდება. 2–3 ბლოკი ზედმეტია და სწორს ჰგავს (
turn_left ↔ turn_right, 2 ↔ 3, h1 ↔ header). შეცდომაზე ბლოკი წითლდება და ირხევა, ორი შეცდომის შემდეგ სწორი ბლოკი ანათებს. კომპიუტერზე ბლოკი კლავიშებით 1–9-ც ირჩევა. ბეჭდვა არ გჭირდება, ამიტომ ტელეფონზეც მოსახერხებელია. პირველი აწყობა +20 XP-ს მოგცემს.
- ⚙️ პარამეტრები → სწავლის სტილი: ბლოკების ნაცვლად შეგიძლია აირჩიო ✍️ ასო-ასო გადაწერა. ამ დროს მაგალითს ერთხელ ხელით გადაწერ: სწორი ასო მწვანდება, შეცდომა წითლდება, ითვლება სიზუსტე, სიჩქარე და კომბო 🔥. ქართული ტექსტი, კომენტარები და შეწევა თავისით ჩაიწერება.
- 🚀 შენით — მისიას თავად წერ. ბრძანებები ღილაკის დაჭერით აღარ ჩაიწერება: ღილაკები მხოლოდ ძნელად ასაკრეფ სიმბოლოებს სვამს (
( ) ; { } " და სხვ.), ბიტის ბრძანებების სია კი ცნობარად ჩანს.
პრაქტიკაზე, ბოსზე და უკვე გავლილ ლეველზე პირდაპირ „შენით“ იწყება. გაკვეთილის ხელახლა სანახავად ნაბიჯების ზოლში „1 ნახე“ დააჭირე.
რეალური პროექტები
ყოველი სამყაროს ბოსის შემდეგ იხსნება რეალური პროექტი: პატარა აპი, რომლის კოდიც ნამდვილ პროგრამებში ზუსტად ასე იწერება. შედეგი ტელეფონის ეკრანზე ჩანს, კოდი კი რამდენიმე ტესტზე მოწმდება სხვადასხვა მონაცემით. თუ, მაგალითად, "სულ: " + pizzas + delivery დაწერე, აპი „სულ: 245 ლარი“-ს აჩვენებს 29-ის ნაცვლად — ზუსტად ის შეცდომა, რასაც ნამდვილი პროგრამისტებიც უშვებენ.
| სამყარო | პროექტი | რას აკეთებს |
|---|
| 2 | 🪪 პროფილის ბარათი | ცვლადებიდან აწყობს პროფილს |
| 3 | 🍕 პიცის შეკვეთა | ითვლის კალათის ჯამს მიტანით |
| 4 | 🎬 კინოს ბილეთი | ასაკის მიხედვით ირჩევს ბილეთს |
| 5 | 🚀 რაკეტის გაშვება | უკუთვლა ციკლით |
| 6 | 🧾 ჩაის ფულის კალკულატორი | ფუნქცია, რომელიც პასუხს აბრუნებს |
| 7 | 🛒 საყიდლების კალათა | ჩეკი ორი მასივიდან |
| 8 | ⛅ ამინდის აპი | ობიექტის მონაცემები და პირობა |
| 9 | 🏆 ლიდერბორდი | სამი საუკეთესო შედეგი |
| 10 | 🔐 პაროლის შემმოწმებელი | პაროლის სიძლიერის შემოწმება |
ენები
| ენა | კურსი | რას ისწავლი |
|---|
| JavaScript | 500 ლეველი, 10 სამყარო | სრული თავგადასავალი: ცვლადები, პირობები, ციკლები, ფუნქციები, მასივები, ობიექტები, ალგორითმები |
| Python | 500 ლეველი | შეწევით დაწერილი ბლოკები, print, if/elif, for/range, while, def |
| Java | 500 ლეველი | ტიპები, System.out.println, პირობები, ციკლები, მეთოდები |
| C | 500 ლეველი | main(), #include, printf, ტიპები, ფუნქციები |
| C++ | 500 ლეველი | cout, string, პირობები, ციკლები, ფუნქციები |
| TypeScript | 500 ლეველი | ტიპები (number, string, boolean), let/const, console.log, პირობები, ციკლები, ფუნქციები |
| C# | 500 ლეველი | Console.WriteLine, int/string/var, $"...", foreach, მეთოდები დიდი ასოთი (Move()) |
| Go | 500 ლეველი | package main, :=, fmt.Println, ერთადერთი ციკლი — for, ფუნქციები |
| Rust | 500 ლეველი | fn main, let/let mut, println!, დიაპაზონები 0..10, step() (move Rust-ში დაკავებულია) |
| PHP | 500 ლეველი | <?php, $ცვლადები, echo, ტექსტის შეერთება .-ით, foreach, ფუნქციები |
| Ruby | 500 ლეველი | ბრძანებები ფრჩხილების გარეშე, 10.times do, , , |
დანარჩენი რობოტის ენების კურსებში იგივე ბიტი და იგივე რუკებია, ოღონდ კოდს ნამდვილი ენის სინტაქსით წერ: Python-ში turn_left() და შეწევა, C-ში int main(), printf და ;, C#-სა და Go-ში Move(), Ruby-ში move და wall_ahead?, Rust-ში step(). ბეჭდვაც ნამდვილივით ხდება: Go [1 2 3]-ს ბეჭდავს, C# — True-ს, Kotlin და Lua — 3.0-ს. ყოველ ენას აქვს საკუთარი რუკა (ლეველები თემების მიხედვით კუნძულებადაა დაყოფილი, როგორც JavaScript-ში), შპარგალკა, ბოსი ბაგიანი კოდით და საკუთარი სერტიფიკატი. HTML-სა და CSS-ში გვერდი მარჯვნივ ცოცხლად განახლდება, ხოლო ▶ შემოწმება დავალების ყველა პუნქტს სათითაოდ ამოწმებს.
React-ში კოდი ნამდვილ React 18-ზე ეშვება (function App() { … }, useState, useEffect; import/export ხაზებიც შეიძლება). JSX-ს პატარა ჩაშენებული კომპილატორი თარგმნის, აპი კი იზოლირებულ iframe-ში ეშვება. მარჯვენა გადახედვა ინტერაქტიულია: ღილაკებს აჭერ და ველებში წერ. ▶ შემოწმება აპს რამდენჯერმე თავიდან უშვებს, თვითონ აჭერს ღილაკებს და წერს ველებში, მერე კი შედეგს ამოწმებს. console.log კონსოლში ჩანს, შეცდომები კი ქართულად იხსნება: დაუხურავი ტეგი ხაზის ნომრით, უცნობი ცვლადი, onClick={f()}-ით გამოწვეული უსასრულო გადახატვა, უსასრულო ციკლი. ბოსებში გლიჩი ტიპურ ბაგებს მალავს: class className-ის ნაცვლად, onclick, დაკარგული key, push ახალი მასივის ნაცვლად.
500 ლეველი ყოველ ენაზე
ყოველი ენის კურსი 500 ლეველია (HTML-ში, CSS-სა და React-ში — 500 გაკვეთილი), 19 ენაზე სულ 9500. რუკაზე ლეველები თავებადაა (კუნძულებად) დალაგებული და რიგრიგობით იხსნება. კუნძულებს ნომერი არ აწერია: ყოველ კუნძულზე ჩანს, კურსის რომელი ლეველები უჭირავს (მაგალითად, ბოლოზე — 489–500), და ყოველ ლეველს თავისი წერტილი აქვს.
- ახალი თემა იწყება ხელით დაწერილი ლეველით, „ნახე → ააწყე → შენით“ სწავლებით. ასეთი ლეველები JavaScript-ში 50-ია (10 სამყაროში), დანარჩენ 14 რობოტის ენაზე — 12, HTML-სა და CSS-ში — 10.
- მის შემდეგ მოდის სავარჯიშო თავები: თითოში 11–13 ლეველია იმავე თემაზე, და ისინი თანდათან რთულდება.
- ყოველი თავის ბოლოს ბოსია 👾: კოდი უკვე დაწერილია, მაგრამ გლიჩმა მასში 1–3 ბაგი ჩადო.
- კურსის მეორე ნახევარში ახალი გამოწვევებია:
- რობოტის ენები (ყველა, HTML-ისა და CSS-ის გარდა):
- ახალი მექანიკები: სარკის ასლი 🪞, ტელეპორტები ✨,
go() მიმართულებები, კოორდინატები (getX(), flagX());
- გამოთვლები და პირობები: მთელი გაყოფა და ნაშთი,
else if ჯაჭვები, შუქნიშნები;
- მარშრუტები: ოთახის შემოვლა, გველის მარშრუტი
% 2-ით, ნამდვილი ლაბირინთები (მარჯვენა ხელის წესი);
- ფუნქციები და ალგორითმები: რეკურსია, ორობითი ძებნა, დალაგება, მასივები, ციფრების ამოცანები;
- ბოლოს — მრავალსაფეხურიანი მისიები და ოსტატის გამოცდები.
- HTML: რადიო-ღილაკები,
datalist, rowspan, details, dl, meta, ხელმისაწვდომობა (aria-label), entity-ები, სტატიები, საიტის ჩონჩხი, ბლოგი და სადესანტო გვერდი.
- CSS:
em/rem/%, rgb()/hsl(), box-sizing, გრადიენტები, position, z-index, Flexbox III, Grid II, ::before/::after, :nth-child(3n), ატრიბუტის სელექტორები, transform, CSS ცვლადები და პროექტები.
- JavaScript-ის ისტორია იგივე რჩება: საბოლოო სამყარო, „გლიჩის ციხე“, კურსის ბოლოს არის (ლეველები 496–500).
- ბევრ ლეველს რამდენიმე ტესტ-რუკა აქვს, ამიტომ კოდი ზოგადი უნდა იყოს: სენსორებით, ციკლებით და ცვლადებით.
- XP: სავარჯიშო ლეველი 50 XP-ს იძლევა, თავის ბოსი — 150-ს.
JavaScript-ის სამყაროები
| # | სამყარო | თემა |
|---|
| 1 | 🌱 მწვანე ველი | პირველი ნაბიჯები |
| 2 | 🌲 რიცხვების ტყე | ცვლადები |
| 3 | ⛰️ კალკულატორის მთა | ოპერატორები |
| 4 | 🚦 გზაჯვარედინის ქალაქი | პირობები |
| 5 | 🌊 მარადიული მდინარე | ციკლები |
| 6 | 🔧 ხელოსნის სახელოსნო | ფუნქციები |
| 7 | 📦 საწყობის ქვესკნელი | მასივები |
| 8 | 🏙️ ობიექტების ქალაქი | ობიექტები |
| 9 | 🗼 ალგორითმების კოშკი | ალგორითმები |
| 10 | 🏰 გლიჩის ციხე | საბოლოო გამოცდა |
თითოეულ სამყაროში 5 ლეველია: სამი ახალ თემაზე, ერთი სავარჯიშო და ბოსი. ბოლო ბოსს (გლიჩს) 3 ფაზა აქვს. სამყაროებს შორის სავარჯიშო თავებია, ამიტომ JavaScript-ის კურსში სულ 500 ლეველია.
შესაძლებლობები
-
ყოველ სამყაროს თავისი სახე აქვს: ბალახი და ხეები, ტყე, მთა, ქალაქი, მდინარე, სახელოსნო... ლეველის ეკრანზე ერთი „მისიის“ ბარათია — ვინ რას ამბობს, რა უნდა გააკეთო და „💡 როგორ?“ ახსნა მაგალითით.
-
კოდის რედაქტორი ფერადი სინტაქსით, დიდი ფერადი ბრძანების ღილაკები დამწყებთათვის, ნაბიჯ-ნაბიჯ რეჟიმი და ცვლადების პანელი.
-
შეცდომები ქართულად ყველა ენაზე: თამაში ხსნის, რა მოხდა, და ხაზს მიუთითებს — მაგ. „ხაზის ბოლოს ; აკლია“, „Python-ში ეს ბრძანება ასე იწერება: turn_left()“, „printf-ისთვის საჭიროა #include <stdio.h>“.
-
ვარსკვლავები: ⭐ გავლა · ⭐⭐ ≤ 3 ცდით · ⭐⭐⭐ მინიშნებების გარეშე და ოპტიმალური კოდით. ზედა ზოლში ყოველთვის ჩანს, რამდენი ვარსკვლავის აღება შეგიძლია ახლა.
-
XP, რანგები და 55 მიღწევა (მათ შორის „პოლიგლოტი“, „სნაიპერი“ — უშეცდომოდ აწყობილი კოდი — „აპების ოსტატი“ და „მოდის ხატი“). XP-ით იხსნება რედაქტორის თემებიც.
-
👕 ბიტის გარდერობი — მთავარ ლოგოზე დაჭერით იხსნება. ბიტი დიდად ჩანს სცენაზე, 8 კატეგორიაა: ფერი, ქუდები, ტანსაცმელი, სათვალე, კისერზე, ზურგზე, ფეხსაცმელი, ანტენა. 275 უნიკალური ნივთია: ყოველი ფორმა მხოლოდ ერთხელ, ფერადი ასლების გარეშე. მაგალითად 18 პროგრამირების ენის მაისური, ჩოხა, ნაბადი, საქართველოს დროშა, კიმონო, დრაკონის ფრთები და ლაზერის თვალები. ვინც ფერადი ასლი ადრე იყიდა, მისთვის ის რჩება.
- 6 იშვიათობა: ჩვეულებრივი (ნაცრისფერი), არაჩვეულებრივი (მწვანე), იშვიათი (ლურჯი), ეპიკური (იისფერი), ლეგენდარული (ნარინჯისფერი, ბრწყინავს) და მითიური (ცისარტყელას ჩარჩოთი). ბარათის ფონი და ჩარჩო იშვიათობის ფერისაა, ფასიც იშვიათობაზეა დამოკიდებული: დაახლოებით 150-დან 4000 XP-მდე. ნივთებს იშვიათობით ფილტრავ და ალაგებ.
- ფერები: ჩვეულებრივი ფერები უფასოა, იშვიათები (ოქრო, ყინული, ლავა, გალაქტიკა, ცისარტყელა...) XP-ით იყიდება. სულ 29 ფერია, ერთი ფერის ღია და მუქი ჩრდილების გარეშე.
- ნივთები ფორმისა (შაბლონის) და ფერის (პალიტრის) შეხამებით იქმნება:
CodeQuest.html-ის ბლოკი ===WARDROBE===. მაღაზიაში ყოველი ფორმიდან ერთი ჩანს; დანარჩენ ფერად ასლებს retired აქვთ და მხოლოდ მათ ყიდველებს უჩანთ. ⚠️ ნივთის id-ს (შაბლონი-პალიტრა) ნუ შეცვლი — ნაყიდი ნივთები მისით ინახება.
ნივთზე დაჭერით ჯერ მოსინჯავ — ბიტს ეკრანზე აცვია — და მერე ყიდულობ. XP-ის ხარჯვა წოდებას არ ამცირებს: წოდება მთელ მოგებულ XP-ს ითვლის, საფულეში კი მოგებულს გამოკლებული დახარჯული რჩება. ნაყიდი ტანსაცმელი ბიტს თამაშის დაფაზეც აცვია.
-
დღის გამოწვევა (ყოველ დღე ახალი რუკა) და დღის სერია 🔥.
-
🚩 ქვესთები (მთავარ მენიუში; ასაღები ჯილდოების რაოდენობა რუკის ზედა ზოლშიც ჩანს):
📚 სკოლა „ისწავლე კოდინგი“ (/learn)
თამაშის გვერდით საიტს აქვს სკოლა: 25 კურსი, თითოში 4 დონე (დამწყები → ექსპერტი), მოდულები და მოკლე თავები ახსნით, გასაშვები კოდით, სავარჯიშოთი და მინი-ქვიზით. გვერდები: მთავარი, კატალოგი, კურსი (სილაბუსი), თავი, მოდულის ქვიზი, სასწავლო გზები, პირადი დაფა, ძებნა (Ctrl+K).
კონტენტი კოდისგან გამოყოფილია. ახალი თავის დასამატებლად საიტის კოდი არ იცვლება:
| რა | სად |
|---|
| კურსის რუკა (დონეები, მოდულები, თავების სათაურები) | curriculum/{კურსი}.json |
| თავის ტექსტი | content/{კურსი}/{დონე}/{მოდული}/{თავი}.mdx |
| მოდულის ქვიზი / დონის პროექტი | …/{მოდული}/quiz.mdx, …/{დონე}/project.mdx |
| ფორმატის აღწერა | content/README.md |
school/build.js ამ ფაილებიდან აწყობს სტატიკურ გვერდებს საქაღალდეში learn/ (git-ში არ ინახება), ძებნის ინდექსს და sitemap.xml-ს. Vercel-ზე ეშვება ყოველ deploy-ზე (vercel.json → buildCommand); ლოკალურად: node school/build.js. დამოკიდებულებები არ აქვს.- თავი, რომლის ფაილიც არსებობს, იხსნება; დანარჩენი „მალე“ ნიშნით ჩანს. იგივე ეხება კურსს სილაბუსის გარეშე. კონტენტის შეცდომა აწყობას არ აჩერებს: გაფრთხილებად იბეჭდება.
- თვითშემოწმება:
node school/test.js.
school/learn.js: პროგრესი, ქვიზები, ძებნა, დაფა და კოდის გაშვება. JavaScript ცალკე ნაკადში (Worker) ეშვება 3-წამიანი ლიმიტით, HTML — იზოლირებულ iframe-ში. სხვა ენებზე „გაუშვი“ მოსალოდნელ შედეგს აჩვენებს.- 👑 სკოლა Pro-ს ნაწილია. მთავარი, კატალოგი, სილაბუსი და სასწავლო გზები ყველასთვის ღიაა; თავის, ქვიზის და პროექტის შინაარსი იხსნება მხოლოდ Pro-ანგარიშით.
learn.js ამოწმებს სერვერის ხელმოწერილ ნიშანს იმავე საჯარო გასაღებით, რაც თამაშშია (build.js მას CodeQuest.html-იდან იღებს), სერვერის მოქმედება school კი Pro-ს გარეშე უარს ამბობს. თავის ტექსტი გვერდის HTML-შია (ძებნის სისტემებისთვის), ამიტომ ეს დაცვა ისეთივეა, როგორიც თამაშში.
- პროგრესი: ბრაუზერში (
codequest.school) და ანგარიშში (school:<ანგარიში>, მოქმედება school). სერვერი მოწყობილობების მდგომარეობას აერთიანებს, ამიტომ კონფლიქტი არ ხდება. ანგარიში იგივეა, რაც თამაშში; შესვლა თამაშის გვერდზე ხდება და უკან აბრუნებს.
- კომპიუტერის პროგრამაში (1.0.2-დან) სკოლა პროგრამის შიგნით იხსნება:
desktop/main.js გვერდებს საიტიდან იღებს და ნანახის ასლს ინახავს (ინტერნეტის გარეშეც იხსნება). პროგრესი იქ, როგორც თამაშისა, მხოლოდ კომპიუტერში ინახება. ტელეფონზე დაყენებულ აპში სკოლა ჩვეულებრივ იხსნება.
- XP და სერია საერთოა თამაშთან: თავი 20 XP, მოდულის ქვიზი (≥70%) 50 XP, დონის პროექტი 100 XP.
- ჯერ არ არის: სერტიფიკატი (PDF) კურსის დასრულებაზე და Python-ის გაშვება ბრაუზერში (Pyodide).
🇬🇧 ინგლისური ვერსია (/en/)
ინგლისური გვერდები ქართულიდან იქმნება ყოველ deploy-ზე: node i18n/build.js კითხულობს ლექსიკონს i18n/en/<გვერდი>.json და წერს en/<გვერდი> (en/ რეპოში არ ინახება). Vercel-ზე /en/* → /*, თუ ინგლისური ფაილი არ არსებობს — ამიტომ სურათები და სკრიპტები საერთოა.
- ლექსიკონი:
{ "ქართული ნაწყვეტი": "English" } — იცვლება მხოლოდ მთლიანი სტრიქონი ან HTML-ის ტექსტი; null — ჯერ არ არის ნათარგმნი; "" — ინგლისურში საჭირო არ არის (მაგ. სუფიქსი -ზე).
_raw: ზუსტი ტექსტის ჩანაცვლება კონტექსტით — როცა ერთი სიტყვა სხვადასხვაგან სხვას ნიშნავს (პარამეტრები — Settings / Parameters).- თარგმანში ბრჭყალები (
', ", `) და \ ისეთივე რაოდენობით უნდა იყოს, როგორც ორიგინალში — აწყობა სხვაგვარად შეჩერდება (JS არ გატყდება). აპოსტროფისთვის: ’.
- ახალი ტექსტის სია:
node i18n/extract.js CodeQuest.html. შემოწმება: node i18n/build.test.js, შემდეგ en/CodeQuest.html-ში CodeQuest.testAll().
- სანამ თარგმანი არ დასრულდება, ინგლისურ გვერდებს
noindex აქვს და ქართული გვერდებიდან ბმული არ არის.
Pro და გადახდები (Dodo Payments)
ყოველ ენაზე პირველი 100 ლეველი უფასოა. დანარჩენს ერთჯერადი გადახდა — CodeQuest Pro — ხსნის ყველა ენაზე ერთად.
Pro ხსნის 🎬 ვიდეოებისა და პროექტების გვერდსაც (მთავარ მენიუში — „ვიდეოები და პროექტები“):
- 180 ვიდეო — ყოველ ენაზე 10, საიტზევე იყურება: ქართული გაკვეთილები (Jortsoft, ნოვატორი, BitCamp, GOA, ჯეოლაბი და სხვ.), Fireship-ის „100 წამში“, freeCodeCamp-ის, Programming with Mosh-ის, Bro Code-ის კურსები და პროექტები. ყოველი ვიდეო შემოწმებულია: არსებობს და საიტში ჩასმა ნებადართულია. ქვემოთ არის „მეტი“ ბმულებიც: YouTube-ის ძებნა და TikTok.
- რედაქტორი ვიდეოს ქვემოთ — VS Code-ის მსგავსი ფანჯარა. ვიდეოს კოდს თავად წერ და ▶ Run-ით უშვებ. ის იმავე იზოლირებულ Worker-ში ეშვება, რაც ლეველები, ლიმიტებით და ქართული შეცდომებით. HTML/CSS/React-ზე შედეგი გადახედვის ფანჯარაში ჩანს.
- 💾 Save კოდს 📒 ჩანაწერებში ინახავს (ამავე ბრაუზერში). იქიდან ჩანაწერს გახსნი ვიდეოსთან ერთად, დააკოპირებ ან წაშლი. თითო ენაზე ბოლო დრაფტიც თავისით ინახება.
- ნაბიჯ-ნაბიჯ პროექტები — ყოველ ენაზე ნამდვილი პატარა პროგრამა, რომელსაც თამაშის გარეთ აწყობ: საქმეების სია (JavaScript), გამოიცანი რიცხვი (Python), თამაში LÖVE-ში (Lua), Flutter-ის აპი (Dart), წამზომი (React) და სხვ. ყოველ ნაბიჯს აქვს ახსნა, კოდი კოპირების ღილაკით და „✓ გავაკეთე“ ნიშანი. ბოლოს მოცემულია მთლიანი კოდი, სად გაუშვა და იდეები გასაგრძელებლად.
- 💻 ჩემი პროექტები — კომპიუტერის ვერსიაში: პროგრამაში (1.0.3-დან) და Microsoft Store-ის აპში. ერთი პროექტი უფასოა (
PJ_FREE), მეტის შექმნისას Pro-ს ფანჯარა იხსნება; Pro-თი — 20-მდე. ბრაუზერის ჩანართში და ტელეფონზე ეს გვერდი არ არის — Pro-ს გვერდზე ჩანს „გადმოწერე Windows-ისთვის“.
- ახალი პროექტი: სახელი + ტიპი (19 ენიდან). თითო ტიპს თავისი საჭირო ფაილები აქვს — მაგ. „JavaScript-ს სჭირდება HTML და CSS“. სანამ ისინი არ დაემატება, ▶ Run გათიშულია. „დაამატე“ ქმნის უკვე დაკავშირებულ ფაილს (
index.html-ში style.css და script.js). საჭირო ფაილის წაშლისას გაფრთხილება ისევ ჩნდება.
- რედაქტორი: ფაილების სია (დამატება, გადარქმევა, წაშლა), იგივე კოდის რედაქტორი, ▶ Run, გადახედვა HTML/CSS/JS/React-ისთვის, კონსოლი დანარჩენი ენებისთვის.
- შენახვა: ყოველი ცვლილება ~2 წამში ინახება პროგრამაში დრაფტად — პროგრამის დახურვის შემდეგაც რჩება. „შენახვა“ (Ctrl+S) ფაილებს წერს არჩეულ საქაღალდეში (
<საქაღალდე>/<სახელი>/…) და ამოწმებს. წარმატების შემდეგ დრაფტი იშლება და პროექტი კომპიუტერის ფაილებიდან იხსნება; შეცდომისას დრაფტი რჩება და ჩანს მიზეზი და გამოსავალი.
- ლიმიტები: 20 პროექტი, ფაილი ≤ 1 MB, პროექტი ≤ 5 MB, მხოლოდ ტექსტი.
- ნაბიჯ-ნაბიჯ პროექტს აქვს ღილაკი „გახსენი ჩემს პროექტებში“ — ქმნის ახალ პროექტს მისი საწყისი ფაილით.
ვიდეოები STUDIO_VIDEOS-შია, გზამკვლევები — STUDIO_GUIDES-ში, ორივე ფაილის ===STUDIO=== ბლოკში.
Pro ანგარიშს ებმება. ყიდვას და კოდის ჩასმას ანგარიში სჭირდება. თუ არ ხარ შესული, თამაში ჯერ შესვლის/რეგისტრაციის ფორმას აჩვენებს და შემდეგ ყიდვას თავისით აგრძელებს.
ყიდვა Dodo Payments-ით ხდება:
- მყიდველი გადახდის გვერდზე იხდის, ელფოსტაზე ლიცენზიის კოდს იღებს და თამაშში ჩასვამს (Pro-ს ფანჯარა ან პარამეტრები → CodeQuest Pro).
- სერვერი (
proActivate, api/account.js) კოდს Dodo-სთან ამოწმებს და ერთ ანგარიშს აბამს: prokey:<sha256(კოდი)> → ანგარიში. სხვა ანგარიშზე იგივე კოდი აღარ გააქტიურდება (pro_taken); მფლობელის კოდები (OWNER_KEYS) გამონაკლისია.
- Pro ჩართულია ყველა მოწყობილობაზე, სადაც ამ ანგარიშით შეხვალ. გამოსვლისას ითიშება.
- ანგარიშის წაშლისას კოდი თავისუფლდება.
- ძველი, ანგარიშზე მიუბმელი Pro შესვლისას ერთხელ ავტომატურად ებმება ანგარიშს.
ჩასართავად ერთჯერადად:
-
დარეგისტრირდი Dodo Payments-ზე და გაიარე ბიზნესის ვერიფიკაცია.
-
Products → Create product: ერთჯერადი გადახდა (One-time), შენი ფასით. პროდუქტზე ჩართე License keys.
-
პროდუქტის გვერდზე Share — დააკოპირე გადახდის ბმული (მაგ. https://checkout.dodopayments.com/buy/pdt_...) და ჩასვი CodeQuest.html-ში, PRO.payLink-ში (იქვე PRO.price — ღილაკზე გამოსაჩენი ფასი). ახლა იქ Live Mode-ის ბმულია (ნამდვილი გადახდები, 2026-10-17-დან; Vercel-ში DODO_MODE=live).
-
Vercel → Project → Settings → Environment Variables:
DODO_MODE = test (სატესტო გადახდებისთვის) ან live (ნამდვილისთვის);PRO_PRIVATE_KEY — Pro-ს ხელმოწერის საიდუმლო გასაღები (ECDSA P-256, PKCS8 DER base64 ერთ ხაზზე). მისი საჯარო ნაწილი CodeQuest.html-შია, PRO.pub-ში;OWNER_KEYS — მფლობელის კოდები მძიმით: ასეთი კოდი Pro-ს უფასოდ რთავს, Dodo-ს გარეშე.
შემდეგ გააკეთე Redeploy.
-
სატესტო რეჟიმში შეიძინე Dodo-ს სატესტო ბარათით, ელფოსტიდან კოდი თამაშში ჩასვი — ფასიანი ლეველები უნდა გაიხსნას.
Pro-ს დაცვა. სერვერი Pro-ს ნიშანს ({ v: 2, u: ანგარიში, kh, iat }) საიდუმლო გასაღებით აწერს ხელს და ყოველ ჩატვირთვაზე (load/me) ახლიდან აძლევს. თამაში Pro-ს მხოლოდ მაშინ რთავს, როცა ხელმოწერა სწორია და ნიშანი შესული ანგარიშისაა (ProLock, Web Crypto). კლასებისთვის სერვერი პირდაპირ ანგარიშის user.pro-ს ამოწმებს. ამიტომ:
- ბრაუზერის შენახულ მონაცემებში ან კონსოლში Pro-ს ხელით ჩართვა აღარ მუშაობს;
- Pro-ს შემოწმების ფუნქციები და
PRO-ს პარამეტრები ჩაკეტილია (Object.freeze, defineProperty);
- სხვისი ნიშნის ან კოდის კოპირება სხვა ანგარიშზე არ მუშაობს.
შენიშვნა: თამაში მთლიანად ბრაუზერში მუშაობს და მისი კოდი საჯაროა, ამიტომ ადამიანი, რომელიც ფაილს თავად ჩამოტვირთავს და შეცვლის, დაცვას მაინც აუვლის გვერდს. სრული დაცვისთვის ფასიანი შინაარსი სერვერიდან უნდა მიეწოდებოდეს, მომხმარებლის ანგარიშებით. კოდის შემოწმება მხოლოდ Vercel-ზე მუშაობს (GitHub Pages-სა და ლოკალურ ფაილზე ფუნქცია არ არის).
💻 კომპიუტერის ვერსია (Windows, macOS, Linux)
CodeQuest ცალკე პროგრამადაც არსებობს: საკუთარი ფანჯარა და ხატულა სამუშაო მაგიდაზე, ბრაუზერი არ სჭირდება. გადმოსაწერად საიტის მთავარ მენიუში დააჭირე 💻 კომპიუტერის ვერსია, ან გახსენი CodeQuest.html#download. საიტი შენს სისტემას თავად ამოიცნობს.
| სისტემა | ფაილი | დაყენება |
|---|
| Windows 10/11 | CodeQuest-Setup.exe | გახსენი, თავისით დაყენდება. თუ გამოჩნდა „Windows protected your PC“, დააჭირე More info → Run anyway. |
| macOS (M-ჩიპი და Intel) | CodeQuest.dmg | გადაიტანე Applications-ში. პირველად: System Settings → Privacy & Security → Open Anyway. |
| Linux | CodeQuest.AppImage | მიეცი გაშვების უფლება (chmod +x) და გაუშვი. |
როგორ მუშაობს (საქაღალდე desktop/, Electron):
- თამაში იხსნება მისამართზე
codequest://app/CodeQuest.html. ინტერნეტით ის ყოველთვის ახალ ვერსიას იღებს საიტიდან და ასლს კომპიუტერში ინახავს, ამიტომ ახალი ლეველები პროგრამის თავიდან გადმოწერის გარეშე ჩანს.
- ინტერნეტის გარეშე იხსნება ბოლოს შენახული ასლი, ან პროგრამასთან მოყოლილი. CodeMirror, React და შრიფტები პროგრამაშივეა.
/api/* საიტზე გადაიგზავნება, ამიტომ Pro-ს ლიცენზიის კოდი პროგრამაშიც მუშაობს. გადახდა ბრაუზერში იხსნება.- YouTube-ის ვიდეოები, გარე ბმულები და გადახდა ჩვეულებრივ ბრაუზერში იხსნება.
- „ჩემი პროექტები“ (
desktop/projects.js, preload.js → window.cqDesktop.projects): დრაფტები ინახება userData/projects/<id>.json-ში. გვერდი მხოლოდ პროექტის id-ს და ფაილების ტექსტს აგზავნის — საქაღალდეს მხოლოდ Windows-ის ფანჯარა ირჩევს, ფაილის გზა კი მოწმდება ორჯერ (.., აბსოლუტური გზა, CON/NUL… აკრძალულია). შემოწმება: node desktop/projects.test.js.
- Microsoft Store-ის აპში (დაყენებული PWA,
display-mode: standalone) იგივე API-ს PjWeb ასრულებს (CodeQuest.html): დრაფტები IndexedDB-შია (codequest-projects), შენახვა — ბრაუზერის ფაილური API-ით (showDirectoryPicker); საქაღალდის handle-იც IndexedDB-ში ინახება, ამიტომ მეორედ აღარ იკითხება. ფაილების ასლი შენახვის შემდეგაც რჩება, რომ საქაღალდის ნებართვის გარეშეც გაიხსნას.
- პროგრესი პროგრამაში ცალკე ინახება. გადასატანად გამოიყენე პარამეტრები → პროგრესის კოდი.
ახალი ვერსიის გამოშვება. .github/workflows/desktop.yml desktop/-ის ყოველ ცვლილებაზე GitHub Actions-ში აწყობს სამივე ფაილს და დებს Releases-ში, ტეგით desktop-v<ვერსია>. ახალი რელიზისთვის desktop/package.json-ში გაზარდე version. იგივე ვერსიაზე ფაილები უბრალოდ განახლდება. საიტის ბმულები ყოველთვის ბოლო რელიზზე მიდის.
ლოკალურად (Node 22+):
cd desktop
npm ci
npm start # გაშვება
npm run dist # ინსტალერი ამ სისტემისთვის → desktop/dist/
სატესტოდ: CODEQUEST_SITE=http://127.0.0.1:8080 თამაშს ლოკალური სერვერიდან ჩატვირთავს, CODEQUEST_OFFLINE=1 კი ინტერნეტის გათიშვას აჩვენებს.
პროგრამა ფასიანი ციფრული ხელმოწერის გარეშეა, ამიტომ Windows და macOS პირველ გაშვებაზე გაფრთხილებას აჩვენებს. ხელმოწერისთვის საჭიროა სერტიფიკატი (Windows) და Apple Developer-ის ანგარიში (macOS).
როგორ ვითამაშო საკუთარ კომპიუტერზე
ჩამოტვირთე CodeQuest.html და გახსენი ბრაუზერში. სერვერი და ინსტალაცია არ სჭირდება.
ინტერნეტი საჭიროა მხოლოდ შრიფტებისა და CodeMirror რედაქტორისთვის. მის გარეშე თამაში მაინც მუშაობს, უფრო მარტივი რედაქტორით.
კლავიშები: Ctrl+Enter — გაშვება · Ctrl+Shift+Enter — ნაბიჯ-ნაბიჯ · Esc — ფანჯრის დახურვა.
პროგრესის შენახვა
ანგარიშის გარეშე პროგრესი ბრაუზერში ინახება (localStorage), თითოეული მისამართისთვის ცალკე. ამიტომ ლოკალური ფაილის პროგრესი საიტზე თავისით არ გადავა და პირიქით.
სხვა მოწყობილობაზე გადასატანი ორი გზა არსებობს:
- 👤 ანგარიში (იხ. ქვემოთ), რომელიც პროგრესს თავისით ინახავს (საიტზე და ტელეფონზე);
- პარამეტრები → პროგრესის კოდი: დააკოპირე კოდი და მეორე ადგილას „იმპორტით“ ჩასვი.
💻 კომპიუტერის პროგრამაში პროგრესი მხოლოდ კომპიუტერში ინახება. ანგარიში იქ Pro-სთვის და კლასისთვისაა: შესვლისას ანგარიშის პროგრესი ერთხელ გადმოდის, შემდეგ კი სერვერზე მიდის მხოლოდ მოკლე შეჯამება (summary: XP, ლეველების რაოდენობა, სერია — კლასის რეიტინგისთვის) და ანონიმური სტატისტიკა. ასე პროგრამის მომხმარებლები ბაზის ადგილს თითქმის არ იკავებენ.
👤 ანგარიშები: შესვლა და რეგისტრაცია
მთავარი მენიუს ზედა ზოლში არის ღილაკი შესვლა (იქვეა რეგისტრაციაც). სტუმარს ანგარიში არ სჭირდება და თამაშობს ისე, როგორც ადრე.
ანგარიშით პროგრესი, Pro და ბიტის ნივთები ყველა მოწყობილობაზე ერთია, კომპიუტერის პროგრამის ჩათვლით:
- რეგისტრაციისთვის საკმარისია სახელი და პაროლი. ელფოსტა არ გვჭირდება. სახელი 3–20 სიმბოლოა (ქართული ან ლათინური ასოები, ციფრები,
_ . -), პაროლი კი მინიმუმ 8 სიმბოლო. სახელს სხვა მოთამაშეები ვერ ხედავენ.
- რეგისტრაციისას მოთამაშე იღებს აღდგენის კოდს (მაგ.
ABCD-EFGH-2345). ის ერთხელ ჩანს და შეიძლება დააკოპირო ან ფაილად შეინახო. დავიწყებული პაროლი ამ კოდით აღდგება, რის შემდეგაც ახალი კოდი გაიცემა.
- ყოველი ცვლილება რამდენიმე წამში სერვერზე ინახება. თუ სხვა მოწყობილობამ შუალედში შეინახა, პროგრესები ერთიანდება: ლეველებიდან, მიღწევებიდან და ნივთებიდან საუკეთესო რჩება. შესვლისას, თუ ორივეგან არის პროგრესი, თამაში გეკითხება: გაერთიანება თუ მხოლოდ ანგარიშის პროგრესი.
- გასვლისას ეს მოწყობილობა თავიდან იწყება, პარამეტრები კი რჩება. სკოლის საერთო კომპიუტერზე ასე შემდეგი მოსწავლე წინას პროგრესს ვერ ნახავს.
- ანგარიშის პანელიდან შეიძლება პაროლის შეცვლა (სხვა მოწყობილობებზე სესია უქმდება) და ანგარიშის წაშლა (პაროლით დადასტურებით).
ჩართვა (ერთხელ, საიტის მფლობელისთვის). ანგარიშები ინახება უფასო Upstash Redis ბაზაში:
- Vercel → პროექტი
codequest → Storage → Create Database → Upstash (Redis) → აირჩიე უფასო გეგმა და ახლო რეგიონი (მაგ. Frankfurt).
- Connect Project →
codequest. Vercel თავად დაამატებს ცვლადებს KV_REST_API_URL და KV_REST_API_TOKEN.
- Deployments → ბოლო დეპლოი → Redeploy, რომ ფუნქციამ ახალი ცვლადები დაინახოს.
ბაზის გარეშე ღილაკი იმუშავებს, მაგრამ შესვლისას დაწერს, რომ ანგარიშები ჯერ არ არის ჩართული.
როგორ არის აწყობილი. api/account.js არის Vercel-ის ფუნქცია; ყველა მოთხოვნა POST /api/account { action, ... }:
- მოქმედებები:
register (ანგარიშს არ ქმნის — მხოლოდ წერილს აგზავნის), confirmReg (წერილის ბმული account.html?join= — ანგარიში ახლა იქმნება, ელფოსტა უკვე დადასტურებულია), login, reset, me, load, save, logout, password, delete.
- ჰეშები: პაროლი და აღდგენის კოდი ინახება მხოლოდ scrypt-ის ჰეშით, შემთხვევითი მარილით.
- სესია: ნიშანი (token) 60 დღე მოქმედებს, ბაზაში მხოლოდ მისი sha256 ინახება. ნიშანი თამაშში ცალკე ინახება (
codequest.auth), ამიტომ არც პროგრესის კოდში ხვდება, არც სერვერზე.
- მცდელობების ლიმიტი: შესვლა, რეგისტრაცია და აღდგენა შეზღუდულია IP-ითა და სახელით.
- შენახვა: პროგრესი შეკუმშული (gzip) ინახება. ვერსიის (rev) შემოწმება ატომურია (Lua), ამიტომ ორი მოწყობილობა ერთმანეთის ცვლილებებს ვერ წაშლის. თამაში სერვერზე მაქსიმუმ 15 წამში ერთხელ ინახავს, რომ უფასო ბაზის ლიმიტი დიდხანს ეყოს.
- კლასები:
classCreate, classJoin, classLeave, classes, classView, classKick, classDelete. შექმნას, შეერთებას, სიას, ხედს და liveStart-ს Pro სჭირდება: თამაში აგზავნის Pro-ს ხელმოწერილ ნიშანს (pro), სერვერი მას PRO.pub-ის იგივე საჯარო გასაღებით ამოწმებს. სხვა შემთხვევაში პასუხია pro_required. გასვლას, წაშლას, ამოგდებას და გაკვეთილის დასრულებას Pro არ სჭირდება.
- ცოცხალი გაკვეთილი:
liveStart, liveSet, liveEnd. მასწავლებლის დაფა 4 საათი ინახება (live:<ID>) და მისი შეცვლა მხოლოდ გაკვეთილის გასაღებით შეიძლება. მოსწავლეები დაფას წამში ერთხელ კითხულობენ GET /api/account?live=ID-ით. პასუხი Vercel-ის CDN-ში 1 წამით ინახება, ამიტომ მთელი კლასი ბაზას წამში მხოლოდ ერთხელ მიმართავს.
- ყოველი შენახვისას, თუ XP ან ლეველები შეიცვალა, თამაში აგზავნის მოკლე შეჯამებას (
sum:<სახელი>): XP, ლეველები, ვარსკვლავები, ახლანდელი ლეველი, ენების პროგრესი. კვირის XP ამ შეჯამებიდან ითვლება.
- მასწავლებელი ყველაფერს ხედავს, მოსწავლე კი კლასელების მხოლოდ სახელს და XP-ს.
- ანონიმური სტატისტიკა:
stat აგროვებს მონაცემებს ყოველი მეოთხე სესიიდან: ლეველის id, შეცდომები და გაიარა თუ არა, სახელის გარეშე.
- მფლობელი ყველაფერს ხედავს 📊 სტატისტიკის გვერდზე (პარამეტრები → დეველოპერისთვის → „📊 სტატისტიკა (მფლობელი)“), მფლობელის კოდით ():
კონფიდენციალურობა: privacy.html და terms.html. ბმულები ჩანს თამაშის ფუტერში და რეგისტრაციის ფორმაში.
🔒 უსაფრთხოება
- სესია: ვებში შესვლის ნიშანი
HttpOnly + SameSite=Strict cookie-შია (cq_s, Path=/api). JavaScript-ს ის არ ხელეწიფება, ამიტომ XSS-ით ვერ მოიპარება.
localStorage-ში მხოლოდ სახელი და შენახვის მდგომარეობა ინახება.- ძველი ვერსიის ნიშანი პირველივე მოთხოვნისას cookie-ში გადადის.
- კომპიუტერის პროგრამა (Origin-ის გარეშე) ნიშანს ისევ JSON-ში იღებს.
- CORS:
/api/* ბრაუზერიდან მხოლოდ codequest-lazare.vercel.app-ს და ლოკალურ ტესტს ემსახურება. სხვა საიტი და Origin: null (ქვიშის ყუთის iframe, მაგალითად მასწავლებლის კოდი მოსწავლესთან) იღებს 403 bad_origin. დამატებითი დომენი: Vercel-ის EXTRA_ORIGINS (მძიმით).
- ჰედერები (
vercel.json):
Content-Security-Policy: სკრიპტები მხოლოდ საიტიდან და cdnjs-დან; მოთხოვნები მხოლოდ საიტზე და api.github.com-ზე; iframe — მხოლოდ YouTube; object-src none, frame-ancestors self.- ასევე
nosniff, X-Frame-Options, Referrer-Policy, Permissions-Policy და HSTS.
- CDN: cdnjs-ის ყველა სკრიპტს და სტილს აქვს
integrity (cdnjs-ის ოფიციალური sha512). თუ CDN-ზე ფაილი შეიცვლება, ბრაუზერი მას აღარ გაუშვებს.
- ლიმიტები:
- IP-დან წუთში 600 მოთხოვნა (მეხსიერებაში, ბაზის ხარჯის გარეშე);
- შესვლის, რეგისტრაციის, აღდგენის, პაროლის, კლასში შეერთების, გაკვეთილის და სტატისტიკის ლიმიტები ინახება Redis-ში.
- შეცდომები: კლიენტი მხოლოდ შეცდომის კოდს იღებს (მაგალითად
server), სტეკს არასდროს.
- საიდუმლოებები: მხოლოდ Vercel-ის env-შია:
KV_REST_API_*, PRO_PRIVATE_KEY, OWNER_KEYS. .env*, pro-secrets.txt და *.cqb .gitignore-შია. თამაშში მხოლოდ Pro-ს საჯარო გასაღებია (PRO.pub).
- მონაცემთა ბაზა:
- Redis-ის ბრძანებები JSON მასივებად იგზავნება, Lua სკრიპტები უცვლელია (
KEYS/ARGV), ამიტომ შეყვანით ინექცია შეუძლებელია.
- მომხმარებელი ყოველთვის სესიიდან ირკვევა, ბრაუზერის მიერ მოწოდებული ID-ით არასდროს.
- კლასის მოქმედებები ამოწმებს, მფლობელი ხარ თუ წევრი.
💾 ბაზის სარეზერვო ასლი
.github/workflows/db-backup.yml ყოველ ღამე (02:17 UTC) ბაზას read-only ტოკენით კითხულობს და tools/db-backup.js-ით აკეთებს AES-256-GCM-ით დაშიფრულ ასლს (scrypt გასაღები). ასლი Actions-ის Artifacts-ში 30 დღე ინახება.
ყოველ ჯერზე აღდგენაც მოწმდება:
- ფაილი იშიფრება და სტრუქტურა მოწმდება;
- თუ
RESTORE_TEST_* მითითებულია, ასლი სატესტო ბაზაში სრულად აღდგება და ყველა გასაღები შედარდება.
სესიები, ლიმიტები და ცოცხალი გაკვეთილები დროებითია და ასლში არ ინახება.
საჭირო საიდუმლოებები (GitHub → Settings → Secrets and variables → Actions):
UPSTASH_URLUPSTASH_READ_TOKENBACKUP_KEY
აღდგენა:
BACKUP_KEY=… node tools/db-restore.js codequest-db-….cqb --dry-run
BACKUP_KEY=… UPSTASH_URL=… UPSTASH_TOKEN=<ჩაწერის ტოკენი> node tools/db-restore.js codequest-db-….cqb --yes --verify
GitHub Pages-ზე გამოქვეყნება
რეპოში უკვე არის მთავარი გვერდი index.html და ცარიელი .nojekyll ფაილი.
- ვინ რას ხედავს: ახალი სტუმარი ხედავს მშობლებისა და სკოლებისთვის განკუთვნილ გვერდს. ვინც უკვე თამაშობს, ან ვინც ბმულში პარამეტრს მოიყოლებს (მაგ.
#download), პირდაპირ CodeQuest.html-ზე გადადის. ?home ამ გვერდს ყოველთვის აჩვენებს.
- გაზიარების სურათი:
og.jpg (1200×630, ~100 KB), რომელიც Facebook-ზე და მესენჯერებში ჩანს. ასევე favicon.ico, robots.txt, sitemap.xml და საკუთარი 404.html.
GitHub Pages-ზე გამოსაქვეყნებლად დარჩა ერთჯერადი ჩართვა: დარჩა ერთჯერადი ჩართვა:
- გახსენი რეპოს Settings → Pages.
- Source:
Deploy from a branch.
- Branch:
main, საქაღალდე / (root) → Save.
- 1–2 წუთში თამაში გაიხსნება მისამართზე: https://lazarepataraia910-jpg.github.io/fanycod/
ამის შემდეგ main-ზე ყოველი ცვლილება საიტს ავტომატურად განაახლებს. თამაში Vercel-ზეც მუშაობს, დამატებითი პარამეტრების გარეშე.
დეველოპერისთვის
- ყველაფერი ერთ ფაილშია:
CodeQuest.html (HTML, CSS და JavaScript, build-ის გარეშე).
- მოთამაშის კოდი Web Worker-ში სრულდება, გვერდისგან იზოლირებულად. ხმები Web Audio API-ით იქმნება, გარე ფაილების გარეშე.
- სხვა ენები სერვერის გარეშე მუშაობს: Python, Java, C და C++ კოდი ბრაუზერშივე ითარგმნება JavaScript-ში (სექცია
LANGS ფაილში). თარჯიმანი ხაზებს ინარჩუნებს, ამიტომ შეცდომა და ნაბიჯ-ნაბიჯ რეჟიმი სწორ ხაზს აჩვენებს. ტიპები მოწმდება ისე, რომ ენის ქცევა ნამდვილს ემთხვეოდეს: C-ში და Java-ში 7 / 2 არის 3, Python-ში "x" + 5 შეცდომაა, Java 10.0-ს ბეჭდავს როგორც 10.0. მხარდაჭერილია ენის ძირითადი ნაწილი, რაც კურსებს სჭირდება (ცვლადები, პირობები, ციკლები, ფუნქციები, სიები/მასივები და სხვ.). კლასები, მაჩვენებლები და მსგავსი რამ ჯერ არ არის.
- TypeScript, C#, Go, Rust, PHP, Ruby, Swift, Kotlin, Lua და Dart ერთი საერთო თარჯიმნით ითარგმნება (სექცია „NL — ახალი ენების თარჯიმანი“,
nlCompile). ენებს შორის განსხვავება ცხრილებშია აღწერილი:
- სინტაქსი (
NL_D): კომენტარები, ტექსტში ჩადგმა (${x}, {x}, #{x}, \(x), $x), ბლოკები { } თუ end, სავალდებულო ;;
- ქცევა (
NL_SEM): 7 / 2 არის 3 თუ 3.5, შეიძლება თუ არა "x" + 5, იბეჭდება თუ არა 5.0 როგორც 5.0.
- Go-ში გამოუყენებელ ცვლადზე გაფრთხილება ჩნდება, Kotlin-ში
val-ის შეცვლა შეცდომაა, Lua-ში სია 1-დან ითვლება — როგორც ნამდვილ ენებში.
- გენერირებული ლეველები ფაილში მზა სახით არ ინახება (სექცია
DRILLS). ყოველი ლეველი გენერატორით იქმნება seed-იდან (ენა + ნომერი), ამიტომ ყოველთვის ერთნაირია. კურსის რიგს — რომელი თავი რის შემდეგ მოდის — coursePlan აწყობს.
- რობოტის ლეველების ამოხსნა იწერება პატარა შუალედურ ენაზე (IR). მისგან ავტომატურად იქმნება ყველა 15 რობოტის ენის კოდი (
nlEmit — ახალი ათი ენისთვის).
- ბოსის ბაგები ამოხსნის მუტაციით ჩნდება. რჩება მხოლოდ ის ბაგი, რომელიც ტესტს მართლაც ჩააგდებს.
- HTML/CSS-ის გადახედვა იზოლირებულ
iframe-შია (სკრიპტები იქ არ ეშვება), შემოწმება კი გვერდის DOM-სა და სტილებს ამოწმებს.
- ავტომატური შემოწმება: ყოველი ხელით დაწერილი ლეველისა და პროექტის სწორი ამოხსნა ეშვება ყველა ტესტ-რუკაზე, ყველა ენაზე (სულ 249 შემოწმება), ბოსების ბაგიანი და პროექტების საწყისი კოდი კი, პირიქით, უნდა ჩავარდეს. გაშვება შეიძლება სამნაირად:
