DCI Interoperability PoC (SP‑MIS ↔ ESS)

A Turborepo monorepo demonstrating DCI interoperability flows between the Social Protection MIS (SP‑MIS) and Employment Services System (ESS), built with Next.js 13+, TypeScript, and shadcn/ui.

---

⚙️ Prerequisites

• Node.js 20+
• pnpm 10 or newer

---

🚀 Getting Started

Clone the repository and install dependencies:

pnpm install

Start all apps in development mode from the project root:

pnpm dev

This will run both Next.js applications concurrently:

• SP‑MIS → http://localhost:3000
• ESS → http://localhost:3001

---

🧩 Monorepo Structure

apps/
  ess/       # Employment Services System (ESS)
  sp-mis/    # Social Protection MIS (SP-MIS)
packages/
  ui/        # Shared shadcn/ui component library
  eslint-config/
  typescript-config/
  types/     # Shared types

Each app uses the Next.js App Router (app/ directory) and shares the same design system through the @workspace/ui package.

---

💅 shadcn/ui Integration

This template is based on the official shadcn/ui setup, pre‑configured for monorepos.

Adding new components

From the repository root, run:

pnpm dlx shadcn@latest add button -c apps/ess

This will place the UI component inside the shared package:

packages/ui/src/components/

---

🎨 Tailwind CSS

Tailwind is already configured across the monorepo:

• Each Next.js app imports its theme via globals.css.
• tailwind.config.ts is set up to read styles from the ui package.

---

🧱 Using Shared Components

Use any shared component in your apps by importing from the ui package:

import { Button } from "@workspace/ui/components/button";

---

🧠 Developing Flows

PRS.EMPL.01 – SP → ESS

Demonstrates a Social Protection → Employment referral with lawful consent, automated eligibility, and case feedback.

PRS.EMPL.02 – ESS → SP

Demonstrates an Employment → Social Protection referral, verification, and enrollment with real‑time status synchronization.

---

🧩 Commands

Command	Description
pnpm install	Install dependencies for all apps and packages
pnpm dev	Run all applications in development mode

---

✅ Quick Start Summary

1. Install dependencies

   pnpm install

2. Start both Next.js apps

   pnpm dev

3. Visit:

   • SP‑MIS → http://localhost:3000
   • ESS → http://localhost:3001