Fiber Management System

Credential

User: admin@admin

Password: password

📋 Project Overview

Fiber Management System is an enterprise-grade, production-ready network infrastructure management platform designed for Internet Service Providers (ISPs), telecommunications companies, and fiber optic network operators. Built to manage complex fiber networks with precision, the system provides comprehensive tools for network topology visualization, equipment management, customer connectivity tracking, and real-time monitoring.

The platform offers end-to-end fiber network management from physical infrastructure (locations, cables, cores) to logical services (customer connections, equipment linkages, monitoring), delivering an exceptional experience for network engineers, operations staff, and administrators.

🎯 Key Objectives

• Network Visualization: Interactive Google Maps-based fiber network topology with cable routing and location tracking
• Fiber-Level Management: Individual fiber core tracking with signal metrics, color codes, and connection management
• Equipment Inventory: Comprehensive 40+ equipment type support with polymorphic relationships and SNMP monitoring
• Customer Management: Complete customer lifecycle from registration to service activation and contract management
• Real-time Monitoring: SNMP-based equipment health monitoring with downtime tracking and alerting
• Multi-Branch Operations: Support for multiple branches with hierarchical access control
• Scalable Architecture: Laravel-based backend with PostgreSQL for handling large-scale network data
• Role-Based Access: Fine-grained permissions with global, branch, and team-level data access

✨ Features

🗺️ Interactive Fiber Map & Visualization

• Google Maps Integration:

  • Real-time fiber cable line visualization on interactive maps
  • Custom location markers with adjustable scaling and styling
  • Drawing mode for creating new fiber cable routes
  • Map-based network topology view with zoom and pan controls
  • Search functionality for locations and cables by name
  • Multiple marker styles and symbol support
  • Automatic coordinate transformation and geocoding

• Network Topology Visualization:

  • Visual representation of fiber cable paths
  • From/To location routing display
  • Intermediate path points for complex routes
  • Cable utilization indicators
  • Location-based filtering and clustering
  • Export map views for documentation

🌐 Network Infrastructure Management

Physical Infrastructure

• Location & POP Management:

  • Geographic point management with latitude/longitude coordinates
  • Address tracking with detailed location information
  • Location types (POP, Distribution Point, Customer Site, etc.)
  • Position types and classification
  • Branch association for multi-location operations
  • Custom map symbols and icons per location
  • Location hierarchy and relationships

• Fiber Cable Management:

  • End-to-end cable lifecycle tracking
  • Cable naming, type, and owner information
  • From/To location routing with path visualization
  • Cable length calculation (physical and geographic distance)
  • Cable provider association
  • Installation date and maintenance notes
  • Cable specifications (12, 24, 48-core options)
  • Real-time utilization tracking (available vs. used cores)
  • Splice management with location and technical notes
  • Cable status tracking (active, inactive, maintenance)
  • Color-coded cable display on maps

Fiber Core Management

• Individual Fiber Core Tracking:

  • Per-core management within cables
  • Color code assignment (industry-standard fiber color codes)
  • Tube assignments for organization
  • Signal quality metrics:
    • Attenuation levels (dB loss)
    • Signal strength measurements
    • Wavelength specifications (nm)
    • Signal quality ratings (excellent to failed)
  • Usage type classification
  • Upstream/downstream equipment connections
  • Port-level connectivity mapping
  • Splice tracking and loss calculations
  • Core reservation and allocation

• Fiber Path Management:

  • Intermediate waypoints for cable routing
  • Path optimization suggestions
  • Distance calculations along paths
  • Path documentation and notes

🖥️ Equipment Management

Comprehensive Equipment Inventory (40+ Types)

Base Equipment System with Polymorphic Architecture:

• Generic Equipment (base class with shared attributes)

• Active Network Equipment:

  • Routers (Layer 3 routing equipment)
  • Switch Equipment (Layer 2/3 switches)
  • OLT Equipment (Optical Line Terminal for PON networks)
  • ONU/ONT Equipment (Optical Network Units/Terminals)
  • WDM Systems (Wavelength Division Multiplexing)

