Developer Guide / Service Reference

Service Reference

The microservices that make up the platform.

Each service is independent, registers with Eureka, and owns its own PostgreSQL schema. Internal ports are used only inside the Docker network; the gateway on 8080 is the single public entry point.

ServicePortResponsibility
magicvarsh-eureka-server8761Service registry
magicvarsh-gateway8080API gateway: JWT auth, circuit breakers, routing
magicvarsh-auth-service8081Login, registration, JWT issuance, user profiles
magicvarsh-page-service8082Portal page CRUD
magicvarsh-asset-service8083Digital asset upload/storage
magicvarsh-web-content-service8084Structures, templates, content authoring
magicvarsh-portlet-service8085Portlet lifecycle and registration
magicvarsh-email-template-service8087Email template CRUD
magicvarsh-email-service8088Email sending via SMTP
magicvarsh-settings-service8089Site-wide configuration
magicvarsh-infra-service8093Health monitoring, scaling, deployment
i
Additional services exist for forms, workflow, labels, scheduling and two-factor auth, plus extension services. They follow the same structure and registration pattern.

Standard service layout

<module>/src/main/java/com/portal/<service>/
├── <Service>Application.java    # entry point
├── controller/                  # REST endpoints
├── service/                     # business logic
├── model/ or entity/            # JPA entities
├── dto/                         # request/response DTOs
├── repository/                  # Spring Data JPA repos
└── config/                      # Spring configuration