Snabbstart och nedladdning
Ladda ned Network Project v1.0.1 (ZIP)
Paketet är uppdaterat till v1.0.1. Skapad av MBerling · Utgiven av LabOps IT.
Arbetsordning: Projekt → Hallar/rack → Utrustning → Kablar med A/B-märkning → Installera och dokumentera → Verifiera → Checklista → Exportera komplett ZIP.
Så läser du guiden: Menyer, fält och exportformat beskriver faktiska funktioner i v1.0.1. Arbetsflödet i avsnitt 5, backupförslagen och godkännandekriterierna är rekommenderade arbetsrutiner. Appen utför inga fysiska tester eller formella godkännanden.
Skapare och fasta programtexter
Skapad av MBerling. Appen distribueras av LabOps IT. NETWORK / PROJECT och skaparinformationen är fasta i programfilerna och ändras inte via projektuppgifterna. Projektets namn, ansvarig, register och dokumentation är fortsatt redigerbara.
En lokal HTML-app kan inte förhindra att någon med skrivåtkomst ändrar dess källfiler. Hårdkodning ger fasta standardtexter, inte ett tekniskt ändringsskydd. Paketets SHA256SUMS.txt används för att jämföra distributionsfiler mot en betrodd kopia. Hämta paketets SHA-256-kontrollsumma. Spara en fullständig projektbackup innan du uppdaterar appen eller ändrar öppningsadress.
1. Översikt och syfte
När nätverksutrustning flyttas, switchar byts, fiberförbindelser patchas om eller nya server- och storageanslutningar installeras är den fysiska dokumentationen minst lika viktig som konfigurationen. Utan ett gemensamt kabelregister är det lätt att tappa bort vilken kabel som går mellan två portar, vilken transceiver som används och om förbindelsen har testats.
Network Project är ett offline-orienterat, webbläsarbaserat dokumentationsverktyg för:
- Projektinformation: kund, anläggning, ansvarig, revisionsnummer och journal.
- Fysisk platsstruktur: hallar, teknikrum, byggnader, rack och zoner.
- Utrustningsregister: switchar, routrar, servrar, hypervisorer, storage, patchpaneler och ODF.
- Kablar och förbindelser: unikt kabel-ID, från-/till-port, märkning i A- och B-ände, medium, kabelväg, hastighet och optik.
- Genomförande: checklista, kommentarer, avvikelser och tidsstämplade aktiviteter.
- Bevismaterial: foton, skärmbilder, PDF-filer, text- och konfigurationsfiler kopplade till rätt post.
- Leverans: automatisk schematisk topologi, CSV-listor, JSON-data och fullständig projektbackup i ZIP.
Avgränsning: Verktyget konfigurerar inte switchar, upptäcker inte enheter automatiskt, gör ingen automatisk fiber-/kabelmätning och är inte ett DCIM-, NMS- eller change-management-system. Testvärden och inställningar läggs in manuellt.
2. För vem är det avsett?
Lämpliga användningsfall omfattar ny- eller omdragning av kablage i datorhallar, förändringar mellan teknikrum, rack-till-rack-förbindelser, utbyte av nätverksswitchar, tillkommande ESXi-/Hyper-V-/Linux-hostar, NAS/SAN-anslutningar, ODF-patchning, PoE-installationer och dokumentation av mindre eller större labbmiljöer.
Förutsättningar
- Windows, macOS eller Linux med en modern webbläsare, helst Microsoft Edge eller Google Chrome.
- Det nedladdade installationspaketet
NetworkProject_LabOpsIT_v1.0.1.zip. - Grundläggande kännedom om egna switchportar, rackplaceringar och kabeltyper.
- En plats att lagra exporterade projektbackuper enligt organisationens rutiner.
- Ingen installation av server, konto eller internetanslutning krävs normalt.
Öppna helst verktyget från en fast katalog och samma webbläsarprofil varje gång. Data sparas i webbläsaren och följer inte automatiskt med om du byter profil eller dator.
3. Installera och starta
- Ladda ned installations-ZIP från LabOpsIT-guideartikeln eller projektets distribution.
- Packa upp hela ZIP-filen. Flytta inte bara
index.html; den behöver filerna iassets/. - Öppna
NetworkProject_Dokumentation/index.htmli Edge eller Chrome. - Kontrollera att startsidan Översikt öppnas och att lokal sparning fungerar.
- Klicka på Redigera projektuppgifter och ange ett projektnamn.
- Exportera gärna en första projekt-ZIP när uppsättningen är klar.
Om webbläsaren inte tillåter bilagelagring via file://, kan projektmappen visas via en lokal HTTP-server, t.ex. om Python finns installerat:
cd NetworkProject_Dokumentation
python -m http.server 8000 --bind 127.0.0.1
Öppna därefter http://127.0.0.1:8000 i samma dator. Flaggan --bind 127.0.0.1 begränsar servern till den egna datorn. Stoppa den med Ctrl+C när arbetet är klart. Använd samma adress och port varje gång. Adresserna file:// och http://127.0.0.1:8000 är skilda lagringsursprung, vilket gör att tidigare webbläsarsparade projektdata inte automatiskt dyker upp när du växlar mellan dem. Exportera ZIP från den gamla öppningsmetoden och importera på den nya.
Katalogstruktur och första start
NetworkProject_Dokumentation/
index.html Startfil
assets/app.js Programfunktioner
assets/style.css Utseende
assets/ Även medföljande exempelbilder
exempel/exempelprojekt.json Fiktivt demoprojekt
backuper/README.md Information om backup
README.md Programbeskrivning
STARTA_HAR.txt Startinstruktion
Spara en första ändring, kontrollera texten Sparat lokalt längst ned i sidomenyn och ladda om sidan. Projektet ska finnas kvar. Katalogen backuper/ är ingen automatisk lagringsplats: exporter hamnar där webbläsaren sparar hämtade filer.
4. Förstå huvudmenyn
| Meny | Funktion | Resultat |
|---|---|---|
| Översikt | Projektuppgifter, nyckeltal, kvalitetskontroll, projektanteckningar och journal | Gemensam projektstatus |
| Hallar & rack | Byggnad, hall, teknikrum, rack, zon och rackhöjd | Fysisk placeringsstruktur |
| Utrustning & portar | Inventering och sökning på enhetsnamn, typ, modell och plats | Register över ändpunkter |
| Kablage & förbindelser | A/B-ändar, unika kabel-ID:n, media, moduldata, märkning och verifiering | Kabellista och schematisk topologikarta |
| Checklista | Arbetsmoment, egna punkter, kommentarer och tidsstämplad avprickning | Spårbar genomförandestatus |
| Bildbilagor | Samlad visning av filer kopplade till enheter, kablar och aktiviteter | Dokumentationsbibliotek |
| Export & backup | Fullständig ZIP, JSON, CSV samt återimport | Projektöverlämning och säkerhetskopiering |
5. Rekommenderat arbetssätt – från beställning till överlämning
Fas A – Skapa projekt
- Ange ett tydligt projektnamn (exempel:
DC1 – Rack R01 till R04 – 10G fiberutbyggnad). - Fyll i organisation/kund, anläggning/ort, projektansvarig, revision och startdatum.
- Skriv projektets omfattning, förutsättningar, eventuellt servicefönster, kontaktvägar och återställningsplan i projektanteckningarna.
- Använd Projektjournal för tidsstämplade beslut, ändringar och överenskommelser.
Det medföljande demoprojektet kan importeras från exempel/exempelprojekt.json. Det har egna exempelaktiviteter; ett nytt tomt projekt har de 13 standardaktiviteterna i avsnitt 7. Exportera alltid ditt aktuella projekt först.
Fas B – Inventera fysisk miljö
- Gå till Hallar & rack och skapa berörda platser. Exempel:
Hall A,Hall B,Teknikrum Nord. - Lägg till rack för varje plats, exempelvis
R01,R04ellerODF-A. - Välj Ny hall / plats, ange namn, byggnad/ort, platstyp och kommentar. Klicka Spara uppgifter.
- Välj Nytt rack, ange rackbeteckning, välj Tillhör plats, fyll i zon/rad och rackhöjd, exempelvis
42U, och spara. SkapaR01i Hall A ochR04i Hall B. Kontrollera själv att enhetens hall och rack hör ihop; rackvalet visar hela registret. - Fotografera nuläget innan någon befintlig kabel kopplas ur.
Bra princip: Använd samma racknamn som i befintliga märksystem, inventarielistor och lokala driftinstruktioner.
Fas C – Registrera utrustning
Gå till Utrustning & portar och välj Lägg till enhet. Registrera relevanta ändpunkter innan kabelregistret fylls i.
| Fält | Vad ska anges? | Exempel |
|---|---|---|
| Enhetsnamn | Egentligt hostname eller fysisk utrustningsbeteckning | DC1-SW-LEAF01 |
| Enhetstyp | Switch, server, storage, patchpanel/ODF, router m.m. | Switch |
| Tillverkare och modell | För igenkänning och teknisk kompatibilitet | Dell / PowerSwitch |
| Inventarie-ID / serienummer | Om organisationens policy medger det | INV-0041 |
| Management-IP eller DNS | Frivillig referens, om lämpligt att dokumentera | sw-leaf01.example.local |
| Hall/plats och rack | Fysisk placering | Hall A / R01 |
| Rackposition | U-plats | U17–U18 |
| Roll/funktion | Vad enheten används till | Server access, Aggregation, SAN |
| Kommentar | Firmware, installationsegenskaper, beroenden | Uplink 49–50 reserverad |
Verktyget är ett enhetsregister med portangivelser per kabel, inte ett separat automatiskt portinventeringssystem. Portinformation kopplas till varje skapad förbindelse. Fyll exempelvis i DC1-SW-LEAF01, typen Switch, Hall A, R01 och U17–U18, och välj Spara uppgifter. Skapa sedan DC1-NAS-01 i Hall B/R04. Välj Ändra för att rätta en post och Öppna för enhetens kommentarer och bilagor.
Fas D – Dokumentera kablar och fysiska förbindelser
Gå till Kablage & förbindelser → Ny förbindelse. En länk dokumenteras från A-ände till B-ände. Välj först de två registrerade enheterna, skriv deras exakta portar och fyll därefter i märkning och teknik. Avsluta med Spara uppgifter. Båda enheter och båda portfält krävs; appen stoppar också en förbindelse som börjar och slutar på samma enhet och samma port.
Identitet och märkning
| Fält | Betydelse |
|---|---|
| Unikt kabel-ID | Projektets unika identitet för förbindelsen; dubletter blockeras |
| Status | Planerad / Installerad / Verifierad / Avvikelse / Ur drift |
| A: Från enhet | Registrerad enhet där A-änden terminerar |
| A: Port/interface | Faktiskt portnummer, interface eller panelposition |
| A: Fysisk kabelmärkning | Texten på etiketten vid A-änden |
| B: Till enhet | Registrerad enhet där B-änden terminerar |
| B: Port/interface | Faktiskt portnummer, interface eller panelposition |
| B: Fysisk kabelmärkning | Texten på etiketten vid B-änden |
Kabelmedium och teknik
| Fält | Tillgängliga val / användning |
|---|---|
| Anslutningstyp | Fiber, Koppar / RJ45, DAC, AOC, Övrigt |
| Länkhastighet | 100M, 1G, 2.5G, 5G, 10G, 25G, 40G, 100G, 200G, 400G, Annat |
| Fiberklass | OS1, OS2, OM1, OM2, OM3, OM4, OM5, Annat |
| Kopparkategori | Cat5e, Cat6, Cat6A, Cat7, Cat8, Annat |
| Kabelns längd | Uppskattad eller uppmätt längd i meter |
| Fibrer/par/kärnor | Exempel: 2 fibrer, 1 par, 12F |
| A-/B-kontakt | Exempelvis LC/UPC, LC/APC, SC/UPC, SC/APC, MPO/MTP, RJ45, DAC |
| A-/B-modultyp | Exempelvis SFP+ 10G SR, SFP+ 10G LR, SFP28 25G LR, QSFP28 100G SR4, 10GBASE-T SFP+, DAC/AOC |
| A-/B-modell | Modulens exakta tillverkare och artikelbeteckning, separat i vardera ände |
| Kabelväg | Mellanliggande ODF-/patchpanelportar och kabelrutt |
| Funktion/trafik | Exempelvis Uplink, Storage, Management, vMotion, Backup |
| Verifierad av | Utförarens namn eller initialer |
| Testdatum | Datum för verkligt utförd kontroll |
| Mätresultat/länkstatus | Faktisk länkstatus, felräknare, optiknivå, testprotokollreferens |
| Kommentar | Avvikelse, konfigurationsutdrag eller arbetsanteckning |
Viktigt vid patchpaneler/ODF: Om varje fysisk kabelsektion behöver separat spårbarhet, registrera patchpaneler eller ODF som enheter och skapa en post per fysisk kabel/patchsegment. En enda post mellan switch och server genom flera paneler ger en förenklad ändpunktsöversikt, inte en fullständigt separat märkt kabelinventering över varje segment.
Fas E – Märkning vid båda ändar
Organisationens egen märkstandard gäller. Applikationen tvingar inte fram ett visst prefix. En god princip är att en kabel har ett gemensamt unikt kabel-ID, men att etiketttexten kan skilja sig mellan A- och B-änden.
Exempel:
Kabel-ID: DC1-FO-0027
A-ände: DC1-FO-0027 | R01 SW-LEAF01 Eth1/49 → R04 NAS-01 SFP1
B-ände: DC1-FO-0027 | R04 NAS-01 SFP1 → R01 SW-LEAF01 Eth1/49
Kabelväg: Hall A ODF-01/12 → Hall B ODF-03/08
För långa etiketter kan kortare lokala märkningar användas, så länge båda ändar kan spåras till samma unika ID i registret. Läsbarhet, vatten-/värmetålighet och organisationens lokala märksystem avgör faktisk etikettutformning.
Fas F – Installera och dokumentera
- Kontrollera att beställd kabel/optik passar gränssnitt, fiberklass, avstånd och kontaktstandard.
- Märk kablarna innan de dras eller direkt vid terminering.
- Följ godkänd kabelväg och dokumentera avsteg.
- Patcha rätt port på rätt enhet i båda ändar.
- Uppdatera postens status till Installerad.
- Öppna kabelns Detaljer och bifoga fotografi eller skärmbild.
- Ange en kort bildtext, exempelvis
R01 – port 49 – märkning efter installation. - Skriv kommentar om något skiljer sig från planeringen.
Fas G – Verifiera
Kontrollera förbindelsen med metoder anpassade till mediet och utrustningen. Dokumentera observerade värden, inte tänkta hastigheter.
Fiber: Kontrollera bl.a. modulkompatibilitet, kontakttyp/polaritet, faktisk länkhastighet, länkstatus, optikens Rx-/Tx-värden om tillgängliga och eventuell mät-/dämpningsrapport.
Koppar/RJ45: Kontrollera parterminering, kategori, kabeltest/certifiering där det krävs, PoE-behov vid tillämpliga förbindelser, förhandlad hastighet och portfel.
DAC/AOC: Kontrollera längd, kompatibilitet med båda ändpunkter, portläge, länkstatus och felräknare.
För varje verifierad länk dokumenteras minst:
- Namn/initialer på tekniker.
- Testdatum.
- Uppnådd hastighet och länkstatus.
- Eventuella felräknare/mätvärden eller referens till testprotokoll.
- Avvikelser och åtgärder.
- Bilaga som underlag när sådant finns.
Byt därefter manuellt status till Verifierad. Om problem kvarstår används Avvikelse och konkret beskrivning av felet.
Fas H – Överlämna
- Kontrollera att varje förbindelse har enhet och port i båda ändar.
- Kontrollera att kabel-ID och A/B-märkning är ifyllda.
- Kontrollera kvarvarande poster med status
Planerad,InstalleradellerAvvikelse. - Uppdatera bilder och kommentarer så att de avspeglar färdig installation.
- Exportera Märklista CSV, Kabellista CSV och Utrustningsregister CSV vid behov.
- Exportera topologikarta som PNG eller SVG.
- Exportera fullständig ZIP-backup och lagra den enligt organisationens rutin.
- Sätt ett lämpligt revisionsnummer i projektet och dokumentera överlämning i journalen.
6. Kabelteknik och tre praktiska exempel
Dokumentera medium, kontaktdon och transceivrar
Programfunktion: Listorna är dokumentationsval. De räknar inte ut räckvidd, optikbudget eller kompatibilitet. Vald länkhastighet innebär ingen kontroll av att utrustningen stöder den.
| Grupp | Vad du registrerar | Praktisk kontroll utanför appen |
|---|---|---|
| Fiberklasser | OS1, OS2, OM1, OM2, OM3, OM4, OM5 eller Annat | Läs verklig kabelmärkning och installationsunderlag; välj rätt klass för vald optik. |
| Koppar/RJ45 | Cat5e, Cat6, Cat6A, Cat7, Cat8 eller Annat | Registrera kabelns faktiska kategori och terminering. Ett menyval är inget certifieringsresultat. |
| DAC | Medium DAC, längd, SFP+ DAC eller QSFP DAC; DAC passiv/aktiv som modultyp | Notera kabelns artikelnummer i respektive modellfält och kontrollera stöd i båda ändpunkter. |
| AOC | Medium AOC, längd och modultyp AOC | Dokumentera den färdiga kabelns modell och portformat i modell-/kommentarsfälten. |
| Kontaktdon | LC/UPC, LC/APC, SC/UPC, SC/APC, MPO/MTP, RJ45, SFP+ DAC, QSFP DAC, Annat eller — | Registrera varje ände separat. Bekräfta kontakttyp och polaritet mot faktisk installation. |
| SFP-familjer | SFP 1G SX/LX; SFP+ 10G SR/LR/LRM/ER; SFP28 25G SR/LR | Välj typ och skriv exakt fabrikat/artikelnummer separat för A och B. |
| QSFP-familjer | QSFP+ 40G SR4; QSFP28 100G SR4/LR4 | Kontrollera vald modul, portläge och kabelsystem mot hårdvarans dokumentation. |
| Övriga moduler | 10GBASE-T SFP+, DAC passiv, DAC aktiv, AOC eller Annat (beskriv i modellfält) | Använd Annat om den exakta typen saknas; beskriv den i modellfältet. |
Rekommenderad arbetsrutin: Behandla hastighet, fiberklass, kontakt och modultyp som separata uppgifter. Fyll inte i fiberklass för en vanlig kopparlänk. Använd — för modul när porten är inbyggd RJ45. Kontrollera leverantörens kompatibilitetsunderlag inför inkoppling; guiden är ingen dimensioneringstabell.
Exemplens mätresultat är fiktiva och visar hur ett utfört test kan dokumenteras. Kopiera dem aldrig som resultat för en oprövad länk. Börja med Planerad, byt till Installerad efter patchning och först till Verifierad efter verklig kontroll.
Exempel 1 – Fiber mellan switch och storage
| Parameter | Exempelvärde |
|---|---|
| Kabel-ID | DC1-FO-0027 |
| A-enhet / port | SW-LEAF01 / Eth1/49 |
| B-enhet / port | NAS-01 / SFP1 |
| Medium | Fiber |
| Fibertyp | OS2 |
| Kontakter | LC/UPC i båda ändar |
| Optik | SFP+ 10G LR i båda ändar |
| Hastighet | 10G |
| Status | Verifierad när test klarats |
| Testresultat | Länk 10G up; inga CRC-fel; optikvärden enligt bilaga |
Exempelvärdena illustrerar dokumentationsformatet; faktisk kompatibilitet och optikbudget ska kontrolleras mot vald hårdvara.
Exempel 2 – Koppar mellan switch och ESXi-host
| Parameter | Exempelvärde |
|---|---|
| Kabel-ID | DC1-CU-0104 |
| A-enhet / port | SW-ACCESS02 / Port 7 |
| B-enhet / port | ESXI-03 / vmnic1 |
| Medium | Koppar / RJ45 |
| Kabeltyp | Cat6A |
| Kontakt | RJ45 i båda ändar |
| Optik/modul | — där vanlig RJ45 används |
| Hastighet | 2.5G |
| Testresultat | 2.5G full duplex, felräknare 0 |
Exempel 3 – DAC mellan två switchar
| Parameter | Exempelvärde |
|---|---|
| Kabel-ID | DC1-DAC-0008 |
| Från / till | SW-AGG01 SFP+ 1 → SW-LEAF02 SFP+ 49 |
| Medium | DAC |
| Kontakt och modul | SFP+ DAC, passiv/aktiv enligt faktiskt kablage |
| Längd | 1 m |
| Hastighet | 10G |
| Testresultat | Länk up 10G, inga portfel |
7. Checklistan – 13 fördefinierade aktiviteter
Verktyget levereras med följande checklista. Varje aktivitet kan markeras klar, kompletteras med kommentar och få bilagor:
Förberedelse
- Definiera omfattning, ansvar och eventuell avbrottstid.
- Inventera befintliga portar och anslutningar.
- Fotografera nuvarande installation före ändring.
Märkning
- Märk båda ändarna av samtliga berörda kablar.
- Kontrollera kabel-ID mot dokumenterad portlista.
Installation
- Verifiera typ och kompatibilitet för transceivrar.
- Kontrollera fiberklass, patchkablage och kontaktdon.
- Installera och patcha förbindelser enligt plan.
Verifiering
- Kontrollera fysisk länkhastighet och felräknare.
- Verifiera host- och storageanslutningar.
- Dokumentera testresultat samt eventuella avvikelser.
Överlämning
- Ta foton av färdig installation och stäm av märklappar.
- Exportera projektbackup och spara slutlig märklista.
Du kan lägga till egna aktiviteter via Checklista → Ny aktivitet, exempelvis Godkännande från driftansvarig, Kontroll av redundanta vägar eller Återställningstest. Vid avprickning sparas en tidsstämpel. Avprickningen är en manuell arbetsmarkering och ingen automatisk verifiering.
8. Bilder och dokument som bevismaterial
För en kabel väljer du Detaljer, för en enhet Öppna och för en aktivitet Dokumentera. I detaljvyn lägger du till kommentarer och bilagor. Det går att välja filer, dra och släppa filer och klistra in skärmbilder med Ctrl+V i detaljvyn.
Stödda användningsfall: fotografier av rack och kabelmärkning, skärmbilder på portstatus, optikvärden och testresultat, PDF-protokoll, text/loggar, CSV, JSON, XML, YAML och vanliga konfigurationsutdrag. En fil kan vara högst 20 MB; flera bilagor kan kopplas till samma post inom webbläsarens lagringskapacitet.
Skriv en bildtext som berättar vad bilden visar, vilken enhet/kabel/port som avses och när bilden togs. Exempel: 2026-10-09 – DC1-SW-LEAF01 Eth1/49 – 10G LR, link up.
Publiceringssäkerhet: Skärmbilder kan innehålla IP-adresser, DNS-namn, serienummer, interna topologier, kontouppgifter och andra skyddsvärda data. Maskera eller uteslut känslig information innan material delas utanför den behöriga gruppen. Lägg aldrig lösenord, privata nycklar eller hemliga tokens i dokumentationsfält eller bilagor.
9. Topologikartan
När enheter och kablar registrerats skapas automatiskt en schematisk nätverkskarta under Kablage & förbindelser. Enheterna grupperas efter plats och linjer visar dokumenterade förbindelser. Färgen särskiljer fiber/AOC, koppar/RJ45, DAC, övrigt samt avvikelse. Kartan kan exporteras som PNG eller SVG.
Kartans syfte är att ge snabb överblick över dokumenterade ändpunkter. Den är inte en skalenlig kabelritning, visar inte automatiskt exakta rackpositioner, fysisk kabelstege eller alla mellanliggande patchsektioner som inte dokumenterats separat.
10. Sökning och kvalitetskontroll
- Sök i utrustningsregistret på namn, modell, kategori och rack.
- Sök i kabelregistret på kabel-ID, port, ändpunkt, optik och kabelväg.
- Filtrera förbindelser efter status:
Planerad,Installerad,Verifierad,Avvikelse,Ur drift. - Översikten visar antal registrerade enheter, förbindelser, verifierade förbindelser och avklarade checklistesteg.
- Kvalitetsindikatorer uppmärksammar ofullständig kabelmärkning och saknad port i någon ände.
- Dubbletter av kabel-ID stoppas. Om en port redan förekommer på en annan förbindelse visas en varning som kan godkännas. Detta är inte en garanti mot alla felaktiga kabeldragningar.
11. Export, backup och återläsning – mycket viktigt
| Export | Vad ingår? | Typisk användning |
|---|---|---|
| Fullständig ZIP-backup | data/projekt.json, register som CSV och alla originalbilagor i separata kataloger | Arkivering, flytt och återställning |
| JSON | Projektets strukturerade uppgifter och referenser, inte själva bilagefilerna | Maskinell vidarebearbetning och versionshantering |
| Kabellista CSV | Dokumenterade förbindelser | Excel och teknisk överlämning |
| Märklista CSV | Två märkningsrader per kabel, A- och B-ände | Märksystem och fysisk uppmärkning |
| Utrustning CSV | Register över enheter | Inventering och kompletterande dokumentation |
| Topologi PNG / SVG | Schematisk karta | Guide, arbetsorder och dokumentationsbilaga |
CSV-filerna använder semikolon och UTF-8 med BOM för att fungera väl i svensk Excel-miljö.
Skillnad mellan två ZIP-filer:
- Installations-ZIP: Den distribuerade applikationen med
index.html,assets/och eventuellt demoexempel. Behåll detta paket. - Projektbackup-ZIP: Skapas när du väljer Exportera fullständig ZIP inne i applikationen. Innehåller aktuellt projekts data, register och bilagor, men inte själva applikationsfilerna.
Säkerhetskopiering – föreslagen rutin
- Gör en komplett ZIP-export före en större omkoppling.
- Gör en ny backup efter varje avslutad arbetsetapp.
- Gör en slutlig exporterad ZIP vid överlämning.
- Förvara exporter i ett behörighetsstyrt arkiv med versions-/datuminformation.
- Testa återimport av en kopia innan kritiska originaldata tas bort.
Import och återställning
Öppna Export & backup → Importera ZIP / JSON. Endast projekt-ZIP som verktyget självt skapat stöds för direkt ZIP-import. Importen ersätter det aktuella projektet, inklusive tidigare bilagor. Exportera därför en backup innan du importerar demo eller ett annat projekt.
Viktig detalj: Verktygets ZIP-format är okomprimerat (ZIP store). Om någon packar upp och sedan omkomprimerar backupen med en annan ZIP-metod kan återimport misslyckas. Använd originalexporten för återställning.
Återställ steg för steg
- Exportera det aktuella projektet som fullständig ZIP innan du byter projekt.
- Välj Importera ZIP / JSON och öppna den orörda projektbackupen. CSV, PNG och SVG kan inte importeras som projekt.
- Läs bekräftelsen med projektnamnet: befintliga data och bilagor ersätts. Godkänn först när din nuvarande backup är sparad.
- Kontrollera projektnamn, revision, antal enheter och förbindelser. Öppna några bilagor och kontrollera att de följt med.
- Exportera en ny fullständig ZIP efter att återställningen verifierats.
JSON-import återställer strukturerade uppgifter men inte bilagornas innehåll, och ersätter också den tidigare lokala bilagelagringen. Importera inte JSON som ersättning för en fullständig återställning. Demofilen under exempel/ importeras med samma knapp och ersätter även den det aktuella projektet.
Starta nytt projekt
Via Export & backup → Starta nytt projekt kan användaren rensa registrerad information och börja om. Detta raderar den aktuella lokala projektinformationen och bilagorna från den webbläsarprofilen; gör först en fullständig backup. Efter bekräftelsen måste du skriva NYTT för att genomföra rensningen.
12. Lagring, integritet och samarbete
- Projektets strukturerade data sparas i webbläsarens localStorage.
- Bilagor lagras i IndexedDB i samma profil/ursprung.
- Uppgifterna skrivs inte automatiskt tillbaka till
index.htmleller programmappen. - Ingen extern molnlagring ingår och ingen inloggning behövs.
- Om webbläsardata rensas, profilen byts eller lagringskvoten överskrids kan lokala projektdata gå förlorade.
- Projektet är inte byggt för samtidig redigering av flera personer; olika datorer/profiler får separata kopior. Samordna genom bestämd projektägare och importerade/exporterade backupversioner.
- Programmet gör ingen automatisk versionskonflikthantering, behörighetsadministration eller kryptering av exporterade filer.
- Skydda projektbackuper och konfigurera behörigheter i det system där filerna lagras.
13. Vanliga frågor och felsökning
Sidan öppnas, men mina uppgifter finns inte kvar. Kontrollera att du använder samma dator, webbläsarprofil och öppningsadress. Projekt lagras lokalt, inte inuti HTML-filen. Importera sparad projekt-ZIP om du bytt miljö.
Det går inte att lägga till bilder. Prova Edge/Chrome och kontrollera om IndexedDB är tillgängligt. Öppna vid behov sidan via http://127.0.0.1:8000 som ovan. Exportera från eventuellt tidigare ursprung innan byte.
Topologin är tom. Lägg först till minst två enheter och en förbindelse mellan dem.
Jag får varning om upptagen port. Kontrollera om porten redan är upptagen av en dokumenterad länk. Varningen kan godkännas, så den kräver teknisk granskning.
En kabel saknas i märklistan. Kontrollera att posten sparats under Kablage & förbindelser och att ett giltigt kabel-ID finns.
Import av ZIP misslyckas. Använd ett orört projektbackup-ZIP skapat av samma applikation. Ett godtyckligt ZIP-arkiv, installationspaketet eller en ompackad backup stöds inte som projektimport.
Projektet behöver delas mellan två tekniker. Bestäm vem som gör uppdateringar i originalet. Exportera och överlämna projektpaketet vid övergång; parallella ändringar går inte automatiskt ihop.
14. Exempel på godkännandekriterier vid hall-dragning
En förbindelse kan betraktas som dokumentationsmässigt godkänd när:
Observera: Det är ett rekommenderat arbetssätt för denna guide, inte en automatisk godkännandekontroll i appen eller en ersättning för organisationens formella mottagningskontroll.
15. Rekommenderad dokumentation att överlämna
Vid färdigt projekt kan projektledaren överlämna:
- Reviderad kabel- och märkningslista (
CSV). - Utrustningsregister (
CSV). - Schematisk fysisk topologi (
PNGellerSVG). - Komplett projektbackup (
ZIP) med registrerade bilagor. - Eventuella certifieringsrapporter från externa mätinstrument.
- En sammanfattning av öppna avvikelser och vem som ansvarar för dem.
Undvik att publicera fullständiga interna produktionsregister öppet. Skärmbilder och demoexempel som delas offentligt ska innehålla endast fiktiva uppgifter.
16. Checklista för slutleverans
Rekommenderad arbetsrutin – bockas av av projektets ansvariga. Rutorna är ett lässtöd på den här guidesidan och sparas inte när sidan laddas om. Registrera projektets utförda kontroller i appens egen checklista.
17. Underlag och versionsgräns
Guiden gäller Network Project v1.0.1 i det medföljande installationspaketet. Huvudkälla är det bifogade masterdokumentet; menyer, fält, validering, lagring, bilagor, export och import har kontrollerats mot originalets index.html och assets/app.js. Skärmbilderna visar den uppdaterade appen v1.0.1 med en tom projektmall. Version 1.0.1 ändrar profilering och skaparinformation; projektformat, lagringsnycklar och dokumentationsfunktioner är oförändrade från v1.0. Revidera guiden när applikationen ändras.
