Next-14-eWUŚ

About

This application facilitates the verification process of patients' health insurance status via eWUŚ (Electronic Verification of Eligibility of Beneficiaries) system of the National Health Fund of Poland.

Features

Health insurance status may be verified using:

• single PESEL number;
• single/multiple PESEL numbers in a CSV file.

Deployment

For demonstration purposes, the application is deployed on Vercel.

https://next-14-ewus.vercel.app

Test account information

The eWUŚ system provides developers with a single eWUŚ test account and only one user can be logged in at a time.

The test account of this application uses the eWUŚ test account behind the scenes.

Therefore, a logged in user may experience a session expiration message with subsequent redirection to the login page during PESEL number verification, caused by another developer who has meanwhile logged in using the same eWUŚ test account.

In such a case, the only solution is to repeat the login process.

Test account credentials

• Oddział NFZ (NFZ Provincial Branch)

  15
  

• Login

  TestEwus
  

• Hasło (Password)

  QwertY12#
  

Sample PESEL numbers for insurance status verification

Sample PESEL numbers are available in the sample-pesel-numbers.csv file located in the repository root folder.

The file contains 16 sample PESEL numbers from the official eWUŚ API documentation and 2 randomly generated numbers.

Authors

Krzysztof Borecki and Daniel Biesiada

Description

This is a Next.js project created with TypeScript, Tailwind CSS, ESLint and FastAPI.

• Frontend:
  • Next.js - a React framework for production.
  • TypeScript - a strongly typed superset of JavaScript.
  • Tailwind CSS - for styling and layout.
  • ESLint - for static code analysis (syntax errors, formatting issues etc.).
  • shadcn/ui - a collection of re-usable components built with Radix UI and Tailwind CSS.
  • zod - a TypeScript-first schema declaration and validation library.
  • react-hook-form - a React Hooks library for form validation.
  • jose - a JavaScript module for JSON Object Signing and Encryption, providing support for JSON Web Tokens (JWT).
  • Papa Parse - a CSV (or delimited text) parser for JavaScript.
  • Jest and React Testing Library - for Unit Testing.
• Backend:
  • FastAPI - a modern, fast (high-performance), web framework for building APIs with Python 3.8+ based on standard Python type hints.
  • Docker - for local development environment.