feat: initial itpp-docs setup with MkDocs Material
Publish Docs Site / build (push) Failing after 5s
Publish Docs Site / build (push) Failing after 5s
- mkdocs.yml with dark slate theme, nav for 12 ITPP projects - build-docs.sh aggregates docs from all project repos - .gitea/workflows/docs-publish.yml for nightly rebuild+deploy - README and CHANGELOG for the itpp-docs repo itself - docs-source/ populated from all 12 repos - site/ ready for deployment to docs.itpropartner.com
This commit is contained in:
@@ -0,0 +1,42 @@
|
||||
# transitpin
|
||||
|
||||
|
||||
> **Owner:** Germaine | **Status:** LIVE (dev)
|
||||
> **Last Updated:** 2026-08-09
|
||||
|
||||
TransitPin is a real-time student transportation tracking SaaS built for the private contractor market — the companies school districts hire to move students. It replaces paper route sheets, manual parent texts, and clipboards with a live GPS platform: driver PWA, parent ETA portal, bell-schedule intelligence, and an admin dashboard for owners.
|
||||
|
||||
Built from a direct client engagement with Village Express Transportation (Savannah, GA).
|
||||
|
||||
## Access
|
||||
|
||||
| Resource | URL | Location | Notes |
|
||||
|---|---|---|---|
|
||||
| Parent Portal | https://villageexpress.transitpin.com/ | Core (152.53.192.33) | Caddy reverse proxy |
|
||||
| Driver PWA | https://villageexpress.transitpin.com/driver.html | Core | WebSocket at /ws/driver* |
|
||||
| Admin Dashboard | https://villageexpress.transitpin.com/admin.html | Core | Dispatch map, driver tracking |
|
||||
| WebSocket Relay | port 8210 (localhost) | Core | systemd: village-express.service |
|
||||
|
||||
## Tech Stack
|
||||
|
||||
- Frontend: Vanilla HTML/CSS/JS, Leaflet maps, TomTom traffic tiles
|
||||
- Backend: WebSocket relay (Node.js), systemd service
|
||||
- Reverse Proxy: Caddy (TLS auto-provision)
|
||||
- GPS: Browser `watchPosition` API, Wake Lock API
|
||||
- Data: driver-manifest.json (static routes), PWA manifest
|
||||
|
||||
## Quick Start
|
||||
|
||||
```bash
|
||||
git clone https://git.itpropartner.com/ippadmin/transitpin.git
|
||||
cd transitpin/
|
||||
# Start WebSocket relay
|
||||
sudo systemctl start village-express
|
||||
# Caddy serves static files + proxies /ws/* to WebSocket relay
|
||||
```
|
||||
|
||||
## Related
|
||||
|
||||
- [itpp-infrastructure](https://git.itpropartner.com/ippadmin/itpp-infrastructure) — server inventory, DNS
|
||||
- [itpp-standards](https://git.itpropartner.com/ippadmin/itpp-standards) — docs standards and templates
|
||||
- [transitpin-white-label](https://git.itpropartner.com/ippadmin/transitpin-white-label) — white-label portal builder
|
||||
Reference in New Issue
Block a user