# Transit Project

XTransit is a service-oriented transit platform consisting of Node.js APIs, React operator interfaces, and retained legacy clients.

## Quick Map

- `auth_api/` - authentication and JWT issuance
- `employee_api/` - employee management
- `transit_api/` - schedules, routes, fleet, GPS, and transit administration
- `error_log_api/` - centralized error collection and protected log access
- `admin_ui/` - React administration console
- `monitoring_ui/` - React service monitoring dashboard
- `deprecated/` and `windows_xp_driver_ui/` - retained legacy clients

Public employee API: `https://employees.xtransit.testinstance.nl`

## Documentation

Start with the [documentation hub](docs/README.md).

- [Project guide](docs/PROJECT_GUIDE.md) - setup, architecture, environment, Docker, deployment, databases, and troubleshooting
- [Monitoring UI guide](docs/MONITORING_UI.md) - complete `monitoring_ui` operations and development manual
- [Domains](DOMAINS_README.md) - public domain and service mapping
- [Docker notes](DOCKER_README.md) - container workflow
- [Deployment guide](DEPLOYMENT.md) - deployment procedures
- [CI/CD and Portainer guide](CI_CD_PORTAINER_GUIDE.md) - image and stack operations

## Quick Start

For the deployed service stack:

```bash
docker compose --env-file .env up -d
```

For the monitoring dashboard:

```bash
cd monitoring_ui
npm install
npm run dev
```

Keep database credentials, JWT secrets, registry credentials, and tokens outside version control. Use environment variables, ignored local files, Portainer secrets, or another secret manager.