OTLedger

 

OTLedger

  The definitive, real-time platform for Operational Technology (OT) asset inventory management.  
  Report Bug   ·   Request Feature

     

---

📖 About The Project

OTLedger is a modern web application designed to replace scattered spreadsheets for managing industrial equipment. Tracking assets with numerous Excel files is often slow and can lead to errors. This project solves that problem by providing one central, visual, and organized system to keep a track of all your important equipment, turning messy data into a useful tool.

Why OTLedger?

• Clear Inventory: Know exactly what equipment you have, what it does, and where it is at all times.
• Easy Change Tracking: Maintain a complete and reliable history of every change made to your equipment, making it simple to see what happened and when.
• Improved Efficiency: Speed up common tasks, like planning for changes or reviewing equipment lists, with data that is accurate and easy to find.

✨ Key Features (v1.0.0)

Version 1.0.0 is focused on providing a robust foundation for managing various types of network switches used in industrial environments.

• 🗃️ Centralized Inventory: A single, unified database for all your critical equipment, ranging from controllers and sensors to network switches and servers.
• 🗺️ Visual Asset Mapping: Easily place asset icons directly onto a map or floor plan of your facility. This provides a clear, visual representation of their exact physical locations.
• 🛡️ Secure & Auditable: Implements Role-Based Access Control (RBAC) to govern who can view, edit, or manage sensitive equipment information, ensuring security and accountability.

🚀 Upcoming Planned Features

We’re constantly working to expand the utility of OTLedger tool. Here’s a look at what’s coming soon:

• Expanded Asset Types: Support for adding detailed information and associated metadata for new asset types:
  • Virtual Machines (VMs)
  • PLCs (Programmable Logic Controllers)
  • Workstations
• Real-Time Asset Documentation: A dedicated placeholder for users to update notes and upload pictures associated with assets to reflect their current, real-time condition.
• Efficient Data Management: Implementation of bulk import and export functionality using standard CSV files for quick and easy data migration and updates.

(More features planned for future releases!)

---

📸 Application Screenshots

1. Dashboard

2. Site Information

3. Asset Information

4. Asset Risk Review

5. MOC

6. User Management

---

🚀 Getting Started

To get a local copy of the project up and running, follow these simple steps.

Prerequisites

You only need a modern web browser like Google Chrome, Firefox, or Safari.

How to Run Application Locally

1. Download the application .zip from the release page: https://github.com/mahil-dudhat/OTLedger/releases/tag/v1.0.0
2. Unzip the application folder and run the OTLedger.exe application.
3. Open your web browser and navigate to http://localhost:5000 to register a new user and log in.

💻 Built With

OTLedgerV1 - Technology Stack Review

This document outlines the technologies, frameworks, and libraries used in the OTLedgerV1 project, based on a review of the source code.

1. Backend Framework & Runtime

• .NET 8.0: The project’s target framework.
• ASP.NET Core 8.0.4: The web framework used to build the application.

2. UI Framework

• Blazor (Blazor Web App): The project is built as a Blazor Web App, a new model in .NET 8. It uses interactive server-side rendering (SSR).

3. Database & Data Access

• Entity Framework Core 8.0.4: The Object-Relational Mapper (ORM) used for data access.
• SQLite: The database provider being used. The actual database file ledger.db is included in the project.

4. Authentication & Authorization

• ASP.NET Core Identity 8.0.4: The framework used for managing users, passwords, roles, and login functionality.

5. Frontend Libraries & Styling

• Bootstrap 5.3.2: A popular CSS framework used for styling the user interface.
• Custom JavaScript: The project includes custom JavaScript for specific UI interactions, such as placing asset icons on site layout diagrams.

Contribution Policy

This project is open for use, evaluation, and feedback. We welcome issues and feature requests. External code contributions (pull requests) are not accepted. Please see CONTRIBUTING.md for details.

Licensing Notice

This project is currently licensed under AGPL-3.0. A commercial license will be offered in the future for organizations that require different licensing terms.

---

📧 Contact

Linkedin - Mahil Dudhat

Project Link: https://github.com/mahil-dudhat/OTLedger

This site is open source. Improve this page.