Rewrite app copy: friendly ask, skimmable Q&A, detailed consent, CTA

app.py

@@ -16,92 +16,143 @@ from redactors import engine
 
 PASSPHRASE = os.environ.get("APP_PASSPHRASE", "")
 
+# Where students should send questions / ask to have their report removed.
+# TODO: replace with a real BBH contact email.
+CONTACT = "the BBH team"
+
 st.set_page_config(page_title="STARS Report Redactor", page_icon="🛡️",
                    layout="centered")
 
-st.title("🛡️ STARS Report Redactor")
-st.caption("Remove your personal information and grades from a USC STARS "
-           "Degree Progress Report before sharing it with the BUAI Builder Hub (BBH).")
+# ---------------------------------------------------------------- the ask ----
+st.title("🛠️ Help us build better tools for USC students")
+
+st.markdown(
+    "BBH (the **BUAI Builder Hub**) is hard at work building tools to make "
+    "**degree planning, course registration, and picking classes** way less of "
+    "a headache. One thing y'all keep telling us is a pain: actually "
+    "**making sense of your STARS report**.\n\n"
+    "**You can help.** We're putting together a set of STARS reports to build "
+    "against. If you're down, upload yours below — we'll strip out the sensitive "
+    "stuff (**your name, address, student ID, and grades**) right here, and only "
+    "ever keep the **redacted** version."
+)
+
+# ------------------------------------------------------------------- Q & A ----
+st.subheader("Quick questions you might have")
 
-with st.expander("What this does and how your file is handled", expanded=True):
+with st.expander("Wait — are my grades going in a database?"):
     st.markdown(
-        "- **Removes** your name, student ID, mailing address, and sport/team.\n"
-        "- **Replaces every grade** with a pass/fail marker and **blanks out GPA** figures.\n"
-        "- Your uploaded file is processed **in memory on the server and is never "
-        "saved or logged** — only you receive the redacted copy.\n"
-        "- This is redaction, **not perfect anonymization**: your major, terms, and "
-        "course list remain, which could be identifying in a small program. "
-        "Please share only if you consent."
+        "Nope. Before anything gets saved, we swap **every grade for a plain "
+        "\"passed / didn't pass\" marker** and **wipe your GPA**. The copy we keep "
+        "literally doesn't have your letter grades in it — we can tell a class was "
+        "finished, not what you got in it."
     )
 
-with st.expander("How to download your STARS report (PDF)"):
+with st.expander("How do I even get my STARS report?"):
     st.markdown(
-        "1. Go to **experience.usc.edu** and open **My Academics**.\n"
+        "1. Go to **experience.usc.edu** → **My Academics**.\n"
         "2. Open your **STARS** (Degree Progress) report.\n"
-        "3. Click the **red Print button** at the top of the report.\n"
-        "4. In the print dialog, set the destination to **Save as PDF** and save the file.\n"
-        "5. Upload that saved PDF below."
+        "3. Hit the **red Print button** up top.\n"
+        "4. In the print pop-up, pick **Save as PDF** and save it.\n"
+        "5. Upload that PDF here. (Grab the real PDF from the site — a screenshot "
+        "or scan won't work.)"
+    )
+
+with st.expander("Why should I bother?"):
+    st.markdown(
+        "You'd be helping build tools that make planning your degree and getting "
+        "into the classes you need way less painful — for you *and* everyone after "
+        "you. It takes about two minutes, and your personal info and grades get "
+        "stripped out before anything is stored. That's it."
     )
 
-# --- access gate -----------------------------------------------------------
+st.markdown("### Ready? Let's do it 👇")
+
+# --------------------------------------------------------------- pass gate ----
 if not PASSPHRASE:
-    st.error("This app isn't configured yet (no access phrase set). "
-             "Please contact the team.")
+    st.error("This app isn't set up yet (no passphrase configured). Ping the team.")
     st.stop()
 
-entered = st.text_input("Access phrase", type="password",
-                        help="Provided to you by the BBH team.")
+entered = st.text_input("Passphrase", type="password")
+st.caption("If you're a USC student using this, whoever referred you should've "
+           "shared a passphrase.")
 if entered.strip() != PASSPHRASE:
     if entered:
-        st.warning("That access phrase isn't right. Please try again.")
+        st.warning("Hmm, that's not it — double-check with whoever sent you here.")
     st.stop()
 
