Skip to content

feat: reference telco core platform — Quarkus microservices + serverless, ISO/3GPP/IMT-2030-aligned architecture and docs - #1

Merged
psehgaft merged 4 commits into
mainfrom
feat/reference-telco-core
Nov 3, 2026
Merged

psehgaft merged 4 commits into
mainfrom
feat/reference-telco-core

Conversation

@psehgaft

@psehgaft psehgaft commented Nov 3, 2026

Copy link
Copy Markdown
Member

What this PR adds

A complete, standard, generic telecommunications core platform — deployable and adaptable by configuration — built as Quarkus microservices + serverless functions (Java 21), aligned with The Twelve-Factor App, documented under the ISO architecture standards, and aligned with the telecom frameworks below. All content in English; all data synthetic.

Standards alignment ("aligned to" — no certification or regulatory-compliance claim)

  • ISO/IEC/IEEE 42010 — Architecture Description with 9 viewpoints, 12 ADRs, correspondence rules CR-1..CR-6 (docs/architecture/architecture-description.md)
  • ISO/IEC 25010 — quality model with scenarios QS-01..QS-10
  • ISO/IEC/IEEE 15288 & 12207 — life-cycle processes and gates G0..G5
  • ISO/IEC 27001 & 27002 — security architecture, control mapping, STRIDE threat model
  • 3GPP TS 23.401 (4G/EPC) and TS 23.501/23.502 (5G SBA), TS 28.531 (slicing) — normative role mapping: HSS→UDM, PCRF→PCF, OCS→CHF, P-GW-C→SMF, plus NSSF and NEF (docs/telecom/3gpp-architecture.md)
  • ITU-R IMT-2030 / M.2160 (6G framework) — the six usage scenarios mapped to design extension points (incl. the ISAC slice type); framed honestly as framework alignment, since no finished 6G standard exists yet (docs/telecom/6g-imt-2030.md, ADR-0012)
  • TM Forum ODA / Open APIs / eTOM, ETSI NFV-MANO / MEC / ZSM, O-RAN posture, GSMA Open Gateway / CAMARA exposure APIs (QoD, SIM Swap)

Code (10 modules, each with @QuarkusTest tests)

Module 3GPP alignment Key rule enforced
subscriber-service (8081) UDM/UDR · HSS Permanent identifier (IMSI/SUPI) validated, masked, never stored or returned in clear
session-service (8082) SMF · P-GW-C PDU session lifecycle bound to S-NSSAI
policy-service (8083) PCF · PCRF Decisions ALLOWED/DEGRADED/DENIED always with rule + reason
charging-service (8084) CHF · OCS Prepaid balance never goes negative (422, nothing recorded)
network-slice-service (8085) NSSF · TS 28.531 S-NSSAI derived; lifecycle PROVISIONED→ACTIVE→DECOMMISSIONED
exposure-service (8086) NEF · CAMARA QoD sessions; SIM-swap risk bands
notification-service (8087) — Channel-agnostic dispatch from events
usage-rating (function) offline rating Same reference tariff as charging (CR-6)
network-anomaly-scorer (function) assurance / ZSM KPI score + auditable rationale
sla-compliance-evaluator (function) slice assurance SLA verdict with one finding per breach

Also: OpenAPI/AsyncAPI (CloudEvents) contracts, Kubernetes + Knative manifests, docker-compose (PostgreSQL/Kafka/Keycloak), .env.example, Makefile, roadmap (docs/implementation-roadmap.md, sequence: Subscriber → Session → Charging → Exposure APIs). The CI workflow (.github/workflows/build.yml, mvn -B verify) is added separately via the web UI because the GitHub App cannot write workflow files.

Nothing here is merged automatically — this PR awaits the owner's review.

… (ISO 42010/25010/15288/12207/27001/27002, 3GPP 4G/5G, IMT-2030 6G, TM Forum, ETSI, CAMARA), contracts, deployment, reactor root
…charging/slice/exposure/notification) with tests
…ly-scorer, sla-compliance-evaluator) with tests
@psehgaft
psehgaft merged commit 5829948 into main Nov 3, 2026
2 of 4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant