docs and data

NSBE 2026 Baltimore Company_ Schools - Companies.csv

@@ -0,0 +1,139 @@
+Company List ,Pre-Conference interview or registartion links ,Column 4,Direct links to company Career/job openings page ,"Creator Donise Griffin: me on linkedln :)
+ https://www.linkedin.com/in/donise-griffin/","idea from lasts years 2025 list follow @mohamedhaithvm
+https://www.linkedin.com/in/mohamed-ahmed-429302228/"
+3M,,,openings page ,,
+"ABB, Inc",2026 Annual NSBE Convention | ABB,, openings page ,"Download the Mobile App for 2026 
+NSBE Annual Convention!",iOS:     
+Abbott,https://www.jobs.abbott/us/en/event/690bb1ceaf6b261cdd97d267/National-Society-of-Black-Engineers-Conference-2026,, openings page ,,Android:
+Accenture,,, openings page ,FairControls is the AI intelligence hub for events.,
+AECOM,,, openings page ,Before the career fair you can:,
+Air products,,, openings page ,🤖 Instantly understand every company attending,
+Airbus,,, openings page ,AI summaries + suggested questions to ask recruiters.,
+Amazon,,,openings page ,,
+Apple ,,, openings page ,,
+Arcadis ,https://arcadis.eightfold.ai/events/candidate?plannedEventId=Oa34M69ekv&domain=arcadis.com,, openings page ,,
+Arconic,,, openings page ,,
+Arup US Inc.,,, openings page ,,
+Astrazeneca Phaaceuticals LP,,, openings page ,,
+Barnes Group,,, openings page ,,
+Bechtel,https://bechtel.recsolu.com/app/collect/event/oSDe4PqZi3dHMdvevlBHjw,, openings page ,,
+"Bentley Systems, Inc.", ,, openings page ,,
+Black Blockchain labs,,,openings page ,,
+Blue Origin,,, openings page ,,
+BNY Mellon,https://eofe.fa.us2.oraclecloud.com/hcmUI/CandidateExperience/en/sites/CX_1001/job/74341/?utm_medium=jobshare&utm_source=External+Job+Share,, openings page ,,
+Bohler Engineering,https://bohler.recsolu.com/app/collect/event/J5TOHMJAPIRuH2YeEciT6w,,openings page,,
+Bristol-Myers Squibb,https://app.eightfold.ai/events/candidate?plannedEventId=GRj3OxoJ,, openings page ,,
+Burns & Mcdonnell,https://burnsmcd.recsolu.com/app/collect/event/iF1_1Zs9E3lBPYpjJ1nbjw,, openings page ,,
+"Cadence Design Systems, Inc.",https://cadence.yello.co/app/collect/event/7cdPwuX2_SeybbUJ3LmK-g?utm_source=hsamplify&utm_medium=linkedin&utm_term=8e24b117-2b45-4061-a1a6-82a6ba199b83,, openings page ,,
+"Capital One, Inc.",,, openings page ,,
+"Cargill, Incorporated",,, openings page ,,
+Caterpillar Inc.,https://caterpillar.yello.co/app/collect/event/egBb1GTxd55C3z7aKjbaJw,, openings page ,,
+Cheveron ,https://chevron.wd5.myworkdayjobs.com/University/event/a377a322e71f1001ad4c7bfcbf060001/register,, openings page ,,
+Clorox,https://wd1.myworkdaysite.com/recruiting/clorox/Clorox/page/e10acc474cc31001f01c95bbe6f10000,, openings page ,,
+ConocoPhillips,,, openings page ,,
+Constellation Energy,,, openings page ,,
+"Cook Medical Holdings, Inc.",,, openings page ,,
+"Cummins, Inc.",,, openings page ,,
+Dairy Farmers of America,,, openings page ,,
+Dauch Corporation,,, openings page ,,
+Dell Technologies,,, openings page ,,
+Deloitte,,, openings page ,,
+"Delta Air Lines, Inc",,LOOKING FOR PEOPLE FOR  CO-OPS , openings page ,,
+"Dodge Industrial, Inc.",,, openings page ,,
+DPR Construction,,, openings page ,,
+Draper,,, openings page ,,
+Duracell,,, openings page ,,
+Eaton Corporation,Find Eaton at NSBE,, openings page ,,
+"Edwards Lifesciences, LLC",https://flows.beamery.com/httpswwwedwardscomcareershome/edwards-nsbe-2026?utm_source=linkedin&utm_medium=video&utm_content=voe,, openings page ,,
+Ernst & Young LLP,,, openings page ,,
+"ESRI (Environmental Systems Research Institute, Inc.)",,, openings page ,,
+Estee lauder Companies ,,,openings page ,,
+ExxonMobile,,,openings page ,,
+Fish & Richardson P.C.,,, openings page ,,
+FM Global,,, openings page ,,
+Fonteva,,, openings page ,,
+Ford Motor Company,"Ford Events 2 | Instagram, Facebook | Linktree
+
+Ford Pre-Registration Link",, openings page ,,
+Freeport-McMoRan Inc,,, openings page ,,
+GE Aerospace,https://careers.geaerospace.com/global/en/event/697cccfc19232421f311f22f/GE-Aerospace-NSBE-2026-National-Convention-and-Career-Fair,, openings page ,,
+GE Healthcare,https://careers.gehealthcare.com/global/en/event/6970f96419232421f311e00c/National-Society-of-Black-Engineers-NSBE-Convention-2026,, openings page ,,
+GE Vernova,https://olivia.paradox.ai/co/GEVernova32/Event/2026NSBEAnnualConvention,, openings page ,,
+"General Dynamics, Inc.",,, openings page ,,
+General Motors,,, openings page ,,
+GHD,,, openings page ,,
+Gilbane Building Company,,, openings page ,,
+Givelify,,, openings page ,,
+Goldman Sachs,https://higher.gs.com/campus?DIVISION=Engineering%20Division&EXPERIENCE_LEVEL=Summer%20Analyst&LOCATION=New%20York%7CDallas%7CSalt%20Lake%20City&page=1&sort=POSTED_DATE,, openings page ,,
+Granite Construction,,, openings page ,,
+Hensel Phelps,,, openings page ,,
+Honeywell,https://app.brazenconnect.com/a/honeywell/e/zq7jm?utm_source=event%20page&utm_medium=flyer&utm_campaign=honeywell%20nsbe%202026,,openings page,,
+Intel Corporation,,,openings page ,,
+IQT,,,openings page ,,
+Jabil Inc.,,, openings page ,,
+Jacobs,https://jacobs.avature.net/eventlisting/EventDetail?eventId=29715,, openings page ,,
+John Deere,,, openings page ,,
+Johnson & Johnson Family of Companies,,, openings page ,,
+Kiewit,https://olivia.paradox.ai/co/Kiewit27/Event/2026NSBEAnnualConvention,, openings page ,,
+KLA,,, openings page ,,
+L'Oreal,,,openings page ,,
+Lam Research Corporation,,, openings page ,,
+Lenovo,,, openings page ,,
+Linde,,, openings page ,,
+Lockheed Martin Corporation,,, openings page ,,
+Los Angeles Department of Water and Power,,, openings page ,,
+Marvell Technology,,, openings page ,,
+MathWorks,,,openings page ,,
+McCarthy Building Companies,,, openings page ,,
+"Merck & Co., Inc.",https://jobs.merck.com/us/en/event/68ac56791218cc52521fd372/2026-NSBE-Annual-Convention,, openings page ,,
+Michigan Department of Transportation,,,openings page ,,
+Micron,,,openings page ,,
+"Microsoft, Inc.",,, openings page ,,
+Morgan Stanley ,,,openings page ,,
+Mortenson Construction,https://mortenson.recsolu.com/app/collect/event/6669UqBJAL4x9TwP_MyomA,, openings page ,,
+"Nintendo of America, Inc.",,, openings page ,,
+Nucor Corporation,,, openings page ,,
+NVIDIA,,, openings page ,,
+Pacific Gas and Electric Company,,, openings page ,,
+PBF Energy,,, openings page ,,
+"PepsiCo, Inc.",,, openings page ,,
+Perdue Farms,,,openings page ,,
+"Pfizer, Inc.",,, openings page ,,
+Ramboll,,, openings page ,,
+22,,, openings page ,,
+Rockwell Automation,,, openings page ,,
+Sandia National Laboratories,,, openings page ,,
+Schneider Electric,,, openings page ,,
+"Siemens, Inc.",,, openings page ,,
+Skanska,,, openings page ,,
+SMART Scholarship For Service Program,,, openings page ,,
+Smurfit Westrock,,, openings page ,,
+Southern Company,,, openings page ,,
+"Southwire Company, Inc.",,, openings page ,,
+SpaceX,,, openings page ,,
+SSOE Group,,,openings page ,,
+Swinerton,,,openings page ,,
+Target Corporation ,,,openings page ,,
+TE Connectivity,,, openings page ,,
+Teledyne Technologies,https://teledyne.yello.co/app/collect/event/xZobTUiCcDSAQkNmciQr3Q,, openings page ,,
+"Terracon Consultants, Inc.",https://sjobs.brassring.com/TGnewUI/Search/home/HomeWithPreLoad?PageType=JobDetails&partnerid=25664&siteid=5383&jobid=5211397#jobDetails=5211397_5383,, openings page ,,
+Texas Department of Transportation,,,openings page ,,
+Texas Instruments,,, openings page ,,
+The Clorox Company,https://wd1.myworkdaysite.com/recruiting/clorox/Clorox/page/e10acc474cc31001f01c95bbe6f10000,, openings page ,,
+The Whiting-Turner Contracting Company,,, openings page ,,
+Toyota,,, openings page ,,
+"Trane Technologies, Inc.",https://careers.tranetechnologies.com/global/en/event/697bbe1219232421f311f0c9/NSBE-2026-Career-Fair-with-Trane-Technologies-Booth-1681B,, openings page ,,
+"Trimble, Inc.",,, openings page ,,
+Turner Construction,,, openings page ,,
+UL standards and enterprise,,,openings page ,,
+United Airlines,,,openings page ,,
+United Parcel Service (UPS),,, openings page ,,
+Universal Destinations & Experiences,,, openings page ,,
+United States Postal Service (USPS),,, openings page ,,
+USAA,,, openings page ,,
+Vetex pharmaceuticals,,,openings page ,,
+Wabtec Corporation,https://careers.wabtec.com/events,, openings page ,,
+Walter P. Moore,,, openings page ,,
+Wells Fargo,https://talent.wellsfargojobs.com/flows/nsbe-annual-convention-2026-lyofuh0jm,, openings page ,,
+"WSP USA, Inc",,, openings page ,,
+Worley,RSVP,,openings page ,,