-# --- redaction flow --------------------------------------------------------
+# ------------------------------------------------------- consent + upload ----
+with st.expander("📋 Please read this before you upload  —  what you're agreeing to",
+                 expanded=True):
+    st.markdown(
+        "- **This is totally voluntary.** You don't have to do it, and you can "
+        "close this page anytime. No penalty, no hard feelings.\n"
+        "- **What we keep:** only the **redacted** version of your STARS report — "
+        "the file this tool hands back after removing your personal info.\n"
+        "- **What's removed before anything is stored:** your **name, USC ID, "
+        "mailing address, sport/team**, every **letter grade** (each becomes a "
+        "simple pass/fail marker), and your **GPA**.\n"
+        "- **What stays in the file:** your **major/minor, the courses and terms "
+        "on your record, and your degree-progress details** — that's the part "
+        "we're actually building with.\n"
+        "- **Heads up on anonymity:** because that academic info stays in, we "
+        "**can't promise you're impossible to identify** — in a small major, "
+        "someone who already knows your situation might be able to guess. Only "
+        "share if you're comfortable with that.\n"
+        "- **Your original file** is processed on the spot and **not saved** by "
+        "this tool. You download the redacted copy yourself; if you send it back "
+        "to us, we store **only that redacted copy**.\n"
+        "- **How we use it:** to build and test tools that help USC students plan "
+        "degrees and register for classes. We won't sell it or try to identify "
+        "you.\n"
+        f"- **Changed your mind later?** It's your record and your call — you can "
+        f"ask us to delete your redacted report anytime. Contact {CONTACT}."
+    )
+
 consent = st.checkbox(
-    "I consent to share my redacted STARS report with the BUAI Builder Hub (BBH).")
+    "I've read the above and I'm good with sharing my **redacted** STARS report.")
 
 uploaded = st.file_uploader(
     "Upload your STARS report (the PDF you saved from experience.usc.edu)",
     type=["pdf"], accept_multiple_files=False)
 
 if uploaded is not None and not consent:
-    st.info("Please check the consent box above to proceed.")
+    st.info("Check the consent box above and you're good to go.")
 
 if uploaded is not None and consent:
-    with st.spinner("Redacting…"):
+    with st.spinner("Scrubbing your info…"):
         res, out = engine.redact_bytes(uploaded.getvalue(), {"pii", "grades"})
 
     status = res["status"]
     if status in ("REDACTED", "REVIEW") and out:
         g = res.get("grades", {})
-        st.success("Done — your redacted report is ready below.")
+        st.success("Done! Your redacted report is ready below. 🎉")
         st.write(
-            f"Removed **{len(res.get('pii', {}))}** identifier field(s), "
-            f"**{g.get('grades_replaced', 0)}** grade(s), and "
-            f"**{g.get('gpa_replaced', 0)}** GPA/points figure(s)."
+            f"We removed **{len(res.get('pii', {}))}** personal detail(s), turned "
+            f"**{g.get('grades_replaced', 0)}** grade(s) into pass/fail markers, and "
+            f"wiped **{g.get('gpa_replaced', 0)}** GPA/points number(s)."
         )
         if res.get("fragments"):
-            st.info("Part of your name may still appear inside a course title; "
-                    "the team will double-check before use.")
+            st.info("Part of your name might still show up inside a course title — "
+                    "we'll double-check that on our end.")
 
         stem = os.path.splitext(uploaded.name)[0]
         stem = stem.replace("DONOTSHARE_", "").replace("REDACTED_", "")
-        st.download_button("⬇️ Download redacted PDF", data=out,
+        st.download_button("⬇️ Download my redacted report", data=out,
                            file_name=f"REDACTED_{stem}.pdf",
                            mime="application/pdf")
-        st.caption("Download it, open it to confirm it looks right, then send it "
-                   "to the team as instructed.")
+        st.caption("Open it to make sure it looks right, then send it back to "
+                   "whoever referred you (or to the BBH team). Thank you! 🙏")
 
     elif status == "SKIPPED":
-        st.error("This PDF looks like a **scan** (it has no text layer), so it "
-                 "can't be redacted here. Please use the PDF you save via the "
-                 "**Print → Save as PDF** steps above on experience.usc.edu, "
-                 "rather than a scanned or photographed copy.")
+        st.error("This looks like a **scan or photo** (no text in it), so it can't "
+                 "be redacted here. Grab the actual PDF via **Print → Save as PDF** "
+                 "on experience.usc.edu and try again.")
     else:
-        st.error("The redaction could not be fully verified, so **no file was "
-                 "produced**. Please contact the team — and do not share the "
-                 "original in the meantime.")
+        st.error("Something didn't check out, so we **didn't produce a file** — "
+                 f"better safe than sorry. Please reach out to {CONTACT}, and "
+                 "don't share the original in the meantime.")
 
 st.divider()
-st.caption("Internal tool of the BUAI Builder Hub (BBH) / BBHCourseReg project. "
-           "Processing happens in memory; no files are stored.")
+st.caption("A BUAI Builder Hub (BBH) project. Your file is processed in memory; "
+           "nothing is stored by this tool.")