Plan. Survey. Deploy. An ISP Network Infrastructure Planning & Site Survey Tool for MDUs, commercial buildings, and campuses.
Built by Krish Kant Rai · GitHub
Traditional ISP site surveys suffer from fragmented tooling, paper-based checklists, and zero traceability. ProbeLink solves this by:
- Hierarchical Property Management — Organize sites into Properties → Buildings → Floors → Spaces.
- Interactive Floor Canvas — Upload floor plans, draw space geometry, overlay RF heatmaps.
- Field Data Collection — Log equipment, cable paths, and checklist responses from the field.
- Role-Based Access — Admin, Engineer, and Customer roles with appropriate permissions.
- PDF Report Generation — One-click reports covering floor plans, equipment inventory, checklists, and RF scan coverage.
graph TD
A[Admin Logs In] --> B[Create Organization]
B --> C[Add Property with Location]
C --> D[Add Building → Floor → Spaces]
D --> E[Upload Floor Plan to Canvas]
E --> F[Draw Space Geometry on Canvas]
F --> G[Assign Engineer to Property]
G --> H[Manage Users & Roles]
Step-by-Step:
- Create ISP organization(s) with contact details.
- Add property (campus/MDU/building) with address and GPS coordinates.
- Build hierarchy — buildings, floors, and named spaces per floor.
- Upload floor plan PNG and open the canvas to map space polygons.
- Assign engineers, manage roles, approve/deactivate accounts.
graph TD
A[Engineer Logs In] --> B[Open Assigned Property]
B --> C[Select Floor → Open Canvas]
C --> D[Log Equipment per Space]
D --> E[Record Cable Paths between Spaces]
E --> F[Fill Checklist for each Space]
F --> G[Upload RF Scan File]
G --> H[RF Heatmap Generated on Canvas]
Step-by-Step:
- Navigate to assigned property and open the floor canvas.
- Log network equipment (routers, switches, APs, etc.) to specific spaces.
- Record cable routes between spaces with medium type and length.
- Complete admin-defined checklists for each space.
- Upload RF scan files (Vistumbler/Kismet) — heatmap auto-renders on canvas.
graph TD
A[Admin selects Property] --> B[Choose Report Sections]
B --> C{Include?}
C -->|Yes| D[Floor Plans & Layouts]
C -->|Yes| E[Equipment Inventories]
C -->|Yes| F[Checklist Summaries]
C -->|Yes| G[RF Scan Heatmaps]
D & E & F & G --> H[Generate PDF Job Triggered]
H --> I[Poll Status]
I --> J[Download PDF on DONE]
| Feature | Description | Screenshot |
|---|---|---|
| Login | Secure sign-in with JWT session management. Supports light/dark mode. |  |
| Registration | New accounts default to Customer role. Admin can reassign role post-registration. Engineers and Admins gain elevated access. |  |
Admins manage ISP organizations — the top-level grouping for properties and users.
| Page | Description | Screenshot |
|---|---|---|
| Org List | View all registered organizations with contact info. Add or edit orgs. |  |
| Edit Org | Update name, email, phone, and address for any organization. |  |
Central workspace snapshot for admins and engineers.
| Metric | What It Shows |
|---|---|
| Properties / Spaces / Equipment / Cable Paths / RF Scans | Platform-wide count tiles |
| Survey Completion | Per-property progress — spaces with submitted checklists vs. total |
| Checklist Distribution | Submitted vs. draft count per template |
| RF Scan Coverage | % floors scanned per property |
| Properties Overview | Table: buildings, floors, spaces, equipment, cables, checklists, progress per property |
Build the full site hierarchy from property down to individual spaces.
| Page | Description | Screenshot |
|---|---|---|
| Property Cards | All properties shown as cards with type, org, address. |  |
| Edit Property | Set name, type (Campus/MDU/etc.), organization, address, GPS coordinates, assigned engineer. |  |
| Building & Floor Tree | Drill into a property to see buildings → floors → spaces. Upload floor plan per floor. |  |
| Floor Canvas | Interactive canvas — open RF heatmap overlays, view/select spaces, inspect equipment and checklists per space. |  |
The canvas shows live RF signal strength (color-coded -30 to -90 dBm), space geometry labels, and per-space side panels with Info, Equipment, and Checklists tabs.
Inventory of installed hardware across all spaces.
| Page | Description | Screenshot |
|---|---|---|
| Equipment List | All logged devices with type badge, vendor/model, and space location. |  |
| Edit Equipment | Select property hierarchy (property → building → floor → space), type, vendor, model, serial number. |  |
Supported equipment types: Access Point, Switch, Router, ONT, Antenna, Cabinet, UPS, Other.
Physical cable routing documentation between spaces.
| Page | Description | Screenshot |
|---|---|---|
| Cable List | All routes with medium type badge, property, and space-to-space path. |  |
| Edit Cable Path | Select property, from/to spaces, cable medium, and length in meters. |  |
Supported mediums: Copper, Fiber, Coax, Power.
Admin-defined survey templates filled by engineers per space.
| Page | Description | Screenshot |
|---|---|---|
| Templates | Create and manage versioned checklist templates. Each template scoped to an org and space type. |  |
| Edit Template | Add schema fields with types: Text, Number, Yes/No, Dropdown. Mark fields as required. Updates create a new version. |  |
| All Submissions | View engineer-submitted responses per template and space. Shows answers, submitter, and timestamps. |  |
Generate comprehensive site survey reports on demand.
| Page | Description | Screenshot |
|---|---|---|
| Reports | Select a property, choose sections to include, trigger PDF generation. View and download completed reports. |  |
Report sections: Floor Plans & Layouts · Checklist Summaries · Equipment Inventories · RF Scan Heatmaps.
Admin controls for all platform users.
| Page | Description | Screenshot |
|---|---|---|
| Pending Requests | Review and approve new registrations before access is granted. |  |
| Active Users | Full user list with inline role and organization assignment. Deactivate or delete accounts. |  |
Roles: Admin · Engineer · Customer.
Users can update their profile details and change profile photo.
| Layer | Technology |
|---|---|
| Frontend | React.js, Tailwind CSS |
| Backend | Spring Boot (Java 17), Spring Security, JWT |
| Database | MySQL 8 (Docker) |
| Migration | Flyway — auto-migrates on startup |
| Maps / Canvas | Custom SVG canvas with RF heatmap overlay |
| Auth | JWT access + refresh tokens |
probelink/
├── backend/
│ └── src/main/java/com/probelink/
│ ├── controller/ # REST API endpoints
│ ├── service/ # Business logic
│ ├── entity/ # JPA entities
│ └── repository/ # Spring Data repos
└── frontend/
└── src/
├── pages/ # React page components
├── services/ # Axios API layer
└── utils/ # Helpers
| Tool | Version |
|---|---|
| Java | 17+ |
| Node.js | 18+ |
| Docker | Latest |
| Docker Compose | v2+ |
MySQL is handled by Docker — no local install needed.
- Login with admin credentials.
- Create organizations and add properties.
- Build property hierarchy (buildings → floors → spaces).
- Upload floor plans, open canvas, draw space geometry.
- Create checklist templates and assign engineers.
- Monitor survey completion from dashboard.
- Generate PDF reports when survey is complete.
- Login and navigate to assigned property.
- Open floor canvas — map spaces if not already done.
- Log equipment to spaces.
- Add cable path routes.
- Fill checklists for each space.
- Upload RF scan files for heatmap generation.
- Login to view assigned property reports.
- Download generated PDF survey reports.
This project was developed as part of the Infosys Springboard Java internship program.
Platform: ProbeLink — ISP Site Survey Tool
Author: Krish Kant Rai
LinkedIn: krish-kant-rai-3a8734338
GitHub: krishkantrai27
Made with 📡 for smarter network infrastructure planning