Professional platform for an Egyptian agricultural export company built with Django and Tailwind CSS.

• Dynamic product catalog with fresh/IQF handling
• Monthly seasonality charts per product/variety
• Modular, component-based frontend
• Admin dashboard for full content control
• Responsive design for all device sizes
• SEO-optimized
• Advanced user management system

• Python 3.12+
• Django 4.2.7
• PostgreSQL
• Tailwind CSS
• Vanilla JavaScript
• HTML5 & Django Templates

1. Clone the repository

git clone https://github.com/MWHEBA/Egyland.git
cd Egyland

2. Create and activate virtual environment

python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

3. Install dependencies

pip install -r requirements.txt

4. Setup database

• Create a PostgreSQL database
• Configure database connection in config/.env

5. Run migrations and create superuser

python manage.py migrate
python manage.py createsuperuser

6. Run the development server

python manage.py runserver

7. Access the website at http://127.0.0.1:8000/

• apps/: Module applications
  • core/: Main site pages and functionality
  • products/: Product catalog and detail pages
  • dashboard/: Custom admin dashboard
  • accounts/: User accounts management
  • user_management/: Advanced user management system
  • inquiries/: Contact and inquiry handling
  • branches/: Company branches
• config/: Project configuration
• templates/: HTML templates
• static/: Static assets (CSS, JS, images)
• media/: User-uploaded content
• logs/: Application logs
• scripts/: Utility scripts

The site is fully managed through the admin interface at /admin. Key content sections:

1. Products

   • Add/edit products and their details
   • Manage seasonality, counts, sizes, packaging

2. Inquiries

   • View and manage contact messages
   • Handle quote requests

The project includes a comprehensive image processor script (scripts/image_processor.py) that:

• Automatically compresses images while maintaining quality
• Converts images to WebP format for better performance
• Updates HTML templates with <picture> elements for WebP support
• Can be integrated with Django signals for automatic processing

# Process all images in static/img
python scripts/image_processor.py

# Process only a specific image or directory
python scripts/image_processor.py --path static/img/products/apple.jpg

For more details, see the Image Processing Documentation.

The system supports an enhanced packaging management approach:

1. Packaging Types

   • Reusable packaging types with images (e.g., "Wooden boxes - 30pcs")
   • Each type has a key word (e.g., "boxes") for dynamic labeling
   • Types can be marked for Fresh products, IQF products, or both

2. Product Packaging Types

   • Associates products with packaging types
   • Configurable specifications:
     • Items per pallet (using the key word)
     • Pallets per container
     • Net weight and units
   • Display options (e.g., show "Fresh" label)

The platform includes a comprehensive user management system that offers:

1. Role-Based Access Control

   • Create custom roles with specific permissions
   • Assign roles to users
   • Control access to different parts of the system

2. User Activity Tracking

   • Monitor login/logout events
   • Track password changes and profile updates
   • Record all user actions with timestamps and IP addresses

3. Security Features

   • Account status management (active, inactive, suspended, locked)
   • Login attempt tracking to detect suspicious activity
   • Security questions for account recovery
   • Session tracking and management

4. Administrative Tools

   • User statistics and analytics
   • Comprehensive user reports
   • Bulk user operations
   • User verification management

Access the user management dashboard at /user-management/dashboard/ with admin credentials. From there you can:

1. View user statistics and recent activities
2. Add, edit, and manage users
3. Create and assign roles
4. Generate user activity reports
5. Manage account statuses

This module integrates with the existing accounts app and enhances it with advanced management capabilities.

• Use modular templates with base.html and blocks
• Use includes for reusable components
• Keep HTML separate from CSS/SCSS
• Follow snake_case in Python, camelCase in JS
• Validate all user input
• Update README.md with structural changes

Egyland now uses a locally compiled version of Tailwind CSS instead of the CDN. This is the recommended approach for production environments.

1. Make sure Node.js and npm are installed on your system
2. Install the required packages:

   npm install

3. Build the CSS file:

   npm run build:css

4. For development with auto-refresh:

   npm run dev

The compiled CSS file will be at static/css/tailwind.min.css and is already configured in the templates.

We welcome contributions! Please follow these steps:

1. Open an issue to discuss the proposed change
2. Fork the repository
3. Create a new branch for your feature (git checkout -b feature/amazing-feature)
4. Commit your changes (git commit -m 'Add amazing feature')
5. Push to the branch (git push origin feature/amazing-feature)
6. Open a Pull Request

This project is licensed under the MIT License.

For more information, please contact:

• User: MWHEBA
• Email: [email protected]

Developed by MWHEBA.