git clone https://github.com/[your-username]/mealSync.git
cd mealSync

python -m venv venv
source venv/bin/activate  # برای لینوکس/مک
# یا
venv\Scripts\activate  # برای ویندوز

pip install -r requirements.txt

python manage.py migrate

python manage.py createsuperuser

python manage.py runserver

mealSync/
├── accounts/          # مدیریت کاربران و احراز هویت
├── core/             # هسته اصلی سیستم
├── notifications/    # سیستم اطلاع‌رسانی
├── reports/          # سیستم گزارش‌گیری
├── tickets/          # سیستم تیکتینگ
├── templates/        # قالب‌های HTML
└── static/           # فایل‌های استاتیک

MealSync is a comprehensive enterprise meal management system designed for large organizations with 3000+ employees. It provides seamless food ordering, kitchen management, and reporting capabilities.

• Account Types:

  • System Admin: Full access to all features and settings
  • Company Manager: Menu, employee, and report management
  • Kitchen Operator: Order viewing and approval
  • Employee: Menu viewing and order placement

• Authorization Levels:

  • System Admin: Complete settings, company management, comprehensive reporting
  • Company Manager: Employee management, food menu, company reports
  • Kitchen Operator: Food approval, order management
  • Employee: Food reservation, history viewing, ticket submission

• Method 1: Phone + OTP Authentication
  • SMS verification code delivery
  • Phone number validation before OTP sending
• Method 2: Employee ID + Password Authentication
  • Password change capability
  • Password security policies

• Persian date display and input
• Automatic official holiday and weekend detection
• Business day and order deadline calculations
• Custom holiday settings per company

• Ticket Workflow:
  1. Ticket creation by employee
  2. Automatic department routing
  3. Response and follow-up
  4. Ticket closure and feedback
• Features:
  • Topic categorization
  • File attachment support
  • Complete conversation history
  • SMS notifications

• Financial Reports:
  • Per-employee food costs
  • Monthly company reports
  • Periodic financial summaries
• Operational Reports:
  • Daily order statistics
  • Food popularity metrics
  • Ticket and satisfaction analytics
• Excel Exports:
  • Persian formatting
  • Advanced filtering
  • Sorting and grouping capabilities

• General Settings:
  • Working days management
  • Order time configuration
  • Notification settings
• Company Settings:
  • Custom ordering rules
  • Time restrictions
  • Access management
• Security Settings:
  • Password policies
  • IP restrictions
  • Security reports

• Dual Approval Process:
  1. Initial kitchen approval
  2. Final manager approval
• Meal Statuses:
  • Pending approval
  • Kitchen approved
  • Finally approved
  • Rejected
• Change Management:
  • Rejection reason logging
  • Correction and re-approval capability

• Manual holiday definition with reasons
• Automatic order cancellation for closed days
• Employee notifications
• Holiday impact reporting

1. Clone the repository:

git clone https://github.com/[your-username]/mealSync.git
cd mealSync

2. Create virtual environment:

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

3. Install dependencies:

pip install -r requirements.txt

4. Environment setup:

• Create .env file based on .env.example
• Configure database and required API settings

5. Run migrations:

python manage.py migrate

6. Create admin user:

python manage.py createsuperuser

7. Run development server:

python manage.py runserver

mealSync/
├── accounts/          # User management and authentication
├── core/             # Core system functionality
├── notifications/    # Notification system
├── reports/          # Reporting system
├── tickets/          # Ticketing system
├── templates/        # HTML templates
└── static/           # Static files

• Backend: Django 4.2+
• Frontend: Bootstrap/Tailwind CSS
• Database: SQLite (development) / PostgreSQL (production)
• Additional Tools:
  • jdatetime: Persian date handling
  • openpyxl: Excel report generation
  • django-crispy-forms: Form rendering

This project is under active development and we welcome contributions! To contribute:

1. Fork the project
2. Create your feature branch
3. Commit your changes
4. Create a Pull Request

• Email: [email protected]
• GitHub: My Professional Profile

• Python 3.9+
• Django 4.2+
• Additional requirements listed in requirements.txt

This project is open source and available under the MIT License.