Skip to content

felix9611/nest-fixedasset-mongo-angular

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Fixed Asset Management System

Nest.js & Angular SSR | Cloud-based Web Application for Asset Management

Current version: V1.5 Branch

Next version function: Unit test and Excel Data Export

If you find this project helpful, please click ⭐ Star! This helps more people discover it.

🌟 Project Overview

This is a full-stack Fixed Asset Management System built with Nest.js and Angular SSR, designed for managing fixed assets within facilities. The system includes:

  • Purchase and maintenance record management
  • Asset write-off tracking
  • Status monitoring and reporting

The system is cloud-based, significantly reducing IT infrastructure costs and improving usability, with no installation required.

🔗 Online Demo Front from Cloudflare DNS Tunnel and my Raspberry Pi5 server

Username: Demo
Password: 888888

Note: Backend and Frontend both hosted on self-hosted Raspberry Pi5 with Cloudflare

📸 Example Screenshots

Tax Information

Dashboard Overview

Asset Form View

Asset List View

User Info

Maintenance Records

Dashboard

Write-Off Management

🚀 Key Features

  • Comprehensive Asset Management: Manage asset status, purchase records, maintenance schedules, and write-offs.
  • Secure Authentication & Authorization: Utilizes JWT tokens for enhanced security and data protection.
  • Cloud-Based Architecture: Easy deployment and access without installation, lowering operational costs.
  • Real-Time Data Visualization: Integrated Chart.js for graphical representation of asset data.

⚙️ Tech Stack

Frontend:

  • Angular 19.2
  • Node.js 20
  • Typescript
  • Tailwind CSS
  • Canvas.js 3.12.5

Backend:

  • Nest.js 11.0
  • Mongoose 8.12.1 for database interaction
  • MongoDB v8.0
  • Nest.js OpenAPI UI 11.0 for API documentation

🛠️ Core Functionalities

  • Asset Registration & Tracking: Record and track fixed assets with detailed status and information.
  • Expenditure & Maintenance Management: Log asset purchase, maintenance, and write-off records for better financial control.
  • Dynamic Reporting: Showing chart graphs for easy analysis and sharing.
  • Role Permission: Unit by per role with menu page permission, customization user group(s) to actionable functions
  • Excel Data Import: Batch upload data increases efficiency

📋 How to Run the Project

Backend

// Go to the backend's file directory
cd backend

// Install dependencies using maven npm install // or yarn

// Run the backend npm run start // or yarn start

Build the backend npm run build // or yarn build

// API Documentation URL http://localhost:7350/api

Frontend

// Go to the frontend's file directory
cd frontend

// Install dependencies (npm) npm install // or yarn

// Run the frontend npm run start // or yarn start

// Build the frontend npm run build:uat or build:prod // or yarn build:uat or build:prod

// Preview URL http://localhost:4200

🌐 Deployment

  • Database:New experiment! Self-hosted in My Raspberry Pi5 server
  • Backend:New experiment! Fullset self-hosted server power by my Raspberry Pi5 server
  • Frontend:Cloudflare Tunnel DNS + Raspberry Pi5 runing in Angualr SSR

📈 Business Impact

  • Reduced Operational Costs by eliminating the need for desktop installations.
  • Improved Data Security through JWT-based user authentication.
  • Enhanced Decision-Making with real-time data visualization and comprehensive reporting.

Releases

No releases published

Packages

No packages published

Languages