CEOTR Ltd ERP Suite

A comprehensive, enterprise-grade web application for CEO Transnational Resources Limited (CEOTR Ltd) featuring advanced business management, portfolio showcase, analytics, and legal compliance.

🚀 Live Application

• Development: http://localhost:3001
• Production: https://ceotr-ltd-erp-suite.vercel.app (after deployment)

✨ Features

🎯 Core Business Features

• Multi-currency support - ₦ (Nigerian Naira), $ (USD), £ (GBP)
• Service catalog - Four comprehensive service offerings
• Interactive portfolio - Project galleries with lightbox
• Booking & quote system - Professional inquiry management
• Real-time analytics - Business metrics dashboard
• Legal compliance - GDPR, privacy policy, terms of service

🏢 ERP Modules

• Dashboard - Real-time business metrics and quick actions
• Leads - Customer relationship management
• Invoices - Billing and payment tracking
• Profile - User settings and authentication

🎨 Advanced UI/UX

• Mobile-first responsive design - Optimized for all devices
• Dynamic hero backgrounds - Auto-rotating project showcases
• Interactive galleries - Professional portfolio with thumbnails
• Smart image fallbacks - HEIC → WebP → placeholder system
• Professional testimonials - Client feedback with photos
• Modern animations - Smooth transitions and effects

🏢 Enterprise Components

• Analytics Dashboard - Real-time business metrics
• Legal Pages Suite - Privacy, Terms, Cookie Policy
• Professional Navigation - Enhanced header and footer
• Component Library - Reusable, maintainable code
• Performance Optimized - Fast loading and rendering

🛠️ Tech Stack

Frontend

• React 18 - Modern React with hooks
• Vite - Lightning-fast build tool
• TailwindCSS - Utility-first CSS framework
• Lucide React - Beautiful icon library
• React Context - State management
• React Router - Client-side routing

Backend & API

• Express.js - Mock API server
• Node.js - Server runtime
• RESTful endpoints - Professional API structure

Deployment & DevOps

• Vercel - Serverless deployment platform

🚀 Getting Started

Prerequisites

• Node.js (v16 or higher)
• npm or yarn

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/ceotr-ltd-erp-suite.git
   cd ceotr-ltd-erp-suite

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev:full

4. Open your browser and navigate to http://localhost:3001

📁 Project Structure

src/
├── components/          # React components
│   ├── Dashboard.jsx   # ERP dashboard
│   ├── Leads.jsx       # Lead management
│   ├── Invoices.jsx    # Invoice system
│   ├── Profile.jsx     # User profile
│   └── ...             # Other components
├── context/            # React context providers
├── data/              # Mock data and configurations
└── index.css          # Global styles

🎯 Usage

• Home Page: Overview of services and portfolio
• Dashboard: Access business metrics and quick actions
• Leads: Handle customer inquiries
• Invoices: Generate and manage invoices
• Profile: Update user information

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📞 Contact

• Email: [email protected]
• Phone: +234 806 450 8595
• Website: https://ceotrltd.com
• GitHub Integration - Automatic deployments
• Git - Version control
• npm - Package management

📦 Services Offered

1. 🏗️ Building Construction & Supervision

• Foundation to finishing construction
• Professional project oversight
• Quality assurance and compliance
• Modern architectural solutions

2. 💻 IT Services & Solutions

• Enterprise IT support and setup
• Network infrastructure
• System administration
• Cloud migration services

3. 🚀 Software Development

• Custom web applications
• Mobile app development
• E-commerce solutions
• API integrations and cloud systems

4. 📊 General Contracting & Business Management

• Procurement and logistics
• Strategic project execution
• Business process optimization
• Management consulting

🚀 Quick Start

Prerequisites

• Node.js (v18 or higher)
• npm or yarn
• Git (for version control)

Installation & Setup

1. Clone the repository:

git clone https://github.com/e-ogugua/ceotrLtdErpSuite.git
cd ceotrLtdErpSuite

2. Install dependencies:

npm install

3. Start development server:

npm run dev

4. Open browser: Navigate to http://localhost:3001

Production Build

npm run build
# Output: dist/ folder ready for deployment

📁 Project Structure

src/
├── components/
│   ├── Header.jsx              # Enhanced navigation with currency toggle
│   ├── Hero.jsx               # Dynamic hero with rotating backgrounds
│   ├── Services.jsx           # Service catalog with testimonials
│   ├── Portfolio.jsx          # Interactive project galleries
│   ├── Features.jsx           # Marketing features showcase
│   ├── Footer.jsx             # Professional footer with legal links
│   ├── BookingModal.jsx       # Professional booking forms
│   ├── QuoteModal.jsx        # Quote request system
│   ├── AnalyticsDashboard.jsx # Real-time business metrics
│   ├── CookiePolicy.jsx       # GDPR compliance
│   ├── PrivacyPolicy.jsx      # Privacy documentation
│   └── TermsOfService.jsx     # Legal terms and conditions
├── context/
│   └── CurrencyContext.jsx    # Multi-currency state management
├── data/
│   └── demoServices.js       # Comprehensive demo data
├── config/
│   └── currency.js           # Currency rates and configuration
├── App.jsx                   # Main application with routing
└── main.jsx                 # Application entry point

🎯 Key Features

Portfolio Galleries

• Interactive lightbox with navigation
• Thumbnail previews for all projects
• Smart image fallbacks (HEIC → WebP → placeholder)
• Professional project showcases

Analytics Dashboard

• Real-time metrics display
• Interactive charts and visualizations
• Business performance tracking
• Client engagement analytics

Legal Compliance Suite

• GDPR-compliant cookie policy
• Comprehensive privacy documentation
• Professional terms of service
• Business compliance ready

Advanced UI Components

• Dynamic backgrounds with auto-rotation
• Professional testimonials with client photos
• Responsive design for all devices
• Modern animations and transitions

🔧 Configuration

Currency Settings

Currency conversion rates are configured in src/config/currency.js:

const CURRENCIES = {
  NGN: { symbol: '₦', name: 'Nigerian Naira', rate: 1 },
  USD: { symbol: '$', name: 'US Dollar', rate: 0.0012 },
  GBP: { symbol: '£', name: 'British Pound', rate: 0.001 }
};

Vercel Deployment

Automatic deployment configuration in vercel.json:

{
  "outputDirectory": "dist"
}

Build Process

• Development: npm run dev (Vite dev server)
• Production: npm run build (optimized build)
• Preview: npm run preview (production preview)

📊 API Endpoints

Mock API Server

The application includes a comprehensive mock API:

• POST /api/booking - Submit booking requests
• POST /api/quote - Submit quote requests
• GET /api/health - Health check endpoint
• GET /api/analytics - Analytics data

🎨 Customization

Adding New Components

1. Create component in src/components/
2. Import and use in App.jsx
3. Add routing if needed
4. Update navigation links

Styling Guidelines

• TailwindCSS for all styling
• Mobile-first approach
• Custom components in src/index.css
• Consistent spacing and typography

Responsive Design

• sm: 640px+ - Mobile to tablet
• md: 768px+ - Tablet to desktop
• lg: 1024px+ - Desktop enhancements
• xl: 1280px+ - Large desktop

🚀 Deployment

Automatic Deployment (Recommended)

1. Connect to Vercel: GitHub integration enabled
2. Auto-deploy: Every push to master triggers deployment
3. Live URL: https://ceotr-ltd-erp-suite.vercel.app

Manual Deployment

# Build for production
npm run build

# Deploy to Vercel
vercel --prod

# Or deploy to any static host
# Upload dist/ folder contents

Environment Setup

• Development: No environment variables needed
• Production: Configure API endpoints and analytics

📈 Performance

Optimization Features

• Image optimization with WebP fallbacks
• Lazy loading for components
• Code splitting with React
• CSS optimization with Tailwind
• Bundle analysis available

Lighthouse Scores

• Performance: 90+
• Accessibility: 95+
• Best Practices: 90+
• SEO: 90+

🔒 Security & Compliance

GDPR Compliance

• ✅ Cookie consent management
• ✅ Privacy policy implementation
• ✅ Data protection measures
• ✅ User rights documentation

Security Features

• ✅ Input validation and sanitization
• ✅ XSS protection measures
• ✅ CSRF protection ready
• ✅ Secure API endpoints

🤝 Contributing

Development Workflow

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open Pull Request

Code Standards

• ESLint for code quality
• Prettier for formatting
• React best practices
• Component documentation

Testing

• Manual testing across devices
• Browser compatibility testing
• Accessibility validation
• Performance monitoring

📚 Documentation

Available Documentation

• README.md - This comprehensive guide
• API.md - API endpoint documentation
• DEPLOYMENT.md - Deployment instructions
• CONTRIBUTING.md - Development guidelines
• COMPONENTS.md - Component reference

🔄 Version History

Latest Updates

• v2.0.0 - Enterprise ERP Suite with analytics and legal compliance
• v1.5.0 - Portfolio galleries and advanced UI components
• v1.0.0 - MVP with core business features

📞 Support & Contact

Development Team

• Email: [email protected]
• Phone: +234 806 450 8595
• Business Hours: Mon–Fri, 9:00 AM – 6:00 PM

Technical Support

For technical issues or questions:

• GitHub Issues: Report bugs and request features
• Documentation: Check this README and related docs
• Email Support: Development team contact

📄 License

This project is proprietary software developed for CEO Transnational Resources Limited (CEOTR Ltd).

---

Built with ❤️ for CEOTR Ltd | Enterprise-grade business application