app.py

@@ -0,0 +1,7 @@
+import gradio as gr
+
+def greet(name):
+    return "Hello " + name + "!!"
+
+demo = gr.Interface(fn=greet, inputs="text", outputs="text")
+demo.launch()

docs/backend_overview.md

@@ -0,0 +1,64 @@
+# Backend Overview
+
+## Responsibilities
+- Parse resumes
+- Build user profile
+- Load companies
+- Scrape job boards
+- Extract jobs
+- Score matches
+- Return ranked results
+
+## Core Services
+
+### Resume Parser
+- Extract text from PDF
+- Return raw text
+
+### AI Profile Builder
+- Convert text → structured JSON
+- Extract:
+  - skills
+  - roles
+  - tools
+  - experience level
+
+### Company Loader
+- Load built-in CSV OR uploaded CSV
+- Validate structure
+
+### Fetcher
+- requests first
+- Playwright fallback
+
+### ATS Detector
+Detect:
+- Greenhouse
+- Lever
+- Workday
+- SmartRecruiters
+- iCIMS
+
+### Job Extractor
+Return:
+- title
+- location
+- url
+- department
+
+### Scorer
+Compare job vs resume:
+- skill overlap
+- role match
+- entry-level fit
+- location fit
+
+### Ranker
+Aggregate:
+- # matches
+- avg score
+- best role
+
+### Talking Point Generator
+Generate:
+- 1–2 sentences per company

