AMS Python — Asset Management System

A Python Django-based IT Asset Management System built for NMDC. Migrated and improved from an existing PHP Laravel system.

Tech Stack

• Backend: Python Django 6.0
• Database: SQLite (development)
• Frontend: Bootstrap 5 + Bootstrap Icons
• Charts: Chart.js

Features

• Asset management (CRUD, checkout, checkin, audit)
• Consumables tracking with consumption rate indicator
• License management
• Maintenance logs
• Depreciation schedules with straight-line calculation
• User roles and permissions (Admin, Staff, Viewer)
• CSV/Excel import with column mapping
• Reports (Excel + PDF export)
• Vendor support contact directory
• Hierarchical locations and categories
• Low stock dashboard alerts

Setup Instructions

1. Clone the repository

git clone https://github.com/YOUR_USERNAME/ams-python.git
cd ams-python

2. Create virtual environment

python -m venv venv
venv\Scripts\activate   # Windows

3. Install dependencies

pip install -r requirements.txt

4. Run migrations

python manage.py migrate

5. Create admin user

python create_admin.py

6. Start the server

python manage.py runserver 8090

Open: http://localhost:8090
Login: admin / admin123

Project Structure

ams_django/
├── apps/
│   ├── assets/          # Core asset management
│   ├── consumables/     # Consumables with stock tracking
│   ├── dashboard/       # Dashboard with charts
│   ├── users/           # User management with roles
│   ├── importer/        # CSV/Excel import
│   └── reports/         # Excel/PDF reports
├── templates/           # HTML templates
├── core/                # Django settings and URLs
└── manage.py