Gishen Admin Console

Internal ops console for Gishen Pharmacy — Pharmacist, Stock, Procurement, Finance, Marketing, Operations/Dispatch, Super Admin. Built as a React (Vite) SPA with shadcn/ui, Gishen branding, and English / Amharic i18n.

Stack

• React 19 + Vite + TypeScript
• Tailwind + shadcn-style Radix components
• Zustand, React Router, Axios-ready, Recharts, Sonner
• i18next (en / am)
• Mocks by default (VITE_USE_MOCKS=true)

Quick start

npm install
npm run dev

Demo password for all accounts: demo123

Email	Role
admin@gishen.et	Super Admin
pharmacist@gishen.et	Pharmacist (Bole branch)
stock@gishen.et	Stock Manager
procurement@gishen.et	Procurement
finance@gishen.et	Finance
marketing@gishen.et	Marketing Manager
ops@gishen.et	Operations

Navigation registry

src/config/navigation.ts is the single source of truth for every navigable page and quick action. The sidebar and the topbar command palette (⌘K / Ctrl+K) both read from it, and results are filtered by the signed-in role.

Adding a page? Register it there alongside its route in src/app/AppRoutes.tsx — otherwise it will not show up in the sidebar or in search.

Docs

Living backend contract: docs/admin-backend-spec.md — updated whenever modules are finalized.

Deploy

• Live: https://gishen-admin.vercel.app (Vercel project yaltopiatech/gishen-admin)
• vercel.json SPA rewrites for React Router
• Build: npm run build → dist
• Git remote: https://gitea.yaltopia.com/Gishen/Gishen-Admin.git
• Redeploy: npx vercel --prod --yes --scope yaltopiatech (Gitea is not auto-linked; use CLI or mirror to GitHub for Git integration)

Env:

VITE_USE_MOCKS=true
VITE_API_BASE_URL=

Related repos

• Gishen-Ecom — customer storefront
• Gishen-B2B — institutional portal (org self-register UI lives there; Admin creates/approves orgs)