docs/data_flow.md

@@ -0,0 +1,50 @@
+# Data Flow
+
+## Pipeline
+
+Resume + Company List
+        ↓
+Text Extraction
+        ↓
+AI Resume Parsing
+        ↓
+Profile Cleanup
+        ↓
+Company Loader
+        ↓
+Fetch Careers Pages
+        ↓
+ATS Detection
+        ↓
+Job Extraction
+        ↓
+Matching Engine
+        ↓
+Company Ranking
+        ↓
+Results Display
+
+## Key Steps
+
+### Resume → Profile
+Extract:
+- skills
+- tools
+- roles
+
+### Jobs → Structured Data
+Extract:
+- title
+- location
+- url
+
+### Matching
+Score:
+- title match
+- skill overlap
+- entry-level signals
+
+### Output
+- ranked companies
+- job matches
+- explanations

docs/frontend_overview.md

@@ -0,0 +1,55 @@
+# Frontend Overview
+
+## Tech
+Gradio (Hugging Face Spaces)
+
+## Goals
+- Simple
+- Fast
+- Demo-friendly
+
+## UI Sections
+
+### Resume Upload
+Upload PDF
+
+### Company Source
+- Use built-in list
+- Upload CSV
+
+### Built-In Lists
+- NSBE
+- Big Tech
+- Finance
+- Cyber
+
+### Preferences
+- Entry-level only
+- Remote preferred
+
+### Analyze Button
+Triggers pipeline
+
+## Results Tabs
+
+### Ranked Companies
+- company
+- score
+- # matches
+
+### Matching Jobs
+- title
+- location
+- link
+
+### Resume Profile
+- skills
+- roles
+
+### Talking Points
+- what to say to recruiter
+
+## Design Principles
+- no friction
+- clear results
+- easy to understand

