Inspiration

Medical bills and lab reports can be confusing, stressful, and time-consuming. We wanted to implement a focused tool that translates codes and numbers into human language and actionable insights—no hand-waving, just clarity.

What it does

Upload a hospital bill or lab report (PDF/photo), OCR extracts text; parsers detect CPT codes and common lab values. After, AI generates plain-English explanations, cost context, and next steps. Profiles store basic health data for personalized guidance.

How we built it

  • Spring Boot + Spring Security for auth and routing (login/register/intake/dashboard).

  • Thymeleaf UI with a simple app shell (left nav + top bar + cards).

  • JPA/Hibernate (H2 dev DB) with User, Profile, and Document entities.

  • Local file storage for uploads; OCR via a service wrapper (Tesseract locally; Textract pluggable).

Lightweight parsers:

 - Bills: extract CPT codes and map to human names.

 - Labs: recognize lipid panel values (Total/LDL/HDL) with ref ranges and severity.

 - AI service crafts patient-friendly summaries and action tips (OpenAI API).

Challenges we ran into

  • OCR variability across scans/photos.
  • Normalizing messy line items into reliable CPT matches.
  • Avoiding “black box” vibes—hence the verified, side-by-side UX.

Accomplishments that we're proud of

  • End-to-end MVP: register → intake → upload → analyze → findings + actions.
  • Clean, trustworthy UI with quick actions.

What we learned

  • Patients want answers + actions, not raw numbers.
  • Transparency (showing the original) increases confidence in AI output.
  • Narrow scope wins: doing bills + labs well beats an everything-app.

What's next for Care Portal

  • Expand parsers (CMP/CBC, A1C, thyroid), more CPT coverage.
  • Pull price benchmarks from CMS/FAIR Health; flag outliers.
  • Export to PDF, share via secure link/QR, multilingual output, TTS.
  • Cloud storage (S3), encryption-at-rest, audit logs, and HIPAA hardening.

Built With

  • h2-(dev)
  • java-17
  • lombok
  • maven
  • openai-(planned)
  • spring-boot
  • spring-data-jpa
  • spring-security
  • tesseract-ocr-(local)-/-aws-textract-(optional)
  • thymeleaf
Share this project:

Updates