⚙️ Environment Variables (.env)

Create a .env file in the root of the project and populate it with the following keys:

# Django Settings
SECRET_KEY=
DEBUG=
ALLOWED_HOSTS=

# Email Settings
EMAIL_HOST=
EMAIL_PORT=
EMAIL_USE_SSL=         # Typically True if using port 465
EMAIL_USE_TLS=
EMAIL_HOST_USER=
EMAIL_HOST_PASSWORD=
DEFAULT_FROM_EMAIL=
DEFAULT_FROM_NAME=

# CSRF Settings
CSRF_TRUSTED_ORIGINS=

# Security Settings
SECURE_SSL_REDIRECT=0
SESSION_COOKIE_SECURE=0
CSRF_COOKIE_SECURE=0

# Static Files
STATIC_URL=static/
STATIC_ROOT=staticfiles/
USE_WHITENOISE=False

# Admin URL
ADMIN_URL=admin/

# Optional DB Configs (if using a different DB engine)
# DB_ENGINE=
# DB_NAME=
# DB_USER=
# DB_PASSWORD=
# DB_HOST=
# DB_PORT=

📦 Local Development Setup

Follow these steps to set up and run the project locally:

1. Clone the Repository

git clone https://github.com/salmanshovon/moment-django.git
cd moment-django

2. Set Up the Virtual Environment Using Pipenv

pipenv install
pipenv shell

3. Configure Environment Variables

Create a .env file in the root directory and populate it using the template provided in the Environment Variables section above.

4. Apply Database Migrations

python manage.py migrate

5. Run the Development Server

python manage.py runserver

🧩 Notable Decisions & Architecture Choices

• No Celery/Redis: Due to the WSGI-only support on the production server, asynchronous task scheduling (like routine checks and updates) is handled via cron jobs instead of Celery with Redis.
• WSGI Deployment: The application is deployed using WSGI, ensuring compatibility with the current shared hosting infrastructure.
• Progressive Web App (PWA): Fully implemented with installable experience on supported mobile browsers.
• Environment-based Security Configs: SSL redirect settings, secure cookies, and CSRF protection are all configured via environment variables to support both development and production needs seamlessly.

📈 Future Enhancements

• ✅ Switch to ASGI deployment to support Celery and Redis for real-time processing
• 📊 Add more detailed analytics and personalized insights
• 📆 Implement calendar view for enhanced task scheduling and overview

🧑‍💻 Author

Salman Mahmood

• 🔗 GitHub Profile
• 🌐 Live Site: moment.aranyait.com.bd

📝 License

This project is licensed under the MIT License. See the LICENSE file for full details.

🙌 Contributions

This project is developed and maintained solo, but contributions, suggestions, and feedback are welcome!

• 🛠 Fork the repository
• 🐞 Submit issues for bugs or feature requests
• 📬 Open a pull request with improvements