Emergency Prep Inventory

✨ Features

Inventory Management

• Full CRUD operations — add, edit, and delete inventory items with categories, subcategories, quantities, units, daily consumption rates, and expiry dates
• Auto-calculated days remaining — the system computes how many days each item will last based on current stock and daily consumption per household member
• Status indicators — items are automatically flagged as Critical (below minimum stock), Warning (below target), or Adequate
• Category filtering — click any category pill to instantly filter the table; pills are color-coded by aggregate status
• Sortable table — click any column header to sort ascending/descending
• Search — real-time search across item names, categories, and subcategories
• Export backup — one-click JSON export of your entire inventory for offline safekeeping

Admin Authentication

• Single-admin model — one admin account created during first-time setup; no multi-user accounts needed
• BCrypt password hashing (cost factor 12) — passwords are never stored in plain text
• PHP session-based auth — sessions stored in a protected sessions/ directory, not the system temp folder
• Viewer mode — unauthenticated visitors browse in read-only mode
• Password change — admin can change password from Settings at any time
• .htaccess protection — direct URL access to JSON data files and sessions is blocked

Survival Recipes

• 16 survival-optimized recipes — designed specifically for the ingredients tracked in inventory
• Priority levels — Use First (perishable), Use Soon, or Any Time
• Fuel cost indicators — Zero (no cooking), Low (<10 min), or Medium (10-20 min)
• Emergency-only recipes — clearly marked for critical situations
• Comfort/normalcy recipes — meals that boost morale during extended emergencies
• Child versions — adapted instructions for young children (ages 5+)
• Survival tips — water-saving techniques, ingredient substitution strategies, and cooking shortcuts
• Print-ready — optimized print stylesheet for physical copies or "Save as PDF"

📁 File Structure

Requirements

• Web server — Apache (with .htaccess support) or Nginx
• PHP 8.x — with json and posix extensions (posix is optional but provides better diagnostics)
• Write permissions — the web server user (typically www-data) must be able to write to data/ and sessions/
• No database — all data is stored in JSON files
• No npm/build step — pure HTML, CSS, and JavaScript; no compilation or bundling required

🛠 Installation

Choose the installation method that matches your operating system and setup.

sudo cp -r ./emergency-prep-inventory /var/www/html/tools/emergency-prep-inventory

sudo bash setup-permissions.sh /var/www/html/tools/emergency-prep-inventory