• Passive Optical Equipment:

  • ODF Equipment (Optical Distribution Frames)
  • Splitters (fiber optic splitters with split ratios)
  • Enclosures (FDB, FAT, FDT, ATB types)
  • SFP Modules (Small Form-Factor Pluggables)
  • Racks (equipment rack management)

• Customer Premises Equipment:

  • End Point Devices (CPE, routers, ONTs)
  • Customer network interfaces

Equipment Features

• Equipment Specifications:

  • Serial number tracking
  • Model and brand association
  • Device type classification
  • Installation date and location
  • IP address management
  • Monitoring status (enabled/disabled)
  • Health scores and uptime metrics
  • Last response time tracking
  • Equipment photos and documentation

• Equipment Networking:

  • Network interface management
  • Port configuration and tracking
  • Speed capabilities per interface
  • Interface types and connectivity options
  • Interface utilization monitoring
  • Multi-interface equipment support

• Equipment Positioning:

  • Rack mounting position tracking
  • U-height and rack space management
  • Location-based equipment grouping
  • Equipment hierarchy visualization

🔗 Connectivity & Network Topology

• Equipment Linkages:

  • Source-to-destination equipment connections
  • Interface-based connectivity mapping
  • Bandwidth capacity tracking per link
  • Current utilization monitoring
  • Dependency levels and impact radius
  • Connection type specification (fiber, copper, wireless)
  • Automatic bandwidth calculation from interfaces
  • Interface compatibility validation
  • Redundancy and failover path tracking

• Fiber Core Connectivity:

  • Individual fiber strand connection mapping
  • Upstream/downstream equipment assignment
  • Port-level connection details
  • Signal quality measurements per connection
  • Splice point tracking
  • End-to-end path visualization

• Network Types & Speeds:

  • Connectivity type definitions (FTTH, FTTB, P2P, etc.)
  • Network speed tiers (10M, 100M, 1G, 10G, etc.)
  • Interface speed capabilities
  • Bandwidth allocation and management

👥 Customer Management

• Customer Directory:

  • Comprehensive customer database
  • Customer types (Residential, Business, Enterprise, Government)
  • Customer categories and segments
  • Contact information with multiple phone numbers
  • Service and billing address management
  • Opening balance tracking
  • Nationality and identification details
  • Customer status management

• Customer Connections:

  • Service subscription management per customer
  • Speed tier assignments
  • Connectivity type selection (FTTH, FTTB, Wireless, etc.)
  • Serving equipment assignment (OLT, ONU, Router)
  • IP configuration:
    • Static IP address assignment
    • Subnet mask configuration
    • Gateway specification
    • DNS server settings
  • Connection status (active, inactive, suspended)
  • Activation date and service history
  • Bandwidth monitoring per connection

• Service Contracts:

  • Contract lifecycle management
  • Service-level agreements (SLAs)
  • Contract start and end dates
  • Contract terms and conditions
  • Associated services per contract
  • Contract renewal tracking
  • Pricing and billing information

• Customer Projects:

  • Project-based installations
  • Project timeline tracking
  • Resource allocation
  • Project status monitoring

📡 Monitoring & Health Management

• SNMP Configuration:

  • OID (Object Identifier) configuration for equipment
  • Custom monitoring profiles per equipment type
  • Metric polling setup and intervals
  • SNMP community strings and credentials
  • Response time monitoring
  • Polling log tracking
  • Alert threshold configuration

• Equipment Health Scoring:

  • Automated health score calculation
  • Uptime percentage tracking
  • Downtime event logging
  • Performance degradation detection
  • Health trend analysis
  • Equipment comparison metrics

• Real-time Monitoring:

  • Live equipment status polling
  • Performance metrics collection:
    • CPU utilization
    • Memory usage
    • Interface statistics
    • Temperature readings
    • Power consumption
  • Health dashboard with real-time updates
  • Alert generation and notification
  • Historical metric tracking

