Files
zerp/README.md
Talal Sharabi 35daa52767 feat: Complete Z.CRM system with all 6 modules
 Features:
- Complete authentication system with JWT
- Dashboard with all 6 modules visible
- Contact Management module (Salesforce-style)
- CRM & Sales Pipeline module (Pipedrive-style)
- Inventory & Assets module (SAP-style)
- Tasks & Projects module (Jira/Asana-style)
- HR Management module (BambooHR-style)
- Marketing Management module (HubSpot-style)
- Admin Panel with user management and role matrix
- World-class UI/UX with RTL Arabic support
- Cairo font (headings) + Readex Pro font (body)
- Sample data for all modules
- Protected routes and authentication flow
- Backend API with Prisma + PostgreSQL
- Comprehensive documentation

🎨 Design:
- Color-coded modules
- Professional data tables
- Stats cards with metrics
- Progress bars and status badges
- Search and filters
- Responsive layout

📊 Tech Stack:
- Frontend: Next.js 14, TypeScript, Tailwind CSS
- Backend: Node.js, Express, Prisma
- Database: PostgreSQL
- Auth: JWT with bcrypt

🚀 Production-ready frontend with all features accessible
2026-01-06 18:43:43 +04:00

2.7 KiB

Z.CRM System

نظام إدارة علاقات العملاء - نظام إدارة شامل

Enterprise-grade CRM system with 6 integrated modules:

  1. Contact Management - إدارة جهات الاتصال
  2. CRM - إدارة علاقات العملاء
  3. Inventory & Assets - إدارة المستودعات والأصول
  4. Tasks & Projects - إدارة المهام والمشاريع
  5. HR Management - إدارة الموارد البشرية
  6. Marketing - إدارة التسويق

Tech Stack

Backend

  • Node.js + Express + TypeScript
  • PostgreSQL with Prisma ORM
  • JWT Authentication
  • Role-based Access Control (RBAC)

Frontend

  • Next.js 14 with TypeScript
  • Tailwind CSS
  • RTL Support (Arabic/English)
  • React Query for data fetching

Installation

# Install all dependencies
npm run install-all

# Setup database
cd backend
cp .env.example .env
# Edit .env with your database credentials
npx prisma migrate dev
npx prisma generate
npx prisma db seed

Development

# Run both backend and frontend
npm run dev

# Or run separately
npm run dev:backend  # Backend on port 5000
npm run dev:frontend # Frontend on port 3000

Production

npm run build
npm start

Project Structure

z_crm/
├── backend/           # Express API server
│   ├── src/
│   │   ├── modules/
│   │   │   ├── contacts/      # Module 1
│   │   │   ├── crm/           # Module 2
│   │   │   ├── inventory/     # Module 3
│   │   │   ├── projects/      # Module 4
│   │   │   ├── hr/            # Module 5
│   │   │   └── marketing/     # Module 6
│   │   ├── shared/
│   │   ├── auth/
│   │   └── config/
│   ├── prisma/
│   └── tests/
├── frontend/          # Next.js application
│   ├── src/
│   │   ├── app/
│   │   ├── components/
│   │   ├── modules/
│   │   └── lib/
│   └── public/
└── docs/             # Documentation

Key Features

  • Unified ID system for all contacts
  • Duplicate detection and merging
  • Complete audit logging
  • Hierarchical organizational structure
  • Multi-level approval workflows
  • Role-based permissions from HR module
  • 360° contact history
  • Full Arabic & English support
  • Document versioning
  • Soft delete (archiving)
  • Advanced search & filtering

Security

  • JWT-based authentication
  • HR module controls all system access
  • Field-level permissions
  • Complete audit trail
  • Data masking for sensitive info
  • No default delete - archive only

License

Proprietary - © مجموعة أتمتة