feat: initial itpp-docs setup with MkDocs Material
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:
Germaine Brown
2026-08-09 23:49:45 -04:00
parent 08ba2e62a8
commit 98073dc636
134 changed files with 55534 additions and 2 deletions
+42
View File
@@ -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