docs/system_overview.md

@@ -0,0 +1,62 @@
+# AI Career Fair Matcher - System Overview
+
+## Purpose
+AI Career Fair Matcher helps students identify which companies to prioritize at career fairs using AI + job board analysis.
+
+Users upload a resume and the system:
+- extracts skills and experience
+- analyzes company job boards
+- ranks companies based on fit
+- suggests what to say to recruiters
+
+## Core Idea
+Turn:
+Resume + Company List → Actionable Career Strategy
+
+## Key Features
+- Resume upload (PDF)
+- AI-powered resume parsing
+- Built-in company lists (no setup needed)
+- Optional custom CSV upload
+- Job board scraping (requests + Playwright fallback)
+- Company ranking
+- Match explanations
+- Recruiter talking points
+
+## Inputs
+- Resume (PDF)
+- Company source:
+  - built-in CSV (default)
+  - uploaded CSV (optional)
+- Preferences (optional):
+  - entry-level only
+  - remote preference
+  - location
+
+## Outputs
+- Ranked companies
+- Matching job roles
+- Resume profile (JSON)
+- Match explanations
+- Talking points
+
+## Architecture
+1. Resume Processing
+2. AI Profile Extraction
+3. Company Loader
+4. Job Scraper
+5. ATS Detection
+6. Job Extraction
+7. Matching Engine
+8. Ranking Engine
+9. UI Display
+
+## Deployment Target
+Hugging Face Spaces (Gradio app)
+
+## Design Principles
+- Zero setup (works out of the box)
+- Explainable results
+- Modular backend
+- Resume-driven personalization
+- Resilient to broken job sites