RAILWISE-OS Deployment Guide

RAILWISE-OS Deployment Guide

Estimated Reading Time: 20 minutes
Goal: Deploy RAILWISE-OS monitoring business operating system and integrate with TSM platform

---

1. Product Overview

RAILWISE-OS (Operating System) is RailWise’s monitoring business operating system built on Vue3 / Java / Python. It covers the full monitoring business lifecycle: project management, client collaboration, report delivery, personnel scheduling, and equipment management.

1.1 Core Modules

Module	Function	Tech Stack
Project Management	Project creation, lifecycle tracking, contract management	Vue3 + Spring Boot
Monitoring Data	Data query, chart viewing, alert handling	Vue3 + ECharts
Report Center	Report template management, auto-generation, approval workflow	Vue3 + Python (Jinja2)
Client Portal	Client data access, report download, alert notification	Vue3 + WebSocket
Equipment Management	Instrument inventory, calibration tracking, maintenance scheduling	Java + PostgreSQL
Personnel Management	Staff scheduling, task assignment, performance tracking	Java + Redis

---

2. Deployment Architecture

┌─────────────────────────────────────────────────────────────┐
│                    RAILWISE-OS Frontend (Vue3)              │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐       │
│  │ Project  │ │ Monitoring│ │ Report   │ │ Client   │       │
│  │ Mgmt     │ │ Data     │ │ Center   │ │ Portal   │       │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘       │
└─────────────────────────────────────────────────────────────┘
                              │ REST API
┌─────────────────────────────────────────────────────────────┐
│                    RAILWISE-OS Backend (Java)               │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐       │
│  │ Project  │ │ Report   │ │ User     │ │ Equipment│       │
│  │ Service  │ │ Service  │ │ Service  │ │ Service  │       │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘       │
└─────────────────────────────────────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        ▼                     ▼                     ▼
   ┌──────────┐        ┌──────────┐        ┌──────────┐
   │PostgreSQL│        │  Redis   │        │  MinIO   │
   │ (Main DB)│        │ (Cache)  │        │ (Files)  │
   └──────────┘        └──────────┘        └──────────┘
                              │
                              ▼
                    ┌──────────────────┐
                    │ RAILWISE-TSM    │
                    │ (Data Source)    │
                    └──────────────────┘

---

3. System Requirements

Environment	CPU	Memory	Disk	OS
Development	4 cores	8 GB	50 GB	Ubuntu 22.04 / macOS 14
Production	8 cores	16 GB	200 GB SSD	Ubuntu 22.04 LTS
High Availability	16 cores	32 GB	500 GB SSD	Ubuntu 22.04 LTS + K8s

---

4. Installation Steps

4.1 Prerequisites

# Install Java 17
sudo apt update
sudo apt install openjdk-17-jdk

# Install Node.js 20
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# Install Python 3.11
sudo apt install python3.11 python3.11-venv python3.11-pip

# Install PostgreSQL 15
sudo apt install postgresql-15 postgresql-client-15

# Install Redis 7
sudo apt install redis-server

4.2 Database Setup

# Create database
sudo -u postgres psql -c "CREATE DATABASE railwise_os;"
sudo -u postgres psql -c "CREATE USER railwise WITH PASSWORD \'your_password\';"
sudo -u postgres psql -c "GRANT ALL PRIVILEGES ON DATABASE railwise_os TO railwise;"

# Run initialization scripts
cd backend/sql
psql -U railwise -d railwise_os -f init_schema.sql
psql -U railwise -d railwise_os -f init_data.sql

4.3 Backend Deployment

cd backend
./mvnw clean package -DskipTests

# Run
java -jar target/railwise-os-1.0.0.jar   --spring.profiles.active=prod   --server.port=8080

4.4 Frontend Deployment

cd frontend
npm install
npm run build

# Serve with nginx or any static server
# Or use built-in preview
npm run preview -- --port 80 --host

4.5 Python Report Service

cd report-service
python3.11 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Start service
python app.py --port 5000

---

5. TSM Integration

Configure TSM connection in backend/src/main/resources/application-prod.yml:

railwise:
  tsm:
    enabled: true
    base-url: https://tsm.railwise.cn
    api-key: ${TSM_API_KEY}
    sync-interval: 300  # seconds
    projects:
      sync-enabled: true
      auto-create: false
    data:
      sync-enabled: true
      alert-forward: true

---

6. Common Operations

Operation	Command
Start backend	java -jar railwise-os.jar
Start frontend	npm run preview or nginx
Start report service	python app.py
View logs	tail -f logs/application.log
Database backup	pg_dump railwise_os > backup.sql

---

Metadata Tags

---

Last updated: 2026-07-08 | Version v1.0.0 | © Ningbo RailWise Engineering Technology Co., Ltd.