mkdir -p /var/www/html/tools/emergency-prep-inventory/data
mkdir -p /var/www/html/tools/emergency-prep-inventory/sessions
sudo chown -R www-data:www-data /var/www/html/tools/emergency-prep-inventory
find /var/www/html/tools/emergency-prep-inventory -type d -exec chmod 755 {} \;
chmod 750 /var/www/html/tools/emergency-prep-inventory/data
chmod 700 /var/www/html/tools/emergency-prep-inventory/sessions
chmod 640 /var/www/html/tools/emergency-prep-inventory/*.php
chmod 644 /var/www/html/tools/emergency-prep-inventory/*.html
chmod 644 /var/www/html/tools/emergency-prep-inventory/*.css
chmod 660 /var/www/html/tools/emergency-prep-inventory/data/*.json

location /data/ {
    deny all;
}
location /sessions/ {
    deny all;
}

cp -r ./emergency-prep-inventory /Applications/XAMPP/xamppfiles/htdocs/emergency-prep-inventory

mkdir -p /Applications/XAMPP/xamppfiles/htdocs/emergency-prep-inventory/data
mkdir -p /Applications/XAMPP/xamppfiles/htdocs/emergency-prep-inventory/sessions
sudo chown -R daemon:daemon /Applications/XAMPP/.../data
sudo chown -R daemon:daemon /Applications/XAMPP/.../sessions

cp -r ./emergency-prep-inventory /Applications/MAMP/htdocs/emergency-prep-inventory

mkdir -p /Applications/MAMP/htdocs/emergency-prep-inventory/data
mkdir -p /Applications/MAMP/htdocs/emergency-prep-inventory/sessions
chmod 777 /Applications/MAMP/htdocs/emergency-prep-inventory/data
chmod 777 /Applications/MAMP/htdocs/emergency-prep-inventory/sessions

🔌 API Reference

The backend API (api.php) uses a simple action-based routing pattern. All requests return JSON responses.

Public Endpoints (No Authentication Required)

Protected Endpoints (Admin Authentication Required)

Request / Response Examples

Login:

{ "action": "login", "username": "admin", "password": "your-password" }

Save inventory:

{ "action": "save_inventory", "data": [{ "itemName": "Rice", "category": "Grains", "currentQuantity": 5, "unit": "kg", "dailyConsumption": 0.1 }] }

📖 Usage Guide

First-Time Setup

1. Create your admin account — choose a username (minimum 2 characters) and a password (minimum 6 characters)
2. Configure your household — set the number of adult males, adult females, children, and your target preparation days

After setup, you will be automatically logged in as admin.

Managing Inventory Items

• Add a new item — click the "Add New Item" button (admin only)
• Edit an item — click the pencil icon in the Actions column (admin only)
• Delete an item — click the trash icon in the Actions column (admin only)
• Add new categories/units — each dropdown has a "+" button to create new categories, subcategories, or units on the fly
• Export backup — click "Export Backup" to download your inventory as a JSON file

Viewing as a Guest

Visitors who do not log in can browse the inventory in read-only mode. They can:

• View all inventory items and their statuses
• Filter by category and search
• Switch languages
• Access the recipes page

They cannot add, edit, or delete items.

Survival Recipes

Click the "Recipes" button to open the survival recipes page. Each recipe includes:

• Priority badge — tells you when to use this recipe based on ingredient perishability
• Fuel cost badge — how much cooking fuel is required
• Water cost — estimated water consumption for the recipe
• Ingredients list — with quantities matched to your inventory
• Step-by-step instructions — numbered cooking steps
• Child version — adapted instructions for feeding young children
• Survival tip — practical advice for conserving resources

Use the "Print / Save as PDF" button to create a physical backup of all recipes.

🔧 Troubleshooting

Permission Errors

If you see errors about file write access:

1. Run the permission check endpoint: api.php?action=check_permissions
2. This will show the PHP user, file ownership, and permission details
3. Re-run the setup script: sudo bash setup-permissions.sh /your/project/path
4. If the issue persists, manually check ownership — files should be owned by www-data:www-data with permissions 660 for JSON files

Session Issues

If login does not persist:

• Ensure the sessions/ directory exists and is writable by www-data
• Check that the directory has permissions 700 and is owned by www-data
• Verify that your browser accepts cookies from the domain

API Returns 500 on Setup

This typically means the data/ directory or JSON files are not writable. The API response will include diagnostic information:

• php_user — the user PHP is running as
• file_perms — current file permissions
• file_owner — current file owner
• fix — the exact command to run to resolve the issue

🛡 Security Considerations

• JSON data files are protected from direct HTTP access via .htaccess rules (Apache) or Nginx location blocks
• Admin credentials are stored with BCrypt hashing (cost 12) — passwords are never stored in plain text
• Session files are stored in a dedicated directory with restrictive permissions (700), not in the system-wide /tmp directory
• PHP files have permissions 640 — readable only by the web server user and group, not world-readable
• No CSRF tokens — this application is designed for single-admin household use on a trusted network. If you expose it to the public internet, consider adding CSRF protection
• No rate limiting — brute-force protection is not implemented. Use fail2ban or similar tools if exposed publicly

⚙️ Technology Stack

Browser Support

• Chrome / Edge (latest 2 versions)
• Firefox (latest 2 versions)
• Safari (latest 2 versions)
• Mobile browsers (Chrome for Android, Safari for iOS)

📄 License

This project is provided as-is for personal household emergency preparedness use. Contact marundaliliana@gmail.com for custom deployments or inquiries.