{"id":22610467,"url":"https://github.com/specure/ont-public-portal","last_synced_at":"2025-07-18T00:07:02.653Z","repository":{"id":162080783,"uuid":"635338364","full_name":"specure/ont-public-portal","owner":"specure","description":"Source code of the Open Nettest Public Portal","archived":false,"fork":false,"pushed_at":"2025-07-16T08:57:33.000Z","size":2249,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-17T12:11:56.238Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://nettest.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/specure.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-05-02T13:34:45.000Z","updated_at":"2025-07-16T08:57:36.000Z","dependencies_parsed_at":null,"dependency_job_id":"30580be3-e551-4279-b6c1-38bfc2c4c24f","html_url":"https://github.com/specure/ont-public-portal","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/specure/ont-public-portal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specure%2Font-public-portal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specure%2Font-public-portal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specure%2Font-public-portal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specure%2Font-public-portal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/specure","download_url":"https://codeload.github.com/specure/ont-public-portal/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specure%2Font-public-portal/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265683301,"owners_count":23810827,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-08T16:07:01.171Z","updated_at":"2025-07-18T00:07:02.633Z","avatar_url":"https://github.com/specure.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Open Nettest Public Portal\n\n## Setup\n\nThe folder `config` is meant to contain files specific for different flavors, such as images, styles, templates. `config/\u003cYOUR_FLAVOR\u003e/environments` folder is meant to contain `*.json` files with settings for various environments, e.g. dev, beta, etc. You can set there the URLs of your control server and CMS, Mapbox IDs and so on. `config/nettest/environments` contains an example `environment.json`, which will be used when running the app in the debug mode.\n\nTo configure the project for a certain flavor run:\n\n```\n    npm run configure -- \u003cYOUR_FLAVOR\u003e\n```\n\n## Running\n\nThe portal depends on the control server for running tests and keeping history of results. Its code is published separately at https://github.com/specure.\n\nThe portal uses a CMS to display such things as menus and texts. Any headless CMS can be used for this purpose (e.g. Strapi or Wordpress with the headless plugin), as long as its responses are formatted correctly. The folder `examples/api` contains a simple server, providing example responses for some of the CMS endpoints used by the portal. You can run this server by calling:\n\n```\n    node examples/api\n```\n\nAll the endpoints used by the portal are listed in the `config/nettest/environments/environment.ts` under `cms.routes` and `controlServer.routes` sections.\n\nThe portal uses Mapbox to display the map with the measurement data. See https://docs.mapbox.com/studio-manual/guides/ and https://docs.mapbox.com/mapbox-gl-js/guides/ for the official documentation. HERE API is also used, for search and geocoding, https://developer.here.com/documentation/geocoding-search-api/dev_guide/index.html. The section `map` in the `config/nettest/environments/environment.ts` contains all the required settings.\n\nTo run the app itself in the debug mode call:\n\n```\n    npm run start\n```\n\n`npm run start-stage` and `npm run start-prod` are also available.\n\n## Building\n\nTo build the app for production use:\n\n```\n    npm run build-prod\n```\n\n`npm run build-dev` is also available.\n\n## Pre-rendering\n\nTo pre-render pages, to serve them statically later, you can specify their routes in `config/\u003cYOUR_FLAVOR\u003e/prerender-routes.txt`, then run:\n\n```\n    npm run configure -- \u003cYOUR_FLAVOR\u003e \u0026\u0026 npm run prerender:prod\n```\n\n`npm run prerender:dev` and `npm run prerender:beta` are also available.\n\n## Testing\n\nYou have to set up the portal with the control server, the CMS, and the map before running tests. Once it's done, start the app and launch:\n\n```\n    npm run configure-playwright-dev\n```\n\nin parallel, to configure the environment for the test suite. Then use:\n\n```\n    npm run test\n```\n\nor\n\n```\n    npm run test-headless\n```\n\nto run all the avaialable tests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspecure%2Font-public-portal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspecure%2Font-public-portal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspecure%2Font-public-portal/lists"}