Service: {SERVICE_NAME}
Role: {SERVICE_ROLE}
Version: {VERSION}
Environment: {ENVIRONMENT}
Status: ✓ ONLINE
Uptime: {get_uptime_seconds()} seconds
$ curl https://{SERVICE_ROLE}.blackroad.systems/health
{{"status": "healthy", "service": "{SERVICE_ROLE}", "version": "{VERSION}"}}
$ curl https://{SERVICE_ROLE}.blackroad.systems/version
{{"version": "{VERSION}", "commit": "{COMMIT}", "environment": "{ENVIRONMENT}"}}
""")
@app.get("/health")
async def health_check():
"""
Basic health check endpoint (Required by Railway and syscall API).
Returns 200 OK if service is healthy.
"""
uptime = get_uptime_seconds()
return JSONResponse(
status_code=200,
content={
"status": "healthy",
"service": SERVICE_ROLE,
"version": VERSION,
"commit": COMMIT,
"environment": ENVIRONMENT,
"timestamp": datetime.utcnow().isoformat() + "Z",
"uptime_seconds": uptime
}
)
@app.get("/version")
async def version_info():
"""
Version information endpoint (Required by syscall API).
Returns detailed version and build information.
"""
return {
"version": VERSION,
"service": SERVICE_NAME,
"role": SERVICE_ROLE,
"commit": COMMIT,
"environment": ENVIRONMENT,
"buildTime": os.getenv("BUILD_TIME", "unknown"),
"pythonVersion": platform.python_version(),
"deployment": {
"platform": "Railway",
"region": os.getenv("RAILWAY_REGION", "unknown"),
"serviceId": os.getenv("RAILWAY_SERVICE_ID", "unknown"),
"deploymentId": os.getenv("RAILWAY_DEPLOYMENT_ID", "unknown"),
"staticUrl": os.getenv("RAILWAY_STATIC_URL", "unknown")
}
}
# ============================================================================
# SYSCALL API ENDPOINTS (BlackRoad OS Standard)
# ============================================================================
@app.get("/v1/sys/identity")
async def sys_identity():
"""
Get complete service identity (syscall API).
Returns full identity object including DNS, runtime, and health info.
"""
return get_identity()
@app.get("/v1/sys/health")
async def sys_health():
"""
Detailed health check with extended metrics (syscall API).
Returns comprehensive health information.
"""
uptime = get_uptime_seconds()
return {
"status": "healthy",
"timestamp": datetime.utcnow().isoformat() + "Z",
"uptime": uptime,
"memory": {
"rss": 0, # TODO: Add actual memory metrics
"heapTotal": 0,
"heapUsed": 0,
"external": 0
},
"checks": {
"self": {
"status": "ok",
"message": "Service is running"
},
# Add more health checks here (database, redis, etc.)
},
"service": {
"name": SERVICE_NAME,
"role": SERVICE_ROLE,
"version": VERSION
}
}
@app.get("/v1/sys/version")
async def sys_version():
"""
Extended version information (syscall API).
Returns comprehensive version and build details.
"""
return version_info()
@app.get("/v1/sys/config")
async def sys_config():
"""
Get non-sensitive service configuration (syscall API).
Returns partial config without secrets.
"""
return {
"service": {
"name": SERVICE_NAME,
"role": SERVICE_ROLE,
"version": VERSION,
"environment": ENVIRONMENT,
"port": int(os.getenv("PORT", 8000))
},
"features": {
"http": True,
"static": True,
"rpc": False, # Not implemented in minimal template
"events": False, # Not implemented in minimal template
"jobs": False, # Not implemented in minimal template
"state": False # Not implemented in minimal template
},
"cors": {
"enabled": True,
"allowedOrigins": ALLOWED_ORIGINS
}
}
# ============================================================================
# ERROR HANDLERS
# ============================================================================
@app.exception_handler(404)
async def not_found_handler(request: Request, exc):
"""Custom 404 handler"""
return JSONResponse(
status_code=404,
content={
"error": "Not Found",
"path": str(request.url.path),
"message": "The requested resource was not found",
"service": SERVICE_NAME,
"suggestion": "Try /health, /version, or /v1/sys/identity"
}
)
@app.exception_handler(500)
async def internal_error_handler(request: Request, exc):
"""Custom 500 handler"""
return JSONResponse(
status_code=500,
content={
"error": "Internal Server Error",
"message": "An unexpected error occurred",
"service": SERVICE_NAME
}
)
# ============================================================================
# STARTUP
# ============================================================================
@app.on_event("startup")
async def startup_event():
"""Runs on application startup"""
print(f"🛣️ Starting {SERVICE_NAME}...")
print(f" Role: {SERVICE_ROLE}")
print(f" Version: {VERSION}")
print(f" Environment: {ENVIRONMENT}")
print(f" Port: {os.getenv('PORT', 8000)}")
print(f"✓ Service is ready!")
@app.on_event("shutdown")
async def shutdown_event():
"""Runs on application shutdown"""
print(f"Shutting down {SERVICE_NAME}...")
print("✓ Shutdown complete")
# ============================================================================
# MAIN (for local development)
# ============================================================================
if __name__ == "__main__":
import uvicorn
port = int(os.getenv("PORT", 8000))
reload = ENVIRONMENT == "development"
print(f"\n{'='*60}")
print(f"BlackRoad OS - {SERVICE_ROLE.title()} Service")
print(f"{'='*60}")
print(f"Service: {SERVICE_NAME}")
print(f"Version: {VERSION}")
print(f"Environment: {ENVIRONMENT}")
print(f"Port: {port}")
print(f"Reload: {reload}")
print(f"{'='*60}\n")
uvicorn.run(
"main:app",
host="0.0.0.0",
port=port,
reload=reload,
log_level="info"
)