plans(optical): the PON budget is called whole-path and prices one cable #2442

Merged
jaylouisw merged 1 commit from plan/1121-1537 into main 2026-11-21 16:08:30 +00:00
Owner

Plans only. One page, docs/plans/pon-path-budget.md.

The engine's ponBudget() is designed for a path (lengthM + splitters[]) and is called once per cable from validateLink(), while validation.js:139 calls the result "a whole-path verdict". Measured today: two 24 km legs of one PON through a 1:8 splitter each validate clean at 8.2 dB spare; the 48 km path is 28.2 dB against a 28 dB B+ budget and nothing says so.

Also found: 6 of 21 category: splitter specs carry no splitRatio, so they are priced at 0 dB (FBT 1x2 at 66 km: validates at 23.7 dB / 4.3 dB spare; with the part's real 4.1 dB it is 27.8 dB / 0.2 dB, and the <3 dB warning never fires); 0 of 2,352 specs declare ponClass, so every PON is priced as GPON B+; the spare is computed and thrown away; and show interfaces <port> prints no cage or media even though cli.js:803 says it does.

Steps: (1) price the path, reusing E_OPTICAL_BUDGET; (2) refuse a splitter whose ratio cannot be resolved instead of charging 0 dB; (3) ponClass on 5 sourced OLT specs + schema + audit; (4) store the verdict on the link; (5) print the media in show interfaces <port>; (6) optional show pon — needs Jay's approval.

Closes no open issue: the queue holds only #130.

Plans only. One page, `docs/plans/pon-path-budget.md`. The engine's `ponBudget()` is designed for a path (`lengthM` + `splitters[]`) and is called once per cable from `validateLink()`, while `validation.js:139` calls the result "a whole-path verdict". Measured today: two 24 km legs of one PON through a 1:8 splitter each validate clean at 8.2 dB spare; the 48 km path is 28.2 dB against a 28 dB B+ budget and nothing says so. Also found: 6 of 21 `category: splitter` specs carry no `splitRatio`, so they are priced at 0 dB (FBT 1x2 at 66 km: validates at 23.7 dB / 4.3 dB spare; with the part's real 4.1 dB it is 27.8 dB / 0.2 dB, and the <3 dB warning never fires); 0 of 2,352 specs declare `ponClass`, so every PON is priced as GPON B+; the spare is computed and thrown away; and `show interfaces <port>` prints no cage or media even though `cli.js:803` says it does. Steps: (1) price the path, reusing `E_OPTICAL_BUDGET`; (2) refuse a splitter whose ratio cannot be resolved instead of charging 0 dB; (3) `ponClass` on 5 sourced OLT specs + schema + audit; (4) store the verdict on the link; (5) print the media in `show interfaces <port>`; (6) optional `show pon` — needs Jay's approval. Closes no open issue: the queue holds only #130.
plans(optical): the PON budget is called whole-path and prices one cable
All checks were successful
CI / Server smoke and Docker build (pull_request) Successful in 29s
PR rebase / Rebase onto main and arm auto-merge (pull_request) Successful in 4s
CI / Test (Node 20) (pull_request) Successful in 1m2s
CI / Test (Node 18) (pull_request) Successful in 1m3s
CI / Test (Node 22) (pull_request) Successful in 1m4s
CI / Arm auto-merge (pull_request) Successful in 3s
ad7bd8093d
forgejo-actions scheduled this pull request to auto merge when all checks succeed 2026-11-21 15:42:24 +00:00
forgejo-actions canceled auto merging this pull request when all checks succeed 2026-11-21 16:00:22 +00:00
jaylouisw deleted branch plan/1121-1537 2026-11-21 16:08:32 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
jaylouisw/packetforge!2442
No description provided.