Kindergarten Kitchen Inventory System

A Django-based inventory and meal reporting system for kindergarten kitchens.

Features

• Inventory Management: Track ingredients with quantities and warning thresholds
• Meal Recipes: Create and manage meal recipes with ingredient requirements
• Meal Serving: Record meals served with automatic inventory deduction
• Portion Calculation: Automatically calculate possible portions based on current inventory
• Reports: Monthly meal serving reports with comparisons and visualizations
• Role-Based Access: Different access levels for Administrators, Managers, and Cooks

Technical Details

• Built with Django 4.2+
• Uses Django ORM for database models
• Django Template Language for frontend
• Bootstrap 5 for responsive design
• Chart.js for data visualization
• SQLite database (configurable for production)

Project Structure

.
├── config/             # Django project configuration
├── home/               # Main app with all functionality
│   ├── models.py       # Data models
│   ├── views.py        # View functions
│   ├── forms.py        # Form classes
│   ├── utils.py        # Utility functions and decorators
│   ├── admin.py        # Admin interface configuration
│   └── migrations/     # Database migrations
├── static/             # Static files (CSS, JS)
│   ├── css/            # CSS files
│   └── js/             # JavaScript files
├── templates/          # HTML templates
│   ├── base.html       # Base template
│   └── home/           # App templates
│       ├── auth/       # Authentication templates
│       ├── ingredients/ # Ingredient management templates
│       ├── meals/      # Meal management templates
│       └── reports/    # Report templates
├── manage.py           # Django management script
└── README.md           # This file

User Roles

• Admin: Full access to all features
• Manager: Can manage inventory, create meals, and view reports
• Cook: Can only serve meals and view inventory

Getting Started

1. Clone the repository
2. Install dependencies with pip install -r requirements.txt
3. Run migrations with python manage.py migrate
4. Create a superuser with python manage.py createsuperuser
5. Start the development server with python manage.py runserver

Usage

1. Log in with your account
2. Add ingredients to your inventory
3. Create meal recipes with ingredient requirements
4. Serve meals to record consumption and automatically update inventory
5. View reports to track meal serving patterns