Skip to content

Clinical triage and nursing pre-assessment platform for walk-in clinics. Designed from a nursing and clinical operations perspective to support patient prioritisation, waiting-time visibility, and safer patient flow. Conceptual / demonstration project.

License

Notifications You must be signed in to change notification settings

NunoSid/WalkFlow

Repository files navigation

WalkFlow logo

Clinical Triage & Nursing Pre‑Assessment Platform
Plataforma de Triagem Clínica e Pré‑Avaliação de Enfermagem


Demo

gif


🇬🇧 English

⚠️ Disclaimer

WalkFlow is a conceptual / demonstration project. It is designed for clinical triage modelling and nursing pre‑assessment workflows.

It must not be used with real identifiable patient data (PHI) without appropriate security review, regulatory compliance, and information governance.


Overview

WalkFlow is a clinical operations support platform focused on early clinical triage and nursing pre‑assessment in Walk‑in Clinics and unscheduled care settings.

Designed from a nursing and clinical‑operations perspective, WalkFlow supports:

  • Initial triage and prioritisation of walk‑in patients
  • Structured nursing pre‑assessment before medical evaluation
  • Waiting‑time visibility and queue management
  • Safer patient routing and flow control
  • Operational traceability, audit, and governance

WalkFlow does not replace clinical decision‑making systems.
It supports workflow organisation, risk stratification, and operational safety.


Intended Audience

  • Nurses working in walk‑in clinics or urgent care
  • Nurse coordinators and triage teams
  • Clinical operations and patient‑flow managers
  • Health IT and digital‑health professionals

Core Capabilities

  • Nursing triage – structured initial assessment and prioritisation
  • Pre‑assessment workflows – standardised data capture before medical evaluation
  • Waiting‑time monitoring – real‑time queue status and operational visibility
  • Risk flags & alerts – early identification of potentially unstable patients
  • Role‑based access control (RBAC) – Nurse / Coordinator / Administrator
  • Audit & traceability – operational logs and activity history

Architecture Overview

Frontend (React + Vite)
        ↓ REST API
Backend (NestJS)
        ↓ Prisma ORM
Database (SQLite / PostgreSQL)

Technology Stack

  • Frontend: React (Vite)
  • Backend: NestJS
  • ORM: Prisma
  • Database: SQLite (default) / PostgreSQL (optional)

Quick Start (Local Development)

chmod +x start.sh
./start.sh

Environment configuration

cd server
cp env.example .env

Default values are suitable for local development.

The .env file is intentionally excluded from version control.


Demo Access

The WalkFlow demo environment includes preconfigured demo accounts to explore the platform features.

⚠️ Important

These credentials are for demonstration purposes only. They do not contain real patient data and must never be used in production environments.

Demo Accounts

Role Username Password
Administrator admin 123456

Role-based access control (RBAC) is enforced, and each profile exposes different operational capabilities.


Security Notes (Minimum)

  • Do not expose database ports publicly
  • Use a strong JWT_SECRET
  • Restrict CORS to authorised frontend domains
  • Remove demo credentials in any real deployment
  • Enforce RBAC server‑side
  • Maintain audit logs for triage and status changes

License

MIT License.
Free to use, modify, and learn from.
Not intended for production clinical use without appropriate validation.


🇵🇹 Português (Portugal)

⚠️ Aviso Importante

O WalkFlow é um projeto conceptual / de demonstração, orientado para a modelação de fluxos de triagem clínica e pré‑avaliação de enfermagem.

Não deve ser utilizado com dados reais identificáveis de utentes (PHI) sem avaliação prévia de segurança, conformidade legal e adequada governação da informação.


Visão Geral

O WalkFlow é uma plataforma de suporte à operação clínica, focada na triagem inicial e pré‑avaliação de enfermagem em Walk‑in Clinics e contextos de atendimento não programado.

Concebida a partir da perspetiva da Enfermagem e das operações clínicas, permite:

  • Triagem estruturada do utente à entrada
  • Priorização clínica inicial
  • Pré‑avaliação de enfermagem antes da observação médica
  • Monitorização de tempos de espera e listas de atendimento
  • Melhoria do fluxo do utente e segurança assistencial

O WalkFlow não substitui sistemas clínicos oficiais, funcionando como uma camada de apoio operacional e organizacional.


Destinatários

  • Enfermeiros em contexto de atendimento não programado
  • Enfermeiros coordenadores e equipas de triagem
  • Gestores de fluxo de doentes e operações clínicas
  • Profissionais de Sistemas de Informação em Saúde

Funcionalidades Principais

  • Triagem de enfermagem – avaliação inicial estruturada
  • Pré‑avaliação clínica – recolha normalizada de dados relevantes
  • Gestão de tempos de espera – visibilidade operacional em tempo real
  • Alertas de risco – sinalização precoce de situações críticas
  • Controlo de acessos (RBAC) – Enfermeiro / Coordenador / Administrador
  • Auditoria e rastreabilidade – histórico de ações e estados

Arranque Rápido (Desenvolvimento Local)

chmod +x start.sh
./start.sh

Configuração de ambiente

cd server
cp env.example .env

Os valores por defeito são adequados para desenvolvimento local.

O ficheiro .env encontra‑se intencionalmente excluído do controlo de versões.


Acesso Demo

O ambiente de demonstração do WalkFlow inclui contas de acesso pré-configuradas para exploração das funcionalidades da plataforma.

⚠️ Aviso Importante

Estas credenciais destinam-se exclusivamente a fins de demonstração. Não contêm dados reais de utentes e não devem ser utilizadas em ambiente produtivo.

Contas de Demonstração

Perfil Utilizador Palavra-passe
Administrador admin 123456

O controlo de acessos por perfil (RBAC) encontra-se ativo, estando cada utilizador limitado às permissões do respetivo papel.

Licença

Licença MIT.
Projeto educativo e conceptual.
Não destinado a utilização clínica em produção sem validação adequada.


Contact

About

Clinical triage and nursing pre-assessment platform for walk-in clinics. Designed from a nursing and clinical operations perspective to support patient prioritisation, waiting-time visibility, and safer patient flow. Conceptual / demonstration project.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages