Skip to content

Latest commit

 

History

27 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AssetFlow - Enterprise Asset & Resource Management System

Overview

AssetFlow is a centralized, digital ERP platform designed to simplify how organizations track, allocate, and maintain their physical assets and shared resources. It eliminates manual tracking inefficiencies by providing a structured asset lifecycle, centralized resource booking, and real-time visibility into asset ownership, location, and condition.

The platform is built with a robust layered architecture, emphasizing clean separation of concerns, secure role-based workflows, and intuitive UI/UX.

Features & Capabilities

Organization & Directory Management

  • Department Hierarchy: Create and manage departments, assign Department Heads, and structure organizational hierarchy.
  • Asset Categories: Define custom categories (e.g., Electronics, Furniture, Vehicles) for organized asset tracking.
  • Employee Directory: Maintain user accounts with Role-Based Access Control (RBAC). Roles include Admin, Asset Manager, Department Head, and Employee.

Asset Lifecycle & Tracking

  • Asset Registration: Centralized registry for all physical assets, automatically generating unique Asset Tags. Tracks serial numbers, acquisition details, location, and condition.
  • Dynamic States: Assets transition through flexible lifecycle states: Available, Allocated, Reserved, Under Maintenance, Lost, Retired, Disposed.
  • Search & Filtering: Quickly locate assets via tags, categories, statuses, departments, or locations.

Allocations & Transfers

  • Conflict-Free Allocation: Allocate assets to employees or departments while preventing double-allocation of a single asset.
  • Transfer Workflows: Request, approve, and re-allocate assets seamlessly when they need to change hands.
  • Return Tracking: Monitor expected return dates, capture check-in condition notes, and auto-flag overdue allocations.

Shared Resource Booking

  • Time-Slot Management: Book shared resources (e.g., conference rooms, specialized equipment, vehicles) using a calendar interface.
  • Overlap Prevention: Built-in validation ensures no two people can book the same resource at overlapping times.

Maintenance & Repairs

  • Approval Workflows: Route repair requests through structured approval pipelines before maintenance work begins.
  • Automated Status Updates: Asset statuses automatically flip to Under Maintenance upon approval and return to Available when resolved.

Audit & Verification

  • Structured Audit Cycles: Run scheduled verification cycles across specific departments or locations.
  • Discrepancy Reporting: Auditors verify assets or flag them as Missing/Damaged, with the system auto-generating detailed discrepancy reports upon cycle completion.

Analytics & Notifications

  • Real-Time Dashboard: Role-specific KPI cards showing active allocations, pending maintenance, overdue returns, and upcoming bookings.
  • Reports: Gain actionable insights into asset utilization trends, maintenance frequencies, and department-wise allocations.
  • Activity Logs: Comprehensive audit trails of all system actions, coupled with proactive notifications for overdue items and approval requests.

Technology Stack

Backend

  • Framework: FastAPI (Python)
  • Database: PostgreSQL with asyncpg
  • ORM: SQLAlchemy 2.0 (Async)
  • Migrations: Alembic
  • Authentication: JWT (JSON Web Tokens) with Passlib & Bcrypt
  • Architecture: Strict MVC-style Layered Architecture (Router ➔ Controller ➔ Service ➔ Repository ➔ Database)

Frontend

  • Framework: React (v19) + TypeScript
  • Build Tool: Vite
  • Styling: Tailwind CSS
  • Routing: React Router
  • Data Visualization: Recharts
  • Icons: Lucide React

About

Enterprise asset management system with asset tracking, role-based workflows, maintenance, resource scheduling, and analytics.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages