A comprehensive internal dashboard for managing network infrastructure IP allocations across enterprise operations.

Managing IP addresses in a large enterprise network with multiple locations, devices, and distributed systems is complex and error-prone:

• IP Address Conflicts: Manual IP allocation leads to conflicts and network outages
• Poor Visibility: No centralized view of IP usage across districts, branches, and ATMs
• Inefficient Resource Management: Difficulty tracking which IPs are leased, available, or reserved
• Security Risks: Lack of audit trails and role-based access control
• Scalability Issues: Managing LAN and tunnel IP ranges across multiple clusters and districts

IPAM provides a centralized, web-based dashboard that solves these challenges with enterprise-grade features:

• Centralized IP Management: Single source of truth for all IP allocations
• Automated Conflict Prevention: System prevents duplicate IP assignments
• Real-time Visibility: Dashboard showing IP usage across all locations and devices
• Role-Based Access Control: Secure access with different permission levels
• Audit Trail: Complete tracking of IP assignments and changes
• Efficient Resource Utilization: Automated IP leasing for branches and ATMs

• Define and manage LAN IP ranges for different districts and clusters
• Configure tunnel IP ranges for secure inter-branch connectivity
• Automatic IP pool generation from defined ranges

• Track IP assignments for offices and devices
• Automated lease management with conflict detection
• Hierarchical IP allocation (region → location → device)

• Role-based access control (Admin, Manager, User)
• Secure authentication with NextAuth
• Audit logging for all IP changes

• Bulk IP operations and management
• Real-time dashboards and reporting
• Database-backed with full audit history

• Frontend: Next.js 14 (App Router) with TypeScript
• Backend: tRPC for type-safe APIs
• Database: PostgreSQL with Prisma ORM
• Authentication: NextAuth.js with role-based access
• Styling: Tailwind CSS with shadcn/ui components
• Validation: Zod for schema validation

• Node.js 18+
• PostgreSQL database
• pnpm package manager

# Clone the repository
git clone https://github.com/dayOneAbu/IPAM.git
cd ip-watcher
# Install dependencies
pnpm install
# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your database URL and auth secrets

# Push schema to database
pnpm run db:push
# (Optional) Open Prisma Studio to view data
pnpm run db:studio

# Start development server
pnpm run dev

Visit http://localhost:3000 to access the application.

Create a .env.local file with the following variables:

# Database
DATABASE_URL="postgresql://username:password@localhost:5432/ipam_db"
# Authentication
NEXTAUTH_SECRET="your-secret-key-here"
NEXTAUTH_URL="http://localhost:3000"
# Optional: Skip env validation during builds
SKIP_ENV_VALIDATION=1

src/
├── app/ # Next.js app router pages
│ ├── (routes)/ # Main application routes
│ ├── api/ # API routes (NextAuth)
│ └── _components/ # Shared UI components
├── server/
│ ├── api/ # tRPC routers and configuration
│ ├── auth.ts # Authentication logic
│ └── db.ts # Database connection
├── trpc/ # tRPC client configuration
└── lib/ # Utility functions

The system uses role-based access control with three main roles:

• Admin: Full system access, user management
• Manager: District/cluster management, IP range oversight
• User: Read-only access, limited IP management

Key entities managed by the system:

• Users: System users with roles and permissions
• Clusters: Geographic groupings of districts
• Districts: Regional administrative divisions
• Branches: Physical bank locations
• ATMs: Automated teller machines
• LAN Ranges: IP address ranges for local networks
• Tunnel Ranges: IP ranges for secure connections
• IP Pools: Individual assignable IP addresses
• Leases: IP address assignments to devices/locations

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is proprietary software for internal enterprise operations.

For support or questions, please contact the IT infrastructure team.