• Notification System:

  • Configurable notification settings
  • Alert thresholds per metric type
  • Email notifications for critical events
  • Escalation rules for unacknowledged alerts
  • Notification history and audit trail

🏢 Organizational Management

• Employee Directory:

  • Employee records with complete contact information
  • Department assignments
  • Team memberships with team types
  • Branch assignments for field operations
  • Profile photos and personal details
  • Role-based access control assignment
  • Employee status tracking

• Department Structure:

  • Hierarchical organization chart
  • Department-based team management
  • Team types (Technical, Sales, Support, etc.)
  • Supervisor and manager assignments
  • Inter-departmental coordination

• Branch Operations:

  • Multi-branch company support
  • Branch-specific data access control
  • Location management per branch
  • Branch-level reporting
  • Resource allocation by branch

📦 Inventory & Asset Management

• Equipment Models & Brands:

  • Device type classification (Router, Switch, OLT, etc.)
  • Model specifications and datasheets
  • Manufacturer/brand tracking
  • Model versioning
  • Compatible interface types
  • Purchase information and warranty tracking

• Device Tagging System:

  • Auto-generating device naming conventions
  • Configurable tag formats
  • Prefix and suffix customization
  • Sequential numbering
  • Barcode generation for physical labeling
  • Tag-based search and filtering

• Cable Specifications:

  • Standard core count templates (12, 24, 48-core)
  • Cable type definitions (Single-mode, Multi-mode)
  • Specification library for quick cable creation
  • Cable color standards

• Units & Measurements:

  • Measurement unit definitions (meters, kilometers, dB, etc.)
  • Unit conversion support
  • Standardized metric tracking

⚙️ System Configuration & Administration

User & Role Management

• Role-Based Access Control (RBAC):

  • Hierarchical role system
  • Permission types: read, write, delete, admin
  • Three access levels:
    • Global Access: Full system visibility
    • Branch-Level Access: Limited to assigned branch data
    • Team-Level Access: Limited to team resources
  • Fine-grained permission assignment per resource
  • Custom role creation

• User Authentication:

  • Laravel Fortify authentication
  • Two-Factor Authentication (2FA) with recovery codes
  • User activation/deactivation
  • Last login tracking
  • Session management
  • Password reset and recovery
  • API token authentication (Laravel Sanctum)

System Settings

• Company Configuration:

  • Company information and branding
  • System-wide parameters
  • Default settings management
  • Regional settings (timezone, language, currency)

• Integration Settings:

  • Google Maps API key configuration
  • Email configuration (SMTP settings)
  • SNMP default credentials
  • Notification channels setup

• Data Management:

  • Batch import operations
  • CSV/Excel file import
  • Data validation and error handling
  • Import progress tracking
  • Export functionality for reports

Installer System

• Web-Based Installation Wizard:
  • Accessible via /installer route
  • System requirements verification
  • Database connection testing
  • Automatic migration execution
  • Database seeding with default data
  • Admin account creation
  • Environment file configuration
  • Post-installation verification

📊 Reporting & Analytics

• Dashboard:

  • Key performance indicators (KPIs)
  • Network statistics overview
  • Equipment health summary
  • Customer growth metrics
  • Utilization charts

• Network Reports:

  • Cable utilization reports
  • Fiber core availability
  • Equipment inventory reports
  • Network topology diagrams
  • Downtime analysis

• Customer Reports:

  • Customer analytics
  • Service subscription reports
  • Revenue projections
  • Contract expiration tracking

• Performance Reports:

  • Equipment uptime reports
  • SNMP polling statistics
  • Health score trends
  • Maintenance schedules

🛠️ Technology Stack

Backend

Frontend

Development Tools

Infrastructure

• Database: PostgreSQL with advanced indexing and partitioning
• Cache: File/Redis-based caching for performance
• Session: Database sessions for horizontal scaling
• Queue: Laravel queue system for background jobs
• Storage: Local/S3-compatible file storage
• Maps: Google Maps JavaScript API for visualization

📊 Project Statistics

🎯 Use Cases

For Internet Service Providers (ISPs)

• Complete fiber network infrastructure management
• Customer connection tracking from installation to termination
• Real-time network monitoring and alerting
• Multi-branch operations with centralized management
• Service contract and SLA management
• Revenue tracking and customer analytics
• Field technician coordination

For Telecommunications Companies

• Large-scale fiber network deployment tracking
• Equipment inventory across multiple sites
• Network topology visualization and planning
• Fiber core utilization optimization
• Equipment health monitoring and maintenance scheduling
• Customer service management
• Regulatory compliance reporting

For Network Operations Centers (NOCs)

• Real-time network monitoring dashboard
• Equipment health scoring and alerting
• Downtime event tracking and response
• Performance metrics analysis
• Network capacity planning
• Troubleshooting and diagnostics
• Incident management

For Field Operations Teams

• Mobile-responsive interface for on-site access
• Location-based equipment and cable lookup
• Installation documentation and tracking
• Fiber core assignment and splicing records
• Customer connection details at premises
• Equipment serial number and specification access
• Work order integration

🌟 Key Differentiators

1. Fiber Core-Level Tracking - Individual fiber strand management with signal metrics and connection details
2. Polymorphic Equipment System - Elegant architecture supporting 40+ equipment types with shared and unique attributes
3. Interactive Map Visualization - Google Maps integration with custom fiber cable routing and real-time drawing
4. Comprehensive SNMP Monitoring - Custom OID configuration with health scoring and automated alerting
5. Multi-Level Access Control - Global, branch, and team-level permissions for data security
6. Equipment Linkage Tracking - Detailed equipment-to-equipment connectivity with bandwidth management
7. Customer-Centric Design - Deep integration of customer data with network infrastructure
8. Auto-Tagging System - Configurable device naming with barcode generation
9. Web-Based Installer - Complete installation without CLI access required
10. Production-Ready Architecture - Enterprise-grade Laravel application with proper authorization and validation

🔒 Security & Compliance

Security Measures

• Authentication: Two-factor authentication (2FA) with recovery codes
• Authorization: Role-based access control with branch/team-level filtering
• API Security: Token-based authentication via Laravel Sanctum
• Data Validation: Comprehensive request validation on all inputs
• SQL Injection Prevention: Eloquent ORM with parameterized queries
• XSS Protection: Blade template auto-escaping
• CSRF Protection: Laravel CSRF tokens on all forms
• Session Security: Secure session handling with timeout controls
• Password Security: Bcrypt hashing with strong password requirements

Data Protection

• Branch-Level Isolation: Users only access data within their authorized branch
• Team-Level Filtering: Additional restriction to team resources when applicable
• Audit Trails: Activity logging for sensitive operations
• Backup & Recovery: Database backup functionality
• Data Retention: Configurable retention policies
• Privacy Controls: Customer data protection mechanisms

📚 Documentation

The project includes comprehensive documentation:

• INSTALLATION_GUIDE.md - Complete deployment and setup guide
• API_CONTROLLER_GUIDE.md - Custom API package documentation
• TAGGING_GUIDE.md - Device tagging system configuration
• SNMP_POLLING_SETUP.md - Equipment monitoring setup
• IMPLEMENTATION_SUMMARY.md - Feature implementation details
• Component Guides - Individual component documentation in /docs/components/

📞 Support & Contact

Developed by: Kodevite

Project: Fiber Management System

Framework: Laravel 12 with PostgreSQL, Alpine.js, and Tailwind CSS

Website: https://kodevite.com

For support, feature requests, or custom development:

• Email: info@kodevite.com
• Website: https://kodevite.com

📄 License

License information to be added based on project requirements

🙏 Acknowledgments

Built with industry-leading technologies:

• Laravel - The PHP Framework for Web Artisans
• PostgreSQL - The World's Most Advanced Open Source Database
• Alpine.js - Your new, lightweight, JavaScript framework
• Tailwind CSS - A utility-first CSS framework
• Google Maps Platform - Mapping and location services