diff --git a/content/raptacon/quizzes/README.md b/content/raptacon/quizzes/README.md new file mode 100644 index 0000000..075893f --- /dev/null +++ b/content/raptacon/quizzes/README.md @@ -0,0 +1,24 @@ +# Safety quizzes + +One file per quiz. Each quiz is the written half of a safety sign-off: you pass the quiz, then a mentor +watches you use the tool and signs you off on the skill (`item`). The quiz never replaces the sign-off. + +```yaml +quiz: + id: band-saw # file name without .yml + name: Band saw safety quiz + item: tool-band-saw # the skill this quiz is for + pass: 100 # percent needed to pass; retakes are unlimited + authored_by: [{name, github?}] + source: where the original questions came from +questions: + - q: The question. + choices: [A, B, C, D] # shown shuffled + answer: B # the correct choice, word for word + # or answers: [A, C] # "check all that apply": every listed choice, and only those + why: One line on why, shown after a wrong answer. + origin: schoology | new # ported from the Schoology test, or added for this bank + review: true # new or changed: a mentor should read it before it counts +``` + +Choices never refer to each other by letter ("both a and b"): the quiz shuffles them. diff --git a/content/raptacon/quizzes/band-saw.yml b/content/raptacon/quizzes/band-saw.yml new file mode 100644 index 0000000..b318607 --- /dev/null +++ b/content/raptacon/quizzes/band-saw.yml @@ -0,0 +1,153 @@ +# Band saw: the written half of tool-band-saw. Questions 1-11 are the Schoology "Band Saw +# Quiz" (ID 5317); 12-16 are new; 17-21 replace the band saw parts diagram worksheet +# (it had no answer key) with questions about what each part does. + +quiz: + id: band-saw + name: Band saw safety quiz + item: tool-band-saw + pass: 100 + authored_by: # Corey and Marilyn wrote the Schoology originals; Chris added the new questions + - {name: Corey Kesler} + - {name: Marilyn Kemp} + - {name: Chris Hirsch, github: ChrisHirsch} + source: Schoology "Band Saw Quiz" (ID 5317) and the band saw parts diagram + +questions: + - q: How high above the stock should the upper blade guard and guides be set? + choices: [1/16 to 1/8 inch, 1/8 to 1/4 inch, 1/4 to 1/2 inch, 1/2 to 1 inch] + answer: "1/8 to 1/4 inch" + why: Just above the stock, so as little blade as possible is exposed and the blade is supported close to the cut. + origin: schoology + + - q: When you cut a small piece, you should always... + choices: [use a push stick (ask a mentor to show you how), hold it with your fingertips, use a round guide, get someone to hold it for you] + answer: "use a push stick (ask a mentor to show you how)" + why: Small parts bring your fingers close to the blade. A push stick keeps them away. + origin: schoology + review: true # reworded from "consult a veteran/mentor to learn how to use a push stick" + + - q: Relief cuts on the band saw... + choices: [keep the blade from binding in tight curves, are only for hardwood, are cuts made in a hurry, are only for softwood] + answer: "keep the blade from binding in tight curves" + why: Cutting relief cuts first lets waste fall away, so the blade isn't twisted around a tight curve. + origin: schoology + + - q: Before making any cut, you first... + choices: ["check the stock is free of nails, screws or other obstructions", "turn the saw on", "take off your safety glasses", "start cutting slowly"] + answer: "check the stock is free of nails, screws or other obstructions" + why: Hidden metal can break the blade or throw the piece. + origin: schoology + + - q: When cutting freehand on the band saw, it is safe to... + choices: [force the stock around curves, keep the stock flat on the table, hold round stock in your hand, back out of a curved cut while the saw runs] + answer: "keep the stock flat on the table" + why: Flat on the table, the blade pushes the stock down. Round or tilted stock can spin and pull your hand in. + origin: schoology + + - q: When is it safe to have your hand in line with the blade? + choices: [When your hand is more than 2 inches away, When your hand is more than 4 inches away, Only when the saw is off and stopped, When your hand is more than 6 inches away] + answer: "Only when the saw is off and stopped" + why: If the stock slips, a hand in line with the blade goes straight into it. + origin: schoology + + - q: While running the band saw, it is a safe practice to... + choices: [reach across the table while the blade is running, keep a balanced stance the whole time, open the wheel covers carefully, leave the scraps until the end of the meeting] + answer: "keep a balanced stance the whole time" + why: Off balance, a slip pushes your hands toward the blade. + origin: schoology + + - q: How do you check that the blade runs in the middle of the wheels (tracking)? + choices: [Turn the power on for short bursts, Open the covers while it coasts, Turn the wheel by hand with the power off, Open the covers while braking] + answer: "Turn the wheel by hand with the power off" + why: The covers only come off with the power off, and turning by hand shows where the blade rides. + origin: schoology + + - q: While making a cut, you... + choices: [talk to your helper, concentrate on the cut, look around the shop, think about your next job] + answer: "concentrate on the cut" + why: Your full attention stays on the blade and your hands until the cut is done. + origin: schoology + + - q: When do you clear scrap from the band saw table? + choices: [While you cut, When a lot has built up, After the saw has stopped, It depends on the job] + answer: "After the saw has stopped" + why: Reaching near a moving blade to clear scraps is how fingers get cut. + origin: schoology + + - q: You need to back the blade out of a cut. What do you do? + choices: ["Turn the power off, wait for it to stop, then free the blade", "Leave the power on and loosen the tension", "Leave the power on so it slides out", "Use the brake while it runs"] + answer: "Turn the power off, wait for it to stop, then free the blade" + why: Backing out of a running cut can pull the blade off the wheels. + origin: schoology + review: true # added "wait for it to stop" + + - q: The blade breaks while you are cutting. What do you do? + choices: ["Grab the blade", "Step back, switch off, keep the covers closed until the wheels stop, and tell a mentor", "Open the cover to see what happened", "Keep cutting with what is left"] + answer: "Step back, switch off, keep the covers closed until the wheels stop, and tell a mentor" + why: A broken blade can whip around inside the covers. Let everything stop, then a mentor replaces it. + origin: new + review: true + + - q: How do you cut round stock (tube, dowel, bar) on the band saw? + choices: ["Freehand, held tight", "Clamped in a V-block or vise", "Rolling it into the blade", "Only with a helper holding it"] + answer: "Clamped in a V-block or vise" + why: The blade spins round stock and can pull your hand in. Clamped, it can't roll. + origin: new + review: true + + - q: The blade slows down or the cut is drifting. What should you do? + choices: [Push harder, Ease off and let the blade cut at its own pace, Twist the stock to steer it, Speed up the feed to finish quickly] + answer: "Ease off and let the blade cut at its own pace" + why: Forcing the feed bends or breaks the blade. Let the teeth do the work. + origin: new + review: true + + - q: What do you do before you walk away from the band saw? + choices: [Switch off and wait until the blade stops completely, Switch off and leave right away, Leave it running for the next person, Lower the guard and leave it running] + answer: "Switch off and wait until the blade stops completely" + why: A coasting blade is silent and nearly invisible to the next person. + origin: new + review: true + + - q: Where do you stand while cutting? + choices: [Directly behind the blade, Slightly to one side of the blade's path, On the right side reaching around, Wherever is comfortable] + answer: "Slightly to one side of the blade's path" + why: If the blade breaks or the stock kicks, you are out of its line. + origin: new + review: true + + - q: What does the blade tensioning knob (on top of the saw) do? + choices: [Raises the blade guard, Tightens or loosens the blade on the wheels, Tilts the table, Turns on the light] + answer: "Tightens or loosens the blade on the wheels" + why: Correct tension keeps the blade tracking and cutting straight. Only adjust it with the power off. + origin: new + review: true + + - q: What is the guide post for? + choices: [Raising or lowering the upper guard and blade guides to just above the stock, Tilting the table, Holding the stock, Changing the speed] + answer: "Raising or lowering the upper guard and blade guides to just above the stock" + why: Set it, then lock it with the guide post locking knob before cutting. + origin: new + review: true + + - q: What do the blade guides and the thrust bearing do? + choices: [Keep the blade from twisting and from being pushed back during the cut, Sharpen the blade, Hold the stock flat, Adjust the speed] + answer: "Keep the blade from twisting and from being pushed back during the cut" + why: The guides stop side-to-side twist; the thrust bearing behind the blade takes the push of the feed. + origin: new + review: true + + - q: What is the table insert (the plate around the blade in the table) for? + choices: [Supporting the stock right next to the blade so small pieces don't fall in, Locking the table angle, Holding the blade guard, Catching sawdust only] + answer: "Supporting the stock right next to the blade so small pieces don't fall in" + why: A missing or worn insert lets offcuts drop into the saw and jam the blade. + origin: new + review: true + + - q: Where is the power switch, and how do you use it in an emergency? + choices: [On the front of the base - you switch it off right away, There isn't one, Behind the saw - you unplug it, On the guide post] + answer: "On the front of the base - you switch it off right away" + why: Know where the switch is before you start, so you can hit it without looking. + origin: new + review: true # check against our saw's switch location diff --git a/content/raptacon/quizzes/drill-press.yml b/content/raptacon/quizzes/drill-press.yml new file mode 100644 index 0000000..c2fb60c --- /dev/null +++ b/content/raptacon/quizzes/drill-press.yml @@ -0,0 +1,115 @@ +# Drill press: the written half of tool-drill-press. Questions 1-12 are the Schoology +# "Drill Press Quiz" (ID 5867); 13-16 are new (gloves, speed, center punch, chips). + +quiz: + id: drill-press + name: Drill press safety quiz + item: tool-drill-press + pass: 100 + authored_by: # Corey and Marilyn wrote the Schoology originals; Chris added the new questions + - {name: Corey Kesler} + - {name: Marilyn Kemp} + - {name: Chris Hirsch, github: ChrisHirsch} + source: Schoology "Drill Press Quiz" (ID 5867) + +questions: + - q: What do you do with long hair at the drill press? + choices: ["Keep your head back", "Get a haircut", "Tie it back or put it under a cap, and keep your head away from moving parts", "Hold it away with one hand"] + answer: "Tie it back or put it under a cap, and keep your head away from moving parts" + why: The spindle winds hair in faster than you can react. + origin: schoology + + - q: Which protective equipment is absolutely required at the drill press? + choices: [Safety glasses, Steel-toed shoes, A leather apron, Leather gloves] + answer: "Safety glasses" + why: Chips fly off the bit. And no gloves near the spinning chuck. + origin: schoology + + - q: Which of these makes the drill press unsafe to use? + choices: [Slippery floor from spilled cutting oil, Tools and scrap cluttering the table, A loose belt guard, All of these] + answer: "All of these" + why: Fix each one before you start. + origin: schoology + + - q: The part starts spinning with the bit. What do you do? + choices: ["Move the table to block it", "Stop it with your hands", "Tap it with a hammer", "Switch off, let it stop, then free the part"] + answer: "Switch off, let it stop, then free the part" + why: A spinning part is a blade. Never grab it. + origin: schoology + + - q: You are drilling a material you haven't drilled before. You always... + choices: [make sure you have the right bit, unplug it and inspect the guide, oil the bit, check with a mentor first] + answer: "check with a mentor first" + why: Different materials need different bits, speeds and clamping. + origin: schoology + + - q: Before turning on the drill press, you... + choices: [tighten the table lock, clamp the work in a vise or to the table, remove the chuck key, do all of these] + answer: "do all of these" + why: A chuck key left in the chuck becomes a projectile when the spindle starts. + origin: schoology + + - q: Which is NOT a safe way to hold metal for drilling? + choices: [Between stops mounted on the table, A clamp, A drill press vise, Holding it firmly by hand on the table] + answer: "Holding it firmly by hand on the table" + why: If the bit grabs, a hand-held part spins and cuts you. + origin: schoology + + - q: When a bit seizes (grabs), it can... + choices: [break the bit, spin the vise, slip in the chuck, do all of these] + answer: "do all of these" + why: That's why the work is clamped and you ease off the feed. + origin: schoology + + - q: When you finish drilling, what do you do first? + choices: [Take the part out of the vise, Take the bit out of the chuck, Switch off the drill press, Nothing] + answer: "Switch off the drill press" + why: Hands near the work only after the spindle has stopped. + origin: schoology + + - q: How do you drill a long piece? + choices: [Support only the clamped end, Put the long end to your right, Support the far (unclamped) end, Nothing special] + answer: "Support the far (unclamped) end" + why: An unsupported long piece tips and twists the part out of the vise. + origin: schoology + + - q: After drilling, which hazard should you watch for? + choices: [Stress in the material, Hot cutting oil, Sharp edges and burrs around the hole, A dull bit] + answer: "Sharp edges and burrs around the hole" + why: Deburr the hole before handling the part. + origin: schoology + + - q: How do you keep the bit from seizing as it goes through? + choices: [Put wood under the part, Slow the bit down, Ease off the feed pressure as the bit breaks through, Keep the bit oiled] + answer: "Ease off the feed pressure as the bit breaks through" + why: The bit grabs most as it breaks through the far side. Ease off there. + origin: schoology + review: true # original key said "as the bit begins to cut"; changed to "breaks through" + + - q: Do you wear gloves at the drill press? + choices: ["Yes, to protect your hands", "No - a glove can catch on the bit or chuck and pull your hand in", "Only leather gloves", "Only for metal"] + answer: "No - a glove can catch on the bit or chuck and pull your hand in" + why: Bare hands, clamped work. + origin: new + review: true + + - q: How does bit size change the spindle speed? + choices: [Bigger bits need a slower speed, Bigger bits need a faster speed, Speed doesn't matter, Always use the fastest speed] + answer: "Bigger bits need a slower speed" + why: A big bit at high speed overheats and grabs. Check the speed chart, or ask a mentor. + origin: new + review: true + + - q: What do you do before drilling a hole in metal? + choices: [Center punch the mark, Nothing, Oil your hands, Heat the metal] + answer: "Center punch the mark" + why: The punch mark keeps the bit from wandering off your layout line. + origin: new + review: true + + - q: How do you clear chips from the table? + choices: ["With a brush, after the spindle stops", "With your hand while it runs", "Blow them at someone", "Leave them"] + answer: "With a brush, after the spindle stops" + why: Metal chips are razor sharp, and hot. + origin: new + review: true diff --git a/content/raptacon/quizzes/general.yml b/content/raptacon/quizzes/general.yml new file mode 100644 index 0000000..baa32a9 --- /dev/null +++ b/content/raptacon/quizzes/general.yml @@ -0,0 +1,145 @@ +# General shop safety: the written half of onb-safety-test. Questions 1-11 are the +# Schoology "General Safety Quiz" (ID 8399), reworded for a shuffled quiz; 12-20 are new. + +quiz: + id: general + name: General shop safety quiz + item: onb-safety-test + pass: 100 + authored_by: # Corey and Marilyn wrote the Schoology originals; Chris added the new questions + - {name: Corey Kesler} + - {name: Marilyn Kemp} + - {name: Chris Hirsch, github: ChrisHirsch} + source: Schoology "General Safety Quiz" (ID 8399) + +questions: + - q: Which of these is never allowed in the shop? + choices: [Working and cleaning, Carelessness and horseplay, Thinking and planning, Asking for help] + answer: "Carelessness and horseplay" + why: Horseplay around tools and machines is how people get hurt. Everything else is exactly what we want. + origin: schoology + + - q: A tool or machine is damaged or not working right. What do you do? + choices: [Fix it yourself, Tell a mentor and put an "out of order" tag on it, Keep using it carefully, Put it back so someone else can deal with it] + answer: "Tell a mentor and put an \"out of order\" tag on it" + why: A mentor decides how it gets fixed, and the tag stops the next person from using it. + origin: schoology + review: true # the original answer was "only b and c" (report it, and tag it) + + - q: While you work in the shop, you should not... + choices: [listen, shout, think, plan your next step] + answer: "shout" + why: Shouting startles people who are using tools. Get close and talk normally, or wait until they stop. + origin: schoology + + - q: A teammate shows up under the influence of drugs or alcohol. What do you do to keep them safe? + choices: [Tell a mentor, Keep them away from power tools and machines, Tell a mentor and keep them away from power tools and machines, Nothing - it is not your business] + answer: "Tell a mentor and keep them away from power tools and machines" + why: They can't work safely, so they stay off the tools, and a mentor needs to know right away. + origin: schoology + review: true # the original answer was "both a and b" + + - q: Before you use a power tool for the first time, you should... + choices: [plan what you are going to do before you start, take a rest, find another student to run it for you, start and figure it out as you go] + answer: "plan what you are going to do before you start" + why: Know the cut, where your hands go and how you'll stop before the tool is running. + origin: schoology + + - q: A visitor walks into the shop. What should happen first? + choices: [Give them a pair of safety glasses, Make them leave, Show them what you are doing on a machine, Have them take the safety quiz] + answer: "Give them a pair of safety glasses" + why: Everyone in the shop wears eye protection, visitors included. + origin: schoology + + - q: Loud noises in the shop make other people... + choices: [annoyed, happy, more likely to have an accident, work faster] + answer: "more likely to have an accident" + why: A sudden noise makes people flinch, and a flinch next to a blade is how accidents happen. + origin: schoology + + - q: Which of these do you report to a mentor right away? + choices: [An accident, An injury, A broken or damaged tool, All of these] + answer: "All of these" + why: Mentors need to know about every accident, injury and broken tool, every time. + origin: schoology + + - q: When do you wear safety glasses in the shop? + choices: ["Only with chemicals", "Only in hazardous areas", "At all times, unless a mentor says other face protection is needed", "Only when using power tools"] + answer: "At all times, unless a mentor says other face protection is needed" + why: Chips and debris fly from other people's work too. Glasses on the whole time you are in the shop. + origin: schoology + + - q: Shop clothing is unsafe if it is... + choices: [loose, baggy, flammable, all of these] + answer: "all of these" + why: Loose or baggy clothes catch in moving parts, and flammable fabric is dangerous around sparks. + origin: schoology + + - q: While you work in the shop, you should never... + choices: [use tools you are signed off on, get the tools you need yourself, put tools and supplies back where they belong, distract or disturb other people while they work] + answer: "distract or disturb other people while they work" + why: Someone running a tool needs all their attention on it. + origin: schoology + + - q: Can you use a tool or machine you haven't been signed off on? + choices: ["Yes, if you are careful", "Yes, if a teammate shows you how", "No - only tools you are signed off on", "Only if no mentor is around to ask"] + answer: "No - only tools you are signed off on" + why: Team handbook rule. The sign-off is how we know you have been trained on that tool. + origin: new + review: true + + - q: What shoes do you wear in the shop? + choices: [Sandals or flip-flops, Closed-toe shoes, Any shoes, Socks are fine on clean floors] + answer: "Closed-toe shoes" + why: Dropped parts, tools and stock land on feet. Closed toes, every time. + origin: new + review: true + + - q: You're about to use a drill press. Which of these do you do first? + choices: ["Tie back long hair", "Take off rings, watches and bracelets", "Roll up or secure loose sleeves", "All of these"] + answer: "All of these" + why: Rotating tools grab hair, jewelry and sleeves and pull you in. + origin: new + review: true + + - q: Which of these should you know where to find before you start working? + choices: [The first aid kit, The fire extinguisher, The eyewash station, All of these] + answer: "All of these" + why: In an emergency there is no time to look for them. Your shop orientation shows you each one. + origin: new + review: true + + - q: You get a small cut that barely bleeds. What do you do? + choices: [Ignore it, Tell a mentor and clean it with the first aid kit, Keep working and wash it at home, Wrap it in tape] + answer: "Tell a mentor and clean it with the first aid kit" + why: Every injury gets reported and cleaned, even small ones. Mentors have to record it. + origin: new + review: true + + - q: Before you reach into the robot to work on a mechanism, you should... + choices: [Make sure it is disabled, Make sure it is disabled and the main breaker is off (or the battery unplugged), Ask the driver to go slowly, Nothing - it is safe when nobody is driving] + answer: "Make sure it is disabled and the main breaker is off (or the battery unplugged)" + why: A robot can move unexpectedly while it has power. No power, no surprise. + origin: new + review: true + + - q: Is it OK to use compressed air to blow dust off your clothes or at a teammate? + choices: ["Yes, it is just air", "Only on low pressure", "No, never", "Only on clothes, not skin"] + answer: "No, never" + why: Compressed air can push debris into eyes or skin, and through skin into the blood. + origin: new + review: true + + - q: Should you wear gloves when using a drill press, lathe, mill or other rotating machine? + choices: ["Yes, always", "No - gloves can catch and pull your hand in", "Only leather gloves", "Only for metal"] + answer: "No - gloves can catch and pull your hand in" + why: A glove caught by a spinning bit or chuck drags the hand in with it. + origin: new + review: true + + - q: Can you use power tools in the shop when no mentor is there? + choices: ["Yes, if you are signed off", "No - power tools only with a mentor or approved adult present", "Yes, for quick cuts", "Only hand power tools"] + answer: "No - power tools only with a mentor or approved adult present" + why: Someone trained has to be there to help if something goes wrong. + origin: new + review: true # confirm the exact team rule diff --git a/content/raptacon/quizzes/mill.yml b/content/raptacon/quizzes/mill.yml new file mode 100644 index 0000000..a1e81fe --- /dev/null +++ b/content/raptacon/quizzes/mill.yml @@ -0,0 +1,146 @@ +# Milling machine: the written half of tool-mill. Questions 1-11 are the Schoology "Milling +# Machine Safety Test" (ID 2990); 12-15 were diagram questions on a JET mill photo, rewritten +# to name the controls instead; 16-20 are new. (Schoology scored this test at 0 points.) + +quiz: + id: mill + name: Milling machine safety quiz + item: tool-mill + pass: 100 + authored_by: # Corey and Marilyn wrote the Schoology originals; Chris added the new questions + - {name: Corey Kesler} + - {name: Marilyn Kemp} + - {name: Chris Hirsch, github: ChrisHirsch} + source: Schoology "Milling Machine Safety Test" (ID 2990) + +questions: + - q: Always make sure the ______ are sharp and in good condition. + choices: [wrenches, rags, cutters, hammers] + answer: "cutters" + why: A dull or chipped cutter grabs, chatters and can break. + origin: schoology + + - q: Before turning on the spindle, what do you check? + choices: [The draw bar wrench is removed, The tool and stock are held tight, The speed range is set correctly, All of these] + answer: "All of these" + why: A wrench left on the draw bar flies off when the spindle starts. + origin: schoology + + - q: When setting up a job, move the table so the work is as far as possible from the... + choices: [cutter, DRO, chuck, lathe] + answer: "cutter" + why: Set up with room to spare, so your hands are nowhere near the cutter. + origin: schoology + + - q: How do you clear chips from the work? + choices: [With paper, With the cutter, With a file, With a brush - never your hands] + answer: "With a brush - never your hands" + why: Mill chips are sharp and hot. + origin: schoology + + - q: Never reach over a ______ cutter. + choices: [broken, clean, rotating, cold] + answer: "rotating" + why: Reaching over a spinning cutter puts your arm in its path. + origin: schoology + + - q: On our variable-speed mill, the RPM (fine speed) is adjusted while the cutter is... + choices: [rotating, stopped, clean, dirty] + answer: "rotating" + why: The variable-speed drive only changes speed while turning. The high/low range is different - see the next question. + origin: schoology + review: true # true for a variable-speed (Reeves) head; confirm for our mill + + - q: The speed range (high/low gear) is changed only while the cutter is... + choices: [rotating, stopped, clean, dirty] + answer: "stopped" + why: Shifting gears while running strips them. + origin: schoology + + - q: Never take an excessively ______ cut or feed. It could break the cutter and hurt you. + choices: [heavy, light, loud, slow] + answer: "heavy" + why: Too much at once overloads the cutter. Take several lighter passes. + origin: schoology + + - q: Which of these is NOT a proper use of the spindle brake? + choices: [Stopping the spindle after switching off, Holding the spindle to loosen the draw bar, Adjusting the spindle speed, They are all proper uses] + answer: "Adjusting the spindle speed" + why: The brake stops and holds the spindle. Speed is set with the speed controls. + origin: schoology + review: true # reworded: "rapidly stopping the spinning tool" became "after switching off" + + - q: Which part do you use to drill a hole straight down? + choices: [The quill, The spindle, The table, The power feed] + answer: "The quill" + why: The quill feed handle moves the spindle up and down for drilling. + origin: schoology + + - q: Which axis does the quill move along? + choices: [Z, X, Y] + answer: "Z" + why: Z is up and down. X and Y are the table's left-right and in-out moves. + origin: schoology + + - q: What raises and lowers the knee (the whole table)? + choices: [The crank on the front of the knee, The quill handle, The table handwheel, The power feed lever] + answer: "The crank on the front of the knee" + why: The knee crank moves the knee, table and all, for big height changes. + origin: schoology + review: true # was a diagram question (answer Q); confirm it matches our mill + + - q: Which handwheel moves the table left and right (the X axis)? + choices: [The handwheel at the end of the table, The handwheel on the front of the saddle, The knee crank, The quill handle] + answer: "The handwheel at the end of the table" + why: The table handwheels move X; the saddle handwheel in front moves Y. + origin: schoology + review: true # was a diagram question (answer M) + + - q: Which handwheel moves the table toward and away from you (the Y axis)? + choices: [The handwheel on the front of the saddle, The handwheel at the end of the table, The knee crank, The quill handle] + answer: "The handwheel on the front of the saddle" + why: The saddle moves in and out on the knee. + origin: schoology + review: true # was a diagram question (answer T) + + - q: Where do you adjust the spindle speed? + choices: [The speed control on the head, The knee crank, The table handwheel, The DRO] + answer: "The speed control on the head" + why: Speed is set on the head (the variable-speed dial or handwheel), not on the table controls. + origin: schoology + review: true # was a diagram question (answer B) + + - q: Who must be in the shop when you run the mill? + choices: [A mentor, A teammate, Nobody - you are signed off, Anyone] + answer: "A mentor" + why: The mill is a mentor-supervised machine, every time. + origin: new + review: true + + - q: Do you wear gloves while the mill is running? + choices: ["No - they can catch in the cutter or spindle", "Yes, always", "Only leather", "Only when cleaning chips"] + answer: "No - they can catch in the cutter or spindle" + why: A caught glove pulls the hand in. + origin: new + review: true + + - q: How is the work held? + choices: [Clamped tight in the vise or to the table, Held by hand, Resting on the table, Taped down] + answer: "Clamped tight in the vise or to the table" + why: The cutter pushes hard. Anything loose gets thrown. + origin: new + review: true + + - q: Can you walk away while the mill runs (for example, on power feed)? + choices: ["No - stay at the machine until the spindle stops", "Yes, on power feed", "Yes, for a minute", "Yes, if a teammate watches"] + answer: "No - stay at the machine until the spindle stops" + why: Something can go wrong at any moment. The operator stays with the machine. + origin: new + review: true + + - q: Before using the power feed, you... + choices: [set the table stops so it can't run into the vise or the end of travel, turn the speed all the way up, take your glasses off to see better, nothing] + answer: "set the table stops so it can't run into the vise or the end of travel" + why: Power feed doesn't stop by itself. The stops do. + origin: new + review: true diff --git a/content/raptacon/quizzes/miter-saw.yml b/content/raptacon/quizzes/miter-saw.yml new file mode 100644 index 0000000..f305dfd --- /dev/null +++ b/content/raptacon/quizzes/miter-saw.yml @@ -0,0 +1,113 @@ +# Chop / miter saw: the written half of tool-chop-saw. Questions 1-9 are the Schoology +# "Compound Miter Saw" quiz (ID 6486); 10-15 are new (aluminum, clamping, small parts). + +quiz: + id: miter-saw + name: Chop / miter saw safety quiz + item: tool-chop-saw + pass: 100 + authored_by: # Corey and Marilyn wrote the Schoology originals; Chris added the new questions + - {name: Corey Kesler} + - {name: Marilyn Kemp} + - {name: Chris Hirsch, github: ChrisHirsch} + source: Schoology "Compound Miter Saw" (ID 6486) + +questions: + - q: When do you need a mentor's permission to use the miter saw? + choices: [Always, Never, Sometimes, Only for long cuts] + answer: "Always" + why: The miter saw is a mentor-supervised machine. + origin: schoology + + - q: What is the right way to dress for the miter saw? + choices: [Remove jewelry, Secure loose clothing, Tie back long hair, All of these] + answer: "All of these" + why: A spinning blade catches anything loose. + origin: schoology + + - q: When do you wear your safety glasses and hearing protection at the miter saw? + choices: [Sometimes, Always, Never, Only when watching someone else] + answer: "Always" + why: Chips fly and the saw is loud, every cut. + origin: schoology + review: true # added hearing protection, which tools.yml requires + + - q: Before changing the blade or doing any maintenance, you... + choices: [turn the saw off, turn the saw off and unplug it, lock the arm down, keep the guard in place] + answer: "turn the saw off and unplug it" + why: "Off isn't enough: unplugged, it can't start while your hands are on the blade." + origin: schoology + + - q: Before cutting, check all that apply. + choices: [The guard is in place and works, The stock has no defects, The stock is held tight against the fence, The blade is at full speed before it touches the stock] + answers: [The guard is in place and works, The stock has no defects, The stock is held tight against the fence, The blade is at full speed before it touches the stock] + why: All four, every cut. + origin: schoology + + - q: Where do your hands go while cutting? + choices: ["Cross-armed, holding the stock on the far side", "At least 6 inches (150 mm) from the blade", "Off the stock entirely", "As close to the blade as possible"] + answer: "At least 6 inches (150 mm) from the blade" + why: Six inches is the no-hands zone. Clamp the stock if your hand would have to be closer. + origin: schoology + + - q: When you finish cutting, what is the next step? + choices: [Switch off and wait for the blade to stop completely, Leave the chips and offcuts, Walk away right away, Raise the arm while the blade is still spinning] + answer: "Switch off and wait for the blade to stop completely" + why: A coasting blade cuts as well as a running one. + origin: schoology + + - q: What blade does the saw need? + choices: ["Any diameter blade", "The right blade for the material - a non-ferrous blade for aluminum", "A dull blade", "Any blade, even with missing teeth"] + answer: "The right blade for the material - a non-ferrous blade for aluminum" + why: The wrong blade grabs and kicks. We cut aluminum, so the saw gets a non-ferrous blade. + origin: schoology + review: true # original answer "a cross-cut blade"; changed to match tools.yml (aluminum) + + - q: How do you start and finish a cut? + choices: ["Start and stop halfway down", "Start with the blade fully up, then let it stop completely in the down position before raising it", "Start and stop in the full upright position", "Start and stop in the full down position"] + answer: "Start with the blade fully up, then let it stop completely in the down position before raising it" + why: Raising a spinning blade can throw the offcut. Manufacturers say to let it stop first. + origin: schoology + review: true # original key said "in the full upright position"; changed to match manufacturer manuals and tools.yml + + - q: How do you hold stock for a cut? + choices: [Clamped (or held firmly) flat against the fence and table, Free on the table, Held up in the air, With your other hand on the far side of the blade] + answer: "Clamped (or held firmly) flat against the fence and table" + why: Stock that can move gets grabbed by the blade and thrown. + origin: new + review: true + + - q: A piece is too short to keep your hand 6 inches from the blade. What do you do? + choices: ["Hold it closer, carefully", "Clamp it, or cut it from a longer piece", "Hold it with pliers", "Push it with a stick while cutting"] + answer: "Clamp it, or cut it from a longer piece" + why: Short pieces put your hand in the danger zone. Clamp them or cut from longer stock. + origin: new + review: true + + - q: Where should you never reach while the blade is spinning? + choices: [Behind or under the blade, Toward the switch, To the far end of a long board, Nowhere is off limits] + answer: "Behind or under the blade" + why: Reaching across or under a spinning blade is how serious injuries happen. + origin: new + review: true + + - q: An offcut is stuck next to the blade. What do you do? + choices: ["Flick it away while the blade spins", "Switch off, wait for the blade to stop, then remove it", "Blow it away", "Leave it for the next cut"] + answer: "Switch off, wait for the blade to stop, then remove it" + why: Never clear offcuts near a spinning blade. + origin: new + review: true + + - q: How many pieces do you cut at once? + choices: [One, As many as fit, Two stacked, Depends on the length] + answer: "One" + why: Stacked or side-by-side pieces shift and get thrown. One piece, clamped. + origin: new + review: true + + - q: How do you cut round tube or bar? + choices: [Clamped so it can't roll, Held loosely, Rolling it during the cut, Only with a helper holding it] + answer: "Clamped so it can't roll" + why: The blade spins round stock. Clamped, it stays put. + origin: new + review: true diff --git a/content/raptacon/quizzes/sander.yml b/content/raptacon/quizzes/sander.yml new file mode 100644 index 0000000..9d0636d --- /dev/null +++ b/content/raptacon/quizzes/sander.yml @@ -0,0 +1,112 @@ +# Belt and disc sander: the written half of tool-sander. The Schoology "Sander Safety Test" +# (ID 2207) had one question (1 below); 2-14 are new, following the sign-off steps in +# tools.yml and common sander safety rules. + +quiz: + id: sander + name: Belt and disc sander safety quiz + item: tool-sander + pass: 100 + authored_by: # Corey and Marilyn wrote the Schoology originals; Chris added the new questions + - {name: Corey Kesler} + - {name: Marilyn Kemp} + - {name: Chris Hirsch, github: ChrisHirsch} + source: Schoology "Sander Safety Test" (ID 2207), expanded + +questions: + - q: Is it safe to use a sanding belt or disc with torn edges? + choices: ["Yes, if you are careful", "No - pieces can tear off and hit you", "Yes, on low speed", "Only for wood"] + answer: "No - pieces can tear off and hit you" + why: A torn belt can come apart at full speed. Tell a mentor so it gets replaced. + origin: schoology + + - q: How big should the gap be between the table (or tool rest) and the belt or disc? + choices: [No more than 1/16 inch, About 1/4 inch, About 1/2 inch, It doesn't matter] + answer: "No more than 1/16 inch" + why: A bigger gap can grab the part and pull it - and your fingers - in between. + origin: new + review: true + + - q: When can you adjust the table or tool rest? + choices: [While the sander runs, Only with the sander off and stopped, Any time, Only on low speed] + answer: "Only with the sander off and stopped" + why: Adjusting next to a moving belt or disc puts your hands where they can be pulled in. + origin: new + review: true + + - q: On the disc sander, which side of the disc do you sand on? + choices: [The side moving down toward the table, The side moving up away from the table, Either side, The center] + answer: "The side moving down toward the table" + why: On the down side the disc pushes the part into the table. On the up side it lifts and throws it. + origin: new + review: true + + - q: How do you sand a very small part? + choices: ["Hold it with your fingertips", "Hold it in a clamp or holder, or don't sand it on the machine", "Push it with your thumb", "Let it go and catch it"] + answer: "Hold it in a clamp or holder, or don't sand it on the machine" + why: Small parts put your fingertips right against the abrasive. Use a holder, or file it by hand. + origin: new + review: true + + - q: How much pressure do you use? + choices: ["Light pressure, keeping the part moving", "As hard as you can", "Hold it still in one spot", "Push until it stops the belt"] + answer: "Light pressure, keeping the part moving" + why: Heavy pressure overheats the part and can stall the belt or tear it. Let the abrasive work. + origin: new + review: true + + - q: Why do we keep aluminum and wood sanding separate (and empty the dust collector)? + choices: [It doesn't matter, Sparks and hot metal dust can set wood dust on fire, Aluminum dulls the belt faster, Wood dust ruins aluminum parts] + answer: "Sparks and hot metal dust can set wood dust on fire" + why: Metal dust and sparks plus wood dust in the collector is a real fire risk. + origin: new + review: true + + - q: A metal part gets hot while you sand it. What do you do? + choices: ["Keep going, it's fine", "Stop and let it cool (or cool it), using short passes", "Hold it with gloves", "Grab it with a rag"] + answer: "Stop and let it cool (or cool it), using short passes" + why: Metal heats fast on a sander and burns fingers. Gloves near a moving belt are a catch hazard. + origin: new + review: true + + - q: What do you check and set up before turning the sander on? + choices: [Belt or disc is in good shape and the table is locked with a tiny gap, Dust collection is on, You know where the switch is, All of these] + answer: "All of these" + why: Good abrasive, locked table, dust collection and a known off switch, every time. + origin: new + review: true + + - q: What do you wear and remove before sanding? + choices: ["Safety glasses on", "Hair tied back", "No loose sleeves, gloves or jewelry", "All of these"] + answer: "All of these" + why: The belt grabs loose things. Eyes need protecting from dust and grit. + origin: new + review: true + + - q: The sander grabs your part and pulls it. What do you do? + choices: [Hold on tight, Let go and switch the sander off, Pull it back out while it runs, Reach in to get it] + answer: "Let go and switch the sander off" + why: Fighting the machine pulls your hand in. Let go; parts are replaceable, fingers aren't. + origin: new + review: true + + - q: Which part of the belt do you sand against? + choices: [The flat section backed by the platen (the metal plate behind the belt), The curved part over the rollers, The top edge, Anywhere on the belt] + answer: "The flat section backed by the platen (the metal plate behind the belt)" + why: Backed by the platen the belt is supported. Over the rollers or unsupported, the part can be thrown. + origin: new + review: true + + - q: How do you clean up when you are done? + choices: ["Switch off, wait for it to stop, then brush the dust away", "Wipe the belt with your hand while it runs", "Blow the dust off with compressed air at your face", "Leave it for the next person"] + answer: "Switch off, wait for it to stop, then brush the dust away" + why: Never near a moving belt, and brushes - not hands - for dust and metal slivers. + origin: new + review: true + + - q: Where do you keep your fingers while sanding? + choices: [At least 2 inches from the belt or disc, Touching the table next to the belt, Wherever they hold the part best, Under the part] + answer: "At least 2 inches from the belt or disc" + why: Keep a gap so a slip doesn't put a fingertip on the abrasive. + origin: new + review: true # check our team's distance rule diff --git a/content/raptacon/trees/onboarding.yml b/content/raptacon/trees/onboarding.yml index d98a568..cc81d0c 100644 --- a/content/raptacon/trees/onboarding.yml +++ b/content/raptacon/trees/onboarding.yml @@ -297,16 +297,15 @@ items: section: safety roles: [student, mentor] kind: score - pass_score: null # TODO + pass_score: 100 # the general safety quiz (quizzes/general.yml); retakes are unlimited verify: - method: signoff # v1: mentor confirms the Schoology result; v2 = auto-graded team quiz + method: signoff # a mentor sees the quiz pass screen and signs off claim: true by: {any_of: [{role: safety-officer}, {role: lead-mentor}]} renews: season visibility: team training: - {type: doc, label: "FIRST Safety Manual", url: "https://www.firstinspires.org/hubfs/web/program/all/safety-manual.pdf?hsLang=en"} - - {type: link, label: Safety test (Schoology)} # TODO link - id: onb-shop-orientation name: Shop safety orientation diff --git a/generators/checklist.py b/generators/checklist.py index 386838e..ab97fac 100644 --- a/generators/checklist.py +++ b/generators/checklist.py @@ -128,7 +128,9 @@ def build_item(item, roles, conditions, ctx): "practical": item.get("practical"), "bonus": item.get("bonus", []), "signoff": common.signoff_link(item, ctx["trees"], ctx["team_doc"]), - "training": [r for r in item.get("training", []) if not r.get("roles") or set(r["roles"]) & set(roles)], + "training": [r for r in item.get("training", []) if not r.get("roles") or set(r["roles"]) & set(roles)] + + ([{"type": "quiz", "label": "Safety quiz (pass at 100%, then a mentor signs you off)", "url": ctx["quizzes"][item["id"]]}] + if item["id"] in ctx["quizzes"] else []), "parts": [{"name": p["name"], "who": " or ".join(describe_by(p.get("by"), ctx))} for p in item.get("parts", [])], } @@ -193,6 +195,7 @@ def load_ctx(): "all_items": common.own_items(trees), "member_roles": {r["id"]: r for r in roles_doc["member_roles"]}, "signoff_roles": {r["id"]: r for r in roles_doc["signoff_roles"]}, + "quizzes": common.quiz_pages(), "conditions": {c["id"]: c for c in roles_doc["conditions"]}, "holders": common.role_holders(season), "team_doc": team, diff --git a/generators/common.py b/generators/common.py index 8519330..8475826 100644 --- a/generators/common.py +++ b/generators/common.py @@ -1,6 +1,7 @@ """Shared loading helpers for the generators - keeps content//*.yml as the one source of truth without each script re-deriving the same lookups.""" +import glob import os import shutil from urllib.parse import quote @@ -68,6 +69,21 @@ def resolve_items(tree_doc, items_by_id, include_hidden=False): return resolved +def load_quizzes(): + """{quiz_id: quiz doc} from /quizzes/*.yml (empty if there are none).""" + out = {} + for path in sorted(glob.glob(os.path.join(DATA, "quizzes", "*.yml"))): + with open(path) as f: + doc = yaml.safe_load(f) + out[doc["quiz"]["id"]] = doc + return out + + +def quiz_pages(): + """{item_id: quiz page file name}: the skills that have a written safety quiz.""" + return {q["quiz"]["item"]: f"quiz-{qid}.html" for qid, q in load_quizzes().items()} + + def signoff_link(item, trees, team): """Pre-filled sign-off form URL for an item recorded by a person, or None. The form lists only `verify.method: signoff` items that aren't hidden or diff --git a/generators/overview.py b/generators/overview.py index da88592..a39ce61 100644 --- a/generators/overview.py +++ b/generators/overview.py @@ -67,6 +67,7 @@ def v2_card(item, tree_id, home, ctx): "draft": item.get("status") == "draft", "detail": detail, "bonus": item.get("bonus", []), + "quiz": common.quiz_pages().get(item["id"]), "signoff": common.signoff_link(item, ctx["trees"], ctx["team_doc"]), } diff --git a/generators/quiz.py b/generators/quiz.py new file mode 100644 index 0000000..3e425c7 --- /dev/null +++ b/generators/quiz.py @@ -0,0 +1,39 @@ +#!/usr/bin/env python3 +"""Render a page per safety quiz (content//quizzes/*.yml) as quiz-.html: +questions and choices shuffled on every attempt, retakes until the pass mark, +the "why" for each miss, and on a pass a QR code for that skill's pre-filled +sign-off form - the mentor watches the practical and signs off. The quiz never +records anything; the sign-off does.""" + +import json + +from jinja2 import Environment, FileSystemLoader + +import checklist +import common +import overview + + +def main(): + ctx = checklist.load_ctx() + team = common.load_team() + env = Environment(loader=FileSystemLoader(common.TEMPLATES), trim_blocks=True, lstrip_blocks=True) + common.copy_brand_assets() + for qid, doc in common.load_quizzes().items(): + q = doc["quiz"] + item = ctx["all_items"].get(q["item"]) + if item is None: + raise SystemExit(f"quiz {qid}: no item {q['item']}") + signoff = common.signoff_link(item, ctx["trees"], team) + questions = [{"q": x["q"], "choices": x["choices"], "answers": x.get("answers") or [x["answer"]], "why": x["why"]} for x in doc["questions"]] + common.write_html( + env, "quiz.html.j2", f"quiz-{qid}.html", + team=team["team"], season=ctx["season"], quiz=q, item=item, count=len(questions), + data=json.dumps({"pass": q.get("pass", 100), "questions": questions}).replace(" {% if c.description %}{{ c.description }}{% endif %} {% for b in c.bonus %}

🍿 Bonus: {{ b.label }}

{% endfor %} + {% if c.quiz %}

📝 Take the safety quiz →

{% endif %} {% if c.detail %}

Full details, training and test →

{% endif %} {% if c.signoff %}

✅ Leads & mentors: sign off this skill

{% endif %} diff --git a/generators/templates/quiz.html.j2 b/generators/templates/quiz.html.j2 new file mode 100644 index 0000000..ea10419 --- /dev/null +++ b/generators/templates/quiz.html.j2 @@ -0,0 +1,112 @@ +{% from "_theme.html.j2" import theme_toggle %} + + + + +{{ quiz.name }} - {{ team.name }} {{ team.number }} + +{% include "_theme.html.j2" %} + + +{{ theme_toggle() }} + +

{{ quiz.name }}

+
For the skill {{ item.name }} · {{ count }} questions · pass at {{ quiz.pass }}%
+

This is the written half of your sign-off. Answer every question; you can retake it as many times as you need, and it shows + why for anything you miss. Pass it, then show the pass screen to a mentor: they watch you use the tool safely and sign you off.

+
+
+
Questions by {{ authors }}. {{ season }} season.
+ + + diff --git a/generators/templates/site_index.html.j2 b/generators/templates/site_index.html.j2 index f15433a..8bf9cad 100644 --- a/generators/templates/site_index.html.j2 +++ b/generators/templates/site_index.html.j2 @@ -62,6 +62,15 @@ {% endfor %} + {% if quizzes %} +

Safety quizzes

+ + + {% endif %}

Subteam trees

{% for t in subteams %}