chetan2710/Local_Medicine

Local Medicine Backend API

Django REST API for the Local Medicine mobile application - helping users find medicines and nearby pharmacies.

Features

• —🔐 Authentication: JWT-based user authentication
• —💊 Medicine Management: Search and manage medicine inventory
• —🏪 Store Locations: Find nearby pharmacies and medicine stores
• —📦 Inventory Tracking: Real-time inventory management
• —📝 Request Handling: Customer and shop request management

API Endpoints

Authentication

• —POST /api/v1/auth/register - Register new user
• —POST /api/v1/auth/login - User login
• —POST /api/v1/auth/refresh - Refresh JWT token
• —GET /api/v1/auth/me - Get current user info

Medicines

• —GET /api/v1/medicines/ - List all medicines
• —GET /api/v1/medicines/search?q=query - Search medicines
• —GET /api/v1/medicines/{id}/ - Get medicine details
• —POST /api/v1/medicines/ - Create medicine (admin)
• —PUT /api/v1/medicines/{id}/ - Update medicine (admin)
• —DELETE /api/v1/medicines/{id}/ - Delete medicine (admin)

Stores

• —GET /api/v1/stores/ - List all stores
• —GET /api/v1/stores/nearby?lat={lat}&lng={lng} - Find nearby stores
• —GET /api/v1/stores/{id}/ - Get store details
• —POST /api/v1/stores/ - Create store (shop owner)

Inventory

• —GET /api/v1/inventory/ - List inventory items
• —POST /api/v1/inventory/ - Add inventory item
• —PUT /api/v1/inventory/{id}/ - Update inventory
• —DELETE /api/v1/inventory/{id}/ - Remove inventory

Requests

• —GET /api/v1/requests/ - List requests
• —POST /api/v1/requests/ - Create request
• —PUT /api/v1/requests/{id}/ - Update request status

Technology Stack

• —Framework: Django 4.2
• —API: Django REST Framework
• —Authentication: JWT (Simple JWT)
• —Database: SQLite (development), PostgreSQL recommended for production
• —Server: Gunicorn
• —Static Files: Whitenoise

Environment Variables

See .env.example for required configuration variables.

Local Development

# Install dependencies
pip install -r requirements.txt

# Run migrations
python manage.py migrate

# Create superuser (admin)
python manage.py createsuperuser

# Run development server
python manage.py runserver

Production Deployment

This project is configured for deployment on Hugging Face Spaces using Docker.

Environment Variables to Set in Hugging Face:

1. 1.SECRET_KEY - Django secret key (generate a secure one)
2. 2.ALLOWED_HOSTS - Your domain (e.g., .hf.space)
3. 3.CORS_ALLOWED_ORIGINS - Your Flutter app URLs
4. 4.DEBUG - Set to False in production

License

MIT License - See LICENSE file for details

Support

For issues and feature requests, please open an issue on GitHub.