Skip to content
erinelopez22Public

About

No description or website provided.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

AWS-AGMS – Asset Gatekeeper Management System

Enterprise-grade IT asset lifecycle management with approval workflows, role-based access, and compliance tracking.

🔗 Live Demo: https://agms-fcd2b.web.app/


📋 Overview

AWS-AGMS is a comprehensive asset management platform designed for IT operations teams to track hardware assets, manage transfer workflows, handle telework/UAF approvals, and maintain Laptop Passport compliance. Built with enterprise security and workflow automation in mind, it provides real-time dashboards and audit trails for complete asset visibility.

Key Benefit: Centralized asset control that streamlines approvals, reduces manual tracking, and ensures compliance across the organization.


✨ Features

Asset Management

  • Asset Registry — Complete inventory of IT hardware with detailed metadata
  • Asset Tracking — Real-time status and location tracking for all assets
  • Asset Lifecycle — Track asset history from acquisition to disposal
  • Search & Filter — Quickly locate assets by name, type, serial number, or location

Transfer & Assignment Workflows

  • Transfer Requests — Submit asset transfer requests with approval workflows
  • Multi-Stage Approvals — Manager → Finance → Compliance → Completion
  • Status Tracking — Real-time status updates and notification pipeline
  • Audit Trail — Complete history of all transfers and approvals

UAF & Telework Management

  • UAF Processing — Unified Approval Form (UAF) workflows with automatic routing
  • Telework Approvals — Telework request processing with equipment allocation
  • Supervisor Sign-Off — Role-based approval gates
  • Compliance Tracking — Automatic compliance verification

Laptop Passport System

  • Hardware Gating — Restrict laptop access based on compliance status
  • Compliance Rules — Configurable access policies
  • Automatic Enforcement — Prevent non-compliant devices from accessing resources
  • Passport Status Dashboard — Real-time compliance visibility

Role-Based Access Control

  • Admin — Full system access, user management, configuration
  • Manager — Approve/reject transfers, team management
  • Finance — Financial approval of asset movements
  • Approver — Workflow approval authority
  • User — Submit requests, view personal assets

Reporting & Analytics

  • Asset Reports — Comprehensive asset inventory reports
  • Transfer Analytics — Approval metrics and bottleneck analysis
  • Compliance Reports — Laptop Passport compliance status
  • Audit Reports — Complete audit trail exports

🛠️ Tech Stack

Layer Technology
Frontend React 18+, TypeScript, Tailwind CSS
Backend .NET Core, C#, ASP.NET Web API
Database Supabase (PostgreSQL)
Authentication JWT, Role-Based Access Control
Deployment Google Cloud / Firebase
State Management React Context API / Redux
Real-time Updates WebSockets / Supabase Subscriptions

🚀 Key Workflows

Asset Transfer Request

1. User submits transfer request with asset details
2. Manager reviews and approves/rejects
3. Finance verifies asset value and approves
4. Compliance confirms no restrictions
5. Asset is updated in system
6. All parties notified
7. Complete audit trail recorded

UAF Processing

1. Employee submits UAF with asset requirements
2. Supervisor reviews and approves
3. HR processes form
4. Assets allocated and assigned
5. Equipment shipped/transferred
6. Confirmation recorded

Laptop Passport Compliance

1. System checks device compliance status
2. If non-compliant → Block access
3. User receives notification
4. Admin sees compliance dashboard
5. Required actions displayed
6. Once compliant → Access restored

🔐 Security & Authorization

  • JWT Authentication — Secure token-based login
  • Role-Based Access Control (RBAC) — Fine-grained permissions per role
  • Audit Logging — Every action logged with timestamp and user
  • Encrypted Data — Sensitive asset data encrypted at rest
  • Session Management — Automatic timeout and re-authentication
  • API Security — CORS, rate limiting, input validation

Security Features:

  • Password hashing with bcrypt
  • HTTPS enforced in production
  • Two-factor authentication ready (optional)
  • IP whitelisting support
  • Activity logging and alerts

📊 Database Schema

Core Tables

Assets

  • Asset ID, Serial Number, Type, Make, Model
  • Location, Status, Owner
  • Purchase Date, Value, Warranty End
  • Created/Updated timestamps

Transfers

  • Transfer ID, Asset ID, From User, To User
  • Request Date, Approval Date
  • Manager Approval, Finance Approval
  • Status (Pending, Approved, Rejected, Completed)

Approvals

  • Approval ID, Type (Transfer/UAF/Other)
  • Approver, Decision, Notes
  • Decision Date, Reason (if rejected)

Users

  • User ID, Email, Name, Department
  • Role (Admin, Manager, Finance, Approver, User)
  • Manager ID (for hierarchy)
  • Active status

UAF Records

  • UAF ID, Employee, Department
  • Requested Assets, Quantities
  • Supervisor Approval, Status
  • Allocated Assets, Assignment Date

