hyukiody/yo3-platform repository overview

hyukiody/yo3-platform:latest
├── Identity Service (Port 8080)
├── Stream Processing (Port 8081)
├── Data Core (Port 8082)
├── Edge Node (Port 8091)
├── Frontend (Port 5173)
└── Orchestrator (Port 9090)

# Pull latest version
docker pull hyukiody/yo3-platform:latest

# Pull specific commit
docker pull hyukiody/yo3-platform:full-source-744717c

# Pull from Docker Hub
docker pull hyukiody/yo3-platform:latest

# Run unified platform
docker run -d \
  --name yo3-platform \
  -p 5173:5173 \
  -p 8080:8080 \
  -p 8081:8081 \
  -p 8082:8082 \
  -p 8091:8091 \
  -p 9090:9090 \
  hyukiody/yo3-platform:latest

# Access frontend
open http://localhost:5173

# Clone repository
git clone https://github.com/hyukiody/teraApi.git
cd teraApi

# Start all services
docker-compose -f docker-compose.production.yml up -d

# View logs
docker-compose -f docker-compose.production.yml logs -f

# Stop services
docker-compose -f docker-compose.production.yml down

# Build unified container locally
docker build -f Dockerfile.orchestrator -t yo3-platform:local .

# Run local build
docker run -d --name yo3-test -p 5173:5173 yo3-platform:local

# Build all services
mvn clean package -DskipTests

# Build specific module
cd middleware/identity
mvn clean package

# Trigger workflow manually
gh workflow run docker-build-all.yml --ref full-source

teraApi/
├── .github/
│   └── workflows/
│       └── docker-build-all.yml    # CI/CD pipeline
├── middleware/                      # Backend services
│   ├── identity/                   # JWT auth service
│   ├── stream/                     # Video processing
│   ├── data-core/                  # Data persistence
│   ├── edge-node/                  # Edge computing
│   └── pom.xml                     # Parent POM
├── frontend/                        # React application
│   ├── src/                        # TypeScript source
│   └── package.json
├── ops/                            # Operations configs
│   ├── nginx.conf                  # Nginx config
│   └── init-db.sql                 # Database schema
├── Dockerfile.orchestrator         # Unified container build
├── docker-compose.production.yml   # Production deployment
├── pom.xml                         # Root Maven POM
└── README.md                       # This file

# Production environment
SPRING_PROFILES_ACTIVE=production
JAVA_OPTS="-Xmx2G -Xms512M -XX:+UseG1GC"
YO3_LOG_LEVEL=INFO
TZ=UTC

# Database (if using external DB)
DB_HOST=postgres
DB_PORT=5432
DB_NAME=yo3platform
DB_USER=yo3admin
DB_PASSWORD=<secure-password>

# Stage 1: Maven Build (Java Services)
FROM maven:3.9-eclipse-temurin-21
- Builds all 4 middleware services
- Output: JAR files in target/ directories

# Stage 2: Frontend Build (React)
FROM node:20-alpine
- Builds frontend with Vite
- Output: Static files in dist/

# Stage 3: Runtime (Unified Container)
FROM eclipse-temurin:21-jdk-alpine
- Copies JARs from Stage 1
- Copies frontend from Stage 2
- Installs orchestrator scripts
- Creates non-root user
- Exposes all service ports

docker build \
  --build-arg BUILD_DATE=$(date -u +"%Y-%m-%dT%H:%M:%SZ") \
  --build-arg VCS_REF=$(git rev-parse --short HEAD) \
  --build-arg VERSION=1.0.0 \
  -f Dockerfile.orchestrator \
  -t hyukiody/yo3-platform:latest \
  .

# Check container health
docker inspect yo3-platform | jq '.[0].State.Health'

# Test individual services
curl http://localhost:8080/actuator/health  # Identity
curl http://localhost:8081/actuator/health  # Stream
curl http://localhost:8082/actuator/health  # Data Core
curl http://localhost:8091/actuator/health  # Edge Node
curl http://localhost:5173                  # Frontend

# Run automated tests
./test-deployment.ps1  # Windows
./test-deployment.sh   # Linux/macOS

# Manual verification
docker logs yo3-platform

# Rollback to previous commit
docker pull hyukiody/yo3-platform:full-source-<commit-hash>
docker tag hyukiody/yo3-platform:full-source-<commit-hash> hyukiody/yo3-platform:latest
docker-compose -f docker-compose.production.yml up -d

# Invite collaborators via GitHub
Settings → Collaborators → Add people

# Build locally
docker build -f Dockerfile.orchestrator -t yo3:local .

# Run locally
docker run -d --name yo3 -p 5173:5173 -p 8080-8091:8080-8091 yo3:local

# View logs
docker logs -f yo3

# Stop container
docker stop yo3 && docker rm yo3

# Production deploy
docker pull hyukiody/yo3-platform:latest
docker-compose -f docker-compose.production.yml up -d

# Clean rebuild
docker-compose -f docker-compose.production.yml down -v
docker pull hyukiody/yo3-platform:latest
docker-compose -f docker-compose.production.yml up -d --force-recreate