rsnarsna commited on
Commit
abd771f
·
1 Parent(s): fd40ac2

feat(backend): sync 11 canonical category icon metaphors and child summaries

Browse files
specs/programming_fundamentals_11_categories.json CHANGED
@@ -5,10 +5,13 @@
5
  "name": "Essentials",
6
  "expectedTopicCount": 3,
7
  "iconName": "Zap",
8
- "colorName": "blue",
9
- "iconColor": "text-blue-400",
10
- "iconBg": "bg-blue-600/20",
11
- "borderColor": "border-blue-500/30",
 
 
 
12
  "introduction": "Welcome to the world of programming! A computer program is simply a recipe of instructions that tells the computer what to do. In this category, you will learn how programs run step-by-step, how to print messages on your screen, and how to ask the user for information.",
13
  "learningObjectives": [
14
  "Understand what a computer program is and how code runs in order.",
@@ -270,10 +273,13 @@
270
  "name": "Variables & Constants",
271
  "expectedTopicCount": 6,
272
  "iconName": "Variable",
273
- "colorName": "blue",
274
- "iconColor": "text-blue-400",
275
- "iconBg": "bg-blue-600/20",
276
- "borderColor": "border-blue-500/30",
 
 
 
277
  "introduction": "A variable is a labeled storage box in the computer's memory. Instead of typing the same value again and again, you give it a name like 'player_score = 10'. A constant is a locked box whose value should stay the same forever, like PI = 3.14159.",
278
  "learningObjectives": [
279
  "Create and name variables to remember information.",
@@ -644,9 +650,12 @@
644
  "name": "Data Types & Collections",
645
  "expectedTopicCount": 5,
646
  "iconName": "Boxes",
 
 
647
  "colorName": "cyan",
648
- "iconColor": "text-cyan-400",
649
- "iconBg": "bg-cyan-600/20",
 
650
  "borderColor": "border-cyan-500/30",
651
  "introduction": "Computers deal with different flavors of information: numbers for math, text words for messages, yes/no flags for decisions, and collections (lists and dictionaries) to hold groups of items. Knowing your data types prevents bugs and unlocks powerful coding abilities.",
652
  "learningObjectives": [
@@ -1013,10 +1022,13 @@
1013
  "name": "Operators & Logic",
1014
  "expectedTopicCount": 7,
1015
  "iconName": "Scale",
1016
- "colorName": "orange",
1017
- "iconColor": "text-orange-400",
1018
- "iconBg": "bg-orange-600/20",
1019
- "borderColor": "border-orange-500/30",
 
 
 
1020
  "introduction": "Operators are symbols that calculate values, compare items, and make smart decisions. Arithmetic operators do math (+, -, *, /), comparison operators check relationships (==, !=, <, >), and logical operators (and, or, not) combine conditions like true puzzle pieces.",
1021
  "learningObjectives": [
1022
  "Add and subtract values with + and -.",
@@ -1378,9 +1390,12 @@
1378
  "name": "Mathematics",
1379
  "expectedTopicCount": 6,
1380
  "iconName": "Calculator",
 
 
1381
  "colorName": "orange",
1382
- "iconColor": "text-orange-400",
1383
- "iconBg": "bg-orange-600/20",
 
1384
  "borderColor": "border-orange-500/30",
1385
  "introduction": "Computers are world champion calculators! In this category, you will master essential math functions: calculating absolute distances (abs), powers (pow), rounding numbers (round), snapping down to floors or up to ceilings (floor/ceil), finding minimums and maximums (min/max), and square roots (sqrt).",
1386
  "learningObjectives": [
@@ -1777,10 +1792,13 @@
1777
  "name": "Control Flow",
1778
  "expectedTopicCount": 6,
1779
  "iconName": "GitBranch",
1780
- "colorName": "amber",
1781
- "iconColor": "text-amber-400",
1782
- "iconBg": "bg-amber-600/20",
1783
- "borderColor": "border-amber-500/30",
 
 
 
1784
  "introduction": "Control flow lets your program make choices and repeat tasks! Instead of a boring straight line, code can branch left or right using If-Else conditions, and repeat loops using For and While loops. This is where programs become truly intelligent.",
1785
  "learningObjectives": [
1786
  "Use 'if' statements to make decisions.",
@@ -2150,10 +2168,13 @@
2150
  "name": "Functions",
2151
  "expectedTopicCount": 4,
2152
  "iconName": "Code2",
2153
- "colorName": "indigo",
2154
- "iconColor": "text-indigo-400",
2155
- "iconBg": "bg-indigo-600/20",
2156
- "borderColor": "border-indigo-500/30",
 
 
 
2157
  "introduction": "A function is a reusable mini-machine that does a specific job. You give it a name using 'def', give it ingredients (parameters), let it do the work, and get back the finished product using 'return'. Once built, you can call it a thousand times without repeating yourself!",
2158
  "learningObjectives": [
2159
  "Define custom reusable functions with the 'def' keyword.",
@@ -2424,10 +2445,13 @@
2424
  "name": "Strings & Collection Operations",
2425
  "expectedTopicCount": 6,
2426
  "iconName": "Type",
2427
- "colorName": "cyan",
2428
- "iconColor": "text-cyan-400",
2429
- "iconBg": "bg-cyan-600/20",
2430
- "borderColor": "border-cyan-500/30",
 
 
 
2431
  "introduction": "Strings and collections are the building blocks of real software. In this category, you will learn how to transform text casing (upper, lower, title), glue strings together, chop sentences into words (split), add items to lists (append, insert), slice items by position, and look up details in dictionaries.",
2432
  "learningObjectives": [
2433
  "Transform string cases using upper(), lower(), and title().",
@@ -2760,10 +2784,13 @@
2760
  "name": "Object-Oriented Programming (OOP)",
2761
  "expectedTopicCount": 3,
2762
  "iconName": "Boxes",
2763
- "colorName": "indigo",
2764
- "iconColor": "text-indigo-400",
2765
- "iconBg": "bg-indigo-600/20",
2766
- "borderColor": "border-indigo-500/30",
 
 
 
2767
  "introduction": "Object-Oriented Programming (OOP) is like playing with Lego! A 'class' is a blueprint or cookie cutter. An 'object' is a real cookie made from that cutter. Objects have things they know (attributes, like color or speed) and things they can do (methods, like drive or brake).",
2768
  "learningObjectives": [
2769
  "Understand what a class is and how to define one using 'class'.",
@@ -2999,10 +3026,13 @@
2999
  "name": "Files & Data Interchange",
3000
  "expectedTopicCount": 6,
3001
  "iconName": "FileText",
3002
- "colorName": "grey",
3003
- "iconColor": "text-zinc-400",
3004
- "iconBg": "bg-zinc-600/20",
3005
- "borderColor": "border-zinc-500/30",
 
 
 
3006
  "introduction": "When a program closes, whatever was in RAM memory disappears. To save information permanently, we save it into files on the computer disk! In this category, you will learn how to read text files, write new files, append notes, work with universal JSON data, and close files safely using context managers.",
3007
  "learningObjectives": [
3008
  "Open and read stored text from files on disk.",
@@ -3345,10 +3375,13 @@
3345
  "name": "Modules & Imports",
3346
  "expectedTopicCount": 1,
3347
  "iconName": "Package",
3348
- "colorName": "grey",
3349
- "iconColor": "text-zinc-400",
3350
- "iconBg": "bg-zinc-600/20",
3351
- "borderColor": "border-zinc-500/30",
 
 
 
3352
  "introduction": "You don't have to invent every wheel from scratch! Python comes with hundreds of pre-built toolboxes called 'modules'. Using the 'import' keyword, you can bring in superpowers for math, random numbers, dates, networking, and graphics with a single line of code.",
3353
  "learningObjectives": [
3354
  "Understand what a module is and how it organizes code.",
 
5
  "name": "Essentials",
6
  "expectedTopicCount": 3,
7
  "iconName": "Zap",
8
+ "iconMetaphor": "Start flag",
9
+ "childFriendlySummary": "Start, ask questions and show answers.",
10
+ "colorName": "emerald",
11
+ "iconColor": "text-emerald-500",
12
+ "iconBg": "bg-emerald-500/15",
13
+ "pastelBg": "bg-emerald-500/10 dark:bg-emerald-950/20",
14
+ "borderColor": "border-emerald-500/30",
15
  "introduction": "Welcome to the world of programming! A computer program is simply a recipe of instructions that tells the computer what to do. In this category, you will learn how programs run step-by-step, how to print messages on your screen, and how to ask the user for information.",
16
  "learningObjectives": [
17
  "Understand what a computer program is and how code runs in order.",
 
273
  "name": "Variables & Constants",
274
  "expectedTopicCount": 6,
275
  "iconName": "Variable",
276
+ "iconMetaphor": "Storage box",
277
+ "childFriendlySummary": "Keep information inside boxes.",
278
+ "colorName": "amber",
279
+ "iconColor": "text-amber-500",
280
+ "iconBg": "bg-amber-500/15",
281
+ "pastelBg": "bg-amber-500/10 dark:bg-amber-950/20",
282
+ "borderColor": "border-amber-500/30",
283
  "introduction": "A variable is a labeled storage box in the computer's memory. Instead of typing the same value again and again, you give it a name like 'player_score = 10'. A constant is a locked box whose value should stay the same forever, like PI = 3.14159.",
284
  "learningObjectives": [
285
  "Create and name variables to remember information.",
 
650
  "name": "Data Types & Collections",
651
  "expectedTopicCount": 5,
652
  "iconName": "Boxes",
653
+ "iconMetaphor": "Organizer box",
654
+ "childFriendlySummary": "Arrange information into groups.",
655
  "colorName": "cyan",
656
+ "iconColor": "text-cyan-500",
657
+ "iconBg": "bg-cyan-500/15",
658
+ "pastelBg": "bg-cyan-500/10 dark:bg-cyan-950/20",
659
  "borderColor": "border-cyan-500/30",
660
  "introduction": "Computers deal with different flavors of information: numbers for math, text words for messages, yes/no flags for decisions, and collections (lists and dictionaries) to hold groups of items. Knowing your data types prevents bugs and unlocks powerful coding abilities.",
661
  "learningObjectives": [
 
1022
  "name": "Operators & Logic",
1023
  "expectedTopicCount": 7,
1024
  "iconName": "Scale",
1025
+ "iconMetaphor": "Balance scale",
1026
+ "childFriendlySummary": "Calculate, compare and make logical choices.",
1027
+ "colorName": "blue",
1028
+ "iconColor": "text-blue-500",
1029
+ "iconBg": "bg-blue-500/15",
1030
+ "pastelBg": "bg-blue-500/10 dark:bg-blue-950/20",
1031
+ "borderColor": "border-blue-500/30",
1032
  "introduction": "Operators are symbols that calculate values, compare items, and make smart decisions. Arithmetic operators do math (+, -, *, /), comparison operators check relationships (==, !=, <, >), and logical operators (and, or, not) combine conditions like true puzzle pieces.",
1033
  "learningObjectives": [
1034
  "Add and subtract values with + and -.",
 
1390
  "name": "Mathematics",
1391
  "expectedTopicCount": 6,
1392
  "iconName": "Calculator",
1393
+ "iconMetaphor": "Calculator",
1394
+ "childFriendlySummary": "Work with numbers and calculations.",
1395
  "colorName": "orange",
1396
+ "iconColor": "text-orange-500",
1397
+ "iconBg": "bg-orange-500/15",
1398
+ "pastelBg": "bg-orange-500/10 dark:bg-orange-950/20",
1399
  "borderColor": "border-orange-500/30",
1400
  "introduction": "Computers are world champion calculators! In this category, you will master essential math functions: calculating absolute distances (abs), powers (pow), rounding numbers (round), snapping down to floors or up to ceilings (floor/ceil), finding minimums and maximums (min/max), and square roots (sqrt).",
1401
  "learningObjectives": [
 
1792
  "name": "Control Flow",
1793
  "expectedTopicCount": 6,
1794
  "iconName": "GitBranch",
1795
+ "iconMetaphor": "Road junction",
1796
+ "childFriendlySummary": "Choose a path and repeat actions.",
1797
+ "colorName": "purple",
1798
+ "iconColor": "text-purple-500",
1799
+ "iconBg": "bg-purple-500/15",
1800
+ "pastelBg": "bg-purple-500/10 dark:bg-purple-950/20",
1801
+ "borderColor": "border-purple-500/30",
1802
  "introduction": "Control flow lets your program make choices and repeat tasks! Instead of a boring straight line, code can branch left or right using If-Else conditions, and repeat loops using For and While loops. This is where programs become truly intelligent.",
1803
  "learningObjectives": [
1804
  "Use 'if' statements to make decisions.",
 
2168
  "name": "Functions",
2169
  "expectedTopicCount": 4,
2170
  "iconName": "Code2",
2171
+ "iconMetaphor": "Toy machine",
2172
+ "childFriendlySummary": "Create actions and use them again.",
2173
+ "colorName": "teal",
2174
+ "iconColor": "text-teal-500",
2175
+ "iconBg": "bg-teal-500/15",
2176
+ "pastelBg": "bg-teal-500/10 dark:bg-teal-950/20",
2177
+ "borderColor": "border-teal-500/30",
2178
  "introduction": "A function is a reusable mini-machine that does a specific job. You give it a name using 'def', give it ingredients (parameters), let it do the work, and get back the finished product using 'return'. Once built, you can call it a thousand times without repeating yourself!",
2179
  "learningObjectives": [
2180
  "Define custom reusable functions with the 'def' keyword.",
 
2445
  "name": "Strings & Collection Operations",
2446
  "expectedTopicCount": 6,
2447
  "iconName": "Type",
2448
+ "iconMetaphor": "Scissors and letters",
2449
+ "childFriendlySummary": "Cut, join, change and select information.",
2450
+ "colorName": "indigo",
2451
+ "iconColor": "text-indigo-500",
2452
+ "iconBg": "bg-indigo-500/15",
2453
+ "pastelBg": "bg-indigo-500/10 dark:bg-indigo-950/20",
2454
+ "borderColor": "border-indigo-500/30",
2455
  "introduction": "Strings and collections are the building blocks of real software. In this category, you will learn how to transform text casing (upper, lower, title), glue strings together, chop sentences into words (split), add items to lists (append, insert), slice items by position, and look up details in dictionaries.",
2456
  "learningObjectives": [
2457
  "Transform string cases using upper(), lower(), and title().",
 
2784
  "name": "Object-Oriented Programming (OOP)",
2785
  "expectedTopicCount": 3,
2786
  "iconName": "Boxes",
2787
+ "iconMetaphor": "Blueprint and house",
2788
+ "childFriendlySummary": "Design and create objects.",
2789
+ "colorName": "sky",
2790
+ "iconColor": "text-sky-500",
2791
+ "iconBg": "bg-sky-500/15",
2792
+ "pastelBg": "bg-sky-500/10 dark:bg-sky-950/20",
2793
+ "borderColor": "border-sky-500/30",
2794
  "introduction": "Object-Oriented Programming (OOP) is like playing with Lego! A 'class' is a blueprint or cookie cutter. An 'object' is a real cookie made from that cutter. Objects have things they know (attributes, like color or speed) and things they can do (methods, like drive or brake).",
2795
  "learningObjectives": [
2796
  "Understand what a class is and how to define one using 'class'.",
 
3026
  "name": "Files & Data Interchange",
3027
  "expectedTopicCount": 6,
3028
  "iconName": "FileText",
3029
+ "iconMetaphor": "Notebook and parcel",
3030
+ "childFriendlySummary": "Open, save, pack and unpack information.",
3031
+ "colorName": "amber",
3032
+ "iconColor": "text-amber-500",
3033
+ "iconBg": "bg-amber-500/15",
3034
+ "pastelBg": "bg-amber-500/10 dark:bg-amber-950/20",
3035
+ "borderColor": "border-amber-500/30",
3036
  "introduction": "When a program closes, whatever was in RAM memory disappears. To save information permanently, we save it into files on the computer disk! In this category, you will learn how to read text files, write new files, append notes, work with universal JSON data, and close files safely using context managers.",
3037
  "learningObjectives": [
3038
  "Open and read stored text from files on disk.",
 
3375
  "name": "Modules & Imports",
3376
  "expectedTopicCount": 1,
3377
  "iconName": "Package",
3378
+ "iconMetaphor": "Toolbox",
3379
+ "childFriendlySummary": "Bring in tools that help your program.",
3380
+ "colorName": "rose",
3381
+ "iconColor": "text-rose-500",
3382
+ "iconBg": "bg-rose-500/15",
3383
+ "pastelBg": "bg-rose-500/10 dark:bg-rose-950/20",
3384
+ "borderColor": "border-rose-500/30",
3385
  "introduction": "You don't have to invent every wheel from scratch! Python comes with hundreds of pre-built toolboxes called 'modules'. Using the 'import' keyword, you can bring in superpowers for math, random numbers, dates, networking, and graphics with a single line of code.",
3386
  "learningObjectives": [
3387
  "Understand what a module is and how it organizes code.",