kirukib
c2fd9d6431
Scaffold Gishen Admin: React/Vite shadcn console with role modules, EN/AM i18n, mocks, and backend spec. Co-authored-by: Cursor <cursoragent@cursor.com>
54 lines
1.4 KiB
Markdown
54 lines
1.4 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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 |
|
|
|
|
## Docs
|
|
|
|
Living backend contract: [`docs/admin-backend-spec.md`](docs/admin-backend-spec.md) — updated whenever modules are finalized.
|
|
|
|
## Deploy
|
|
|
|
- `vercel.json` SPA rewrites for React Router
|
|
- Build: `npm run build` → `dist`
|
|
- Remote: `https://gitea.yaltopia.com/Gishen/Gishen-Admin.git`
|
|
- Host on **Vercel** as a new project (CLI if Gitea import unavailable)
|
|
|
|
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)
|