{"id":30142153,"url":"https://github.com/local-connectivity-lab/ccn-coverage-vis","last_synced_at":"2025-08-11T05:41:38.399Z","repository":{"id":45033273,"uuid":"354215594","full_name":"Local-Connectivity-Lab/ccn-coverage-vis","owner":"Local-Connectivity-Lab","description":"Visualizations of coverage and performance analysis for Community Cellular Networks.","archived":false,"fork":false,"pushed_at":"2025-08-08T23:12:10.000Z","size":22665,"stargazers_count":2,"open_issues_count":2,"forks_count":4,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-08-09T01:07:43.449Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/Local-Connectivity-Lab.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2021-04-03T06:13:12.000Z","updated_at":"2025-05-23T19:40:49.000Z","dependencies_parsed_at":"2023-02-10T05:45:30.864Z","dependency_job_id":"b73fde92-16dd-426a-b434-b5a27dc94d90","html_url":"https://github.com/Local-Connectivity-Lab/ccn-coverage-vis","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Local-Connectivity-Lab/ccn-coverage-vis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Local-Connectivity-Lab%2Fccn-coverage-vis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Local-Connectivity-Lab%2Fccn-coverage-vis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Local-Connectivity-Lab%2Fccn-coverage-vis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Local-Connectivity-Lab%2Fccn-coverage-vis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Local-Connectivity-Lab","download_url":"https://codeload.github.com/Local-Connectivity-Lab/ccn-coverage-vis/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Local-Connectivity-Lab%2Fccn-coverage-vis/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269837870,"owners_count":24483181,"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","status":"online","status_checked_at":"2025-08-11T02:00:10.019Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":"2025-08-11T05:41:37.276Z","updated_at":"2025-08-11T05:41:38.354Z","avatar_url":"https://github.com/Local-Connectivity-Lab.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ccn-coverage-vis\n\nVisualizations of coverage and performance analysis for Community Cellular Networks.\n\nNow hosted on https://coverage.seattlecommunitynetwork.org/\n\n\n## Initial Setup\nTo install this service, the fist time, you will need to:\n\n1. Required tools and versions:\n    1. Install `node` and `npm` according to the directions at https://nodejs.org/en/download/package-manager \n    2. `make` and `docker` are used for local development\n2. Clone the service: `https://github.com/Local-Connectivity-Lab/ccn-coverage-vis` \n3. Configure:\n    1. `cd cd ccn-coverage-vis`     \n    1. Edit `src/utils/config.ts` and set the correct URL for your API host (if you're testing or you're deploying to a new URL).\n\n## Development\nAvoid committing your change directly to the `main` branch. Check out your own private branch for your development and submit a pull request when the feature/bug fix/cleanup is ready for review. Follow the [Angular Commit Message Conventions](https://github.com/angular/angular/blob/main/contributing-docs/commit-message-guidelines.md) for your commit message. Versions will be managed based on those commit messages. \n\n## Troubleshooting \u0026 Recovery\nWhen a problem occurs, there are several checks to determine where the failure is:\n1. Check HTTP errors in the browser\n1. Login to the coverage-host\n2. Confirm ccn-coverage-vis is operating as expected\n3. Confirm nginx is operating as expected\n\n### Checking HTTP errors in the browser\nFirst, open your browser and go to: https://coverage.seattlecommunitynetwork.org/\n\nIs it working?\n\nIf not, open up the browser **Web Developer Tools**, usually under the menu Tools \u003e Developer Tools \u003e Web Developer Tools.\n\nWith this panel open at the bottom of the screen select the **Network** tab and refresh the browser page.\n\nLook in the first column, Status:\n* `200`: OK, everything is good.\n* `502`: Error with the backend services (behind nginx)\n* `500` errors: problem with nxginx. Look in `/var/log/nginx/error.log` for details.\n* `400` errors: problem with the service. Check the service logs and nginx logs.\n* Timeout or unreachable error: Something is broken in the network between your web browser and the coverage-vis host.\n\n\n### Checking nginx\nIf there appear problems with nginx, then check that the \n\nCheck service operation:\n```\nsystemctl status nginx\n```\n\nCheck nginx logs:\n```\nsudo tail /var/log/nginx/error.log\n```\n\nSources of errors might include nginx configuration in `/etc/nginx/conf.d/01-ccn-coverage.conf`\n\nIf you need to restart nginx, use: \n```\nsudo systemctl restart nginx\n```\n\n### Clean Recovery\nIf nothing else works, the last option is a clean reinstall of the service. The process is:\n* Remove the `ccn-coverage-vis` directory.\n* Re-install as per **Initial Setup**.\n\n\n## Testing\n\nWe provide a docker compose environment for local testing. Run `docker compose up -d`, and the web server will be running on your local host at port `443`.\n\n\n# Issues\n\n- Chart doesn't show tooltips.\n\n# TODOs\n\n- Toggle graph view off results in no toggle-on button\n- Make the chart more informative\n  - Hover on a line should show the exact data and which sites are they from\n- Admin Panel\n  - Edit Button\n  - Toggle Active\n- Better compatibility with local development\n\n## Contributing\nAny contribution and pull requests are welcome! However, before you plan to implement some features or try to fix an uncertain issue, it is recommended to open a discussion first. You can also join our [Discord channel](https://discord.com/invite/gn4DKF83bP), or visit our [website](https://seattlecommunitynetwork.org/).\n\n## License\nccn-coverage-vis is released under Apache License. See [LICENSE](/LICENSE) for more details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocal-connectivity-lab%2Fccn-coverage-vis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flocal-connectivity-lab%2Fccn-coverage-vis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocal-connectivity-lab%2Fccn-coverage-vis/lists"}