README.md

CMMS

Computerized Maintenance Management System or CMMS is a webapp created for Pertamina Hulu Energi, designed to provide a reliable scheduling, tracking, reporting tools for equipment and facilities maintenance.

Setup

Prerequisites

• Python 3.10 or later
• Poetry
• Redis (for Session Management and Cache)
• NodeJS v18 or later (for tailwind)
• libwebp (libwebp-dev in Debian/Ubuntu, for Pillow)

Deployment

• Run poetry install to install all required dependencies in a virtualenv
• Setup Linux environment properly (use stuff in .boilerplate directory when needed)
• Run poetry run manage tailwind install to prepare tailwind
• Run poetry run manage tailwind build to build tailwind CSS
• Run poetry run manage collectstatic to serve django static files (you may need to setup proper perms first)
• Run poetry run manage migrate to make sure DB structure is up to date
• Finally run poetry run gunicorn cmms.asgi:application -k uvicorn.workers.UvicornWorker to start the server

Development

• Run poetry install to install all required dependencies in a virtualenv
• Run poetry run manage tailwind install to prepare tailwind
• Run poetry run tailwind to start tailwind in debug mode
• Finally run poetry run start to start the server

Environment Variables

Name	Description	Example
DATABASE_URL	URL to your database. Check out dj-database-url for more information	postgres://user:p#ssword!@localhost/foobar
REDIS_URL	URL to your redis. Check out django-redis for more information	redis://127.0.0.1:6379/1
DJANGO_DEBUG	Toggle django's debug mode, for production it's highly recommended to disable it	true or yes