fred.boniface
/
OwlBoard
Archived
1
0
Fork 0
Code Issues Pull Requests Packages Projects 1 Releases Wiki Activity
Backend API & Frontent UI for live departure board for UK Rail.
This repository has been archived on 2023-08-24. You can view files and clone it, but cannot push or open issues or pull requests.
11 Commits 1 Branch 1 Tag 5.6 MiB
JavaScript 59.7%
HTML 24.9%
CSS 13.9%
Shell 1%
Dockerfile 0.5%
Go to file
Fred Boniface 4057b50d08 Update readme and add comments defining 
future features.
 		2022-12-02 12:25:48 +00:00
src Update readme and add comments defining 2022-12-02 12:25:48 +00:00
static General Development 2022-11-30 22:08:27 +00:00
.gitignore Initial commit 2022-11-29 19:28:24 +00:00
LICENSE General Development 2022-11-30 22:08:27 +00:00
README.md Update readme and add comments defining 2022-12-02 12:25:48 +00:00
app.js Various, fairly unproductive 2022-12-01 22:07:20 +00:00
package-lock.json Organised 2022-12-01 13:40:24 +00:00
package.json General Development 2022-11-30 22:08:27 +00:00

README.md

OwlBoard

OwlBoard is the backend API that powers the Athena web application at athena.fb-infra.uk.

Powered by Node.JS and using the ldbs-json module, the OwlBoard API provides up to date train departure information for any station in the UK.

Whilst the application is open source, the webservice (owlboard.fb-infra.uk) is not openly available. National Rail Enquiries have limits on API access so to use this software yourself, you'll need to run your own instance after obtaining your own API key.

WebApp Colours:

  • To be updated

API Endpoints:

  • /api:

    • /test:

      • GET: Check your connection with the server
      • POST: Check your auth key
        • Request Body JSON: {"auth":""}
        • Returns JSON: {"auth":"true/false"}

    • /list:

      • GET: Get list of stations
        • Returns JSON: {"STATION NAME":{"CRS":"code","TIPLOC":"code"}}

    • /ldb:

Stack:

  • app.js -> Launches server, Entry Point, defines routers and middlewares.

    • routes -> Routers - Directs requests to controllers.

      • controllers -> Checks auth, sends response. Request doesn't pass further.
        • services -> Provide data and do tasks, uses other services and utils.

    • utils -> Provide utility functions that can be called by services.

    • configs -> Provide configuration details for other files.

    • static -> Holds files for static service, should be hosted behind a caching proxy.