Gishen-Archive/Gishen-B2B
Archived
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
This repository has been archived on 2026-08-11. You can view files and clone it, but cannot push or open issues or pull requests.
6 Commits 1 Branch 0 Tags 582 KiB
TypeScript 98.7%
CSS 1.1%
JavaScript 0.2%
main
Go to file
kirukib f2e992e0bd Add multi-method login UI and document auth method contracts. 
Surface Google, email, phone, and Telegram on login (mocked), polish the brand panel and fixes for Button/Menu, and keep the backend spec sheet aligned.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-07 16:12:43 +03:00
docs Add multi-method login UI and document auth method contracts. 2026-08-07 16:12:43 +03:00
public Ship Gishen B2B institutional portal with polished layout and mock-backed flows. 2026-08-06 21:18:23 +03:00
src Add multi-method login UI and document auth method contracts. 2026-08-07 16:12:43 +03:00
.env.example Ship Gishen B2B institutional portal with polished layout and mock-backed flows. 2026-08-06 21:18:23 +03:00
.gitignore Ship Gishen B2B institutional portal with polished layout and mock-backed flows. 2026-08-06 21:18:23 +03:00
AGENTS.md Ship Gishen B2B institutional portal with polished layout and mock-backed flows. 2026-08-06 21:18:23 +03:00
CLAUDE.md Ship Gishen B2B institutional portal with polished layout and mock-backed flows. 2026-08-06 21:18:23 +03:00
components.json Ship Gishen B2B institutional portal with polished layout and mock-backed flows. 2026-08-06 21:18:23 +03:00
eslint.config.mjs Ship Gishen B2B institutional portal with polished layout and mock-backed flows. 2026-08-06 21:18:23 +03:00
next.config.ts Ship Gishen B2B institutional portal with polished layout and mock-backed flows. 2026-08-06 21:18:23 +03:00
package-lock.json Finalize portal polish: profile, avatars, ID cards, and list UX. 2026-08-06 21:57:07 +03:00
package.json Finalize portal polish: profile, avatars, ID cards, and list UX. 2026-08-06 21:57:07 +03:00
postcss.config.mjs Ship Gishen B2B institutional portal with polished layout and mock-backed flows. 2026-08-06 21:18:23 +03:00
README.md Ship Gishen B2B institutional portal with polished layout and mock-backed flows. 2026-08-06 21:18:23 +03:00
tsconfig.json Ship Gishen B2B institutional portal with polished layout and mock-backed flows. 2026-08-06 21:18:23 +03:00
vercel.json Ship Gishen B2B institutional portal with polished layout and mock-backed flows. 2026-08-06 21:18:23 +03:00
vercel.ts Ship Gishen B2B institutional portal with polished layout and mock-backed flows. 2026-08-06 21:18:23 +03:00

README.md

Gishen B2B

Institutional portal for Gishen corporate medical benefits clients (Feature Requirements §3).

Organisations hold the contract and credit limit. HR enrols people and configures packages. Finance sees covered spend and statements (no clinical detail). Members use their allowance, orders, and prescriptions.

Stack

  • Next.js 16 (App Router) + React 19 + TypeScript
  • Tailwind CSS 4 + shadcn/ui
  • next-intl (en / am)
  • TanStack Query + typed mock API adapters
  • Hosting: Vercel

Run locally

npm install
npm run dev

Open http://localhost:3000 — you will be redirected to /en/login.

Demo login

On /login, pick a persona:

Role Access
SUPER_USER Full portal (including clinical/Rx for support)
HR_ADMIN Org, departments, members, packages, migration — no clinical
FINANCE Spend, statements, approvals — no clinical
MEMBER Own benefits, orders, prescriptions

Use Switch demo user in the topbar profile menu to return to the role selector.

Language switcher is on login and in the topbar (English / አማርኛ).

Routes

Area Paths
Auth / signup /login, /register/organisation, /register/request, /join, /invite/[token]
Org /organisation, /departments, /settings/verification
People /members, /members/import, /members/[id]
Packages /packages, /packages/[id]
Migration /migration, /migration/new, /migration/[jobId]
Finance /finance, /finance/approvals, /statements
Member /me, /me/orders, /prescriptions, /prescriptions/new

All app routes are locale-prefixed (/en/..., /am/...).

Backend specs (standing rule)

This frontend ships against mocks typed to a living shared-backend spec:

  • docs/README.md — how to extend specs
  • docs/backend/ — entities, endpoints, events, OVERVIEW
  • docs/features/INDEX.md — feature → pages → entities → endpoints
  • docs/coordination/ — Admin / Ecom / open items

Whenever UI changes, update docs/backend/ and docs/features/INDEX.md in the same change.

Environment

Copy .env.example to .env.local:

cp .env.example .env.local
Variable Purpose
NEXT_PUBLIC_APP_URL Public URL
NEXT_PUBLIC_API_BASE_URL Shared API (unused while mocks are on)
NEXT_PUBLIC_USE_MOCKS Keep true until shared backend exists

Deploy (Vercel)

  1. Install and authenticate CLI: npm i -g vercel && vercel login
  2. From this repo: vercel link (project name e.g. gishen-b2b)
  3. vercel env pull (optional)
  4. Preview: vercel · Production: vercel --prod

Config: vercel.json. Connect the Gitea remote via Vercel Git integration when available.

Scripts

npm run dev      # development
npm run build    # production build
npm run start    # serve production build
npm run lint     # eslint

Brand

Gishen mint / black palette and logo from Gishen-Ecom (public/brand/gishen-logo.png, src/data/brand.ts). Layout patterns follow Fortune Admin ui (PageShell, collapsible sidebar, topbar) built with shadcn only.