Compliance

  • Device ID, Compliance Status
  • Last Check Date, Required Actions
  • Passport Valid, Restrictions
  • Notes

Audit Log

  • Log ID, User, Action Type
  • Entity ID, Entity Type
  • Changes (before/after), Timestamp
  • IP Address, Session ID

📖 Core Workflows

Asset Approval Pipeline

┌─────────────────┐
│   User Submit   │
│  Transfer Req   │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   Manager Rev   │ ◄──── Approve/Reject
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  Finance Check  │ ◄──── Approve/Reject
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│ Compliance Gate │ ◄──── Approve/Reject
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  Asset Updated  │
│ Audit Recorded  │
└─────────────────┘

📱 User Interface

Admin Dashboard

  • System metrics (total assets, pending approvals)
  • User management (create/edit/deactivate)
  • Configuration panel (roles, approval rules)
  • Compliance status overview

Manager Dashboard

  • Team assets overview
  • Pending approvals queue
  • Transfer history
  • Team member asset assignments

User Dashboard

  • My assets list
  • Submit transfer request
  • View request status
  • Download asset receipt

Compliance Dashboard

  • Laptop Passport status (all devices)
  • Non-compliant devices alert
  • Compliance trend reports
  • Automatic remediation actions

🧪 Testing

# Frontend unit tests
npm test

# Backend unit tests
dotnet test

# Integration tests
dotnet test --filter Category=Integration

# End-to-end tests
npm run test:e2e

Test Coverage:

  • Asset CRUD operations
  • Approval workflow automation
  • Role-based access enforcement
  • UAF processing
  • Compliance checking

🚨 Error Handling

  • Asset Not Found → 404 with helpful message
  • Unauthorized Access → 403 with role info
  • Workflow Violation → Clear error explaining required approvals
  • Duplicate Assets → Validation prevents duplicates
  • Network Issues → Automatic retry with exponential backoff

📈 Performance & Scalability

  • Load Time → Dashboard loads in <2 seconds
  • Concurrent Users → Supports 500+ simultaneous users
  • Asset Database → Handles 50,000+ assets efficiently
  • Search Optimization → Indexed queries on frequently searched fields
  • Caching Strategy → Redis caching for frequently accessed data

🐛 Known Limitations & Future Enhancements

Current Limitations

  • Bulk transfer operations (coming in v2)
  • Mobile app for on-the-go approvals (in progress)
  • Integration with procurement systems (planned)
  • Multi-location asset visualization (planned)

Planned Features

  • SMS/Email notifications
  • Advanced analytics and forecasting
  • Asset depreciation calculations
  • Integration with Active Directory/LDAP
  • Barcode/QR code scanning for asset receipt
  • Mobile app (iOS/Android)
  • API for third-party integrations

🔌 API Documentation

Base URL

https://agms-api.azurewebsites.net/api

Authentication

POST /auth/login
Content-Type: application/json

{
  "email": "user@company.com",
  "password": "password"
}

# Returns: JWT token in Authorization header
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Key Endpoints

Assets

GET    /assets                    — List all assets (paginated)
GET    /assets/{id}              — Get asset details
POST   /assets                   — Create new asset
PUT    /assets/{id}              — Update asset
DELETE /assets/{id}              — Deactivate asset
GET    /assets/search?q=keyword  — Search assets

Transfers

POST   /transfers                — Submit transfer request
GET    /transfers/{id}           — Get transfer status
GET    /transfers?status=pending — Get pending transfers
PUT    /transfers/{id}/approve   — Approve transfer
PUT    /transfers/{id}/reject    — Reject transfer

UAF

POST   /uaf                      — Submit UAF
GET    /uaf/{id}                 — Get UAF details
PUT    /uaf/{id}/approve         — Approve UAF
GET    /uaf?status=pending       — Get pending UAFs

Compliance

GET    /compliance/status        — Get compliance dashboard
GET    /compliance/laptops       — Laptop Passport status
PUT    /compliance/{id}/enforce  — Enforce compliance rule
POST   /compliance/scan          — Scan for violations

Reports

GET    /reports/assets           — Asset inventory report
GET    /reports/transfers        — Transfer analytics
GET    /reports/compliance       — Compliance report
GET    /reports/audit            — Audit trail export

🤝 Support & Maintenance

Bug Reports: Report issues in the system's feedback form or contact admin
Feature Requests: Submit via the "Suggest Feature" button in the app
Maintenance: Regular updates and backups scheduled for weekends
SLA: 99.5% uptime guarantee


📞 Contact

  • Primary Contact: IT Operations Manager
  • Technical Issues: IT Support Desk
  • Compliance Questions: Compliance Office
  • Access Requests: HR Department

📄 License

Internal proprietary software owned by Awsys-I.


👨‍💻 Developer

Erine Lopez — Senior .NET Developer | AI-First Engineer


Built for reliability, designed for compliance, optimized for operations. ✅

About

No description or website provided.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages