Skip to content

Cadastral Information System (CIS)

Welcome to the engineering documentation portal for the Cadastral Information System (CIS) platform.

CIS is an enterprise cadastral land management and user access governance solution built with modern Java 25, Spring Boot 4.1.2, Spring Security (OAuth2 / OIDC), Oracle 23, Redis, RustFS (S3 Object Storage), SFTP/FTP data interchange, and Camunda/Workflow processing engines.


Architecture at a Glance

The CIS platform is architected around specialized backend services, designed for separation of concerns, strict boundary security, and high-throughput cadastral data processing.

CIS System Architecture

[!NOTE] For the comprehensive end-to-end request flow, detailed security trust boundaries, and per-module specifications, see the System Architecture Guide.

Subsystem Topology

The internal domain topology coordinates the 6 core cadastral modules inside cis-api, embedded query and template libraries, and long-running BPMN execution in cis-workflow:

CIS Subsystem Topology & Domain Architecture

System Communication Flow

Step / Flow Source Target Protocol / Transport Security & Credentials Description
1. Client Ingress Browser / Client cis-bff (:8080) HTTPS Encrypted Session Cookie (HttpOnly, SameSite=Lax) User interacts with UI; cookies shield access tokens from XSS.
External Ingress Surveyors / Partners FTP/SFTP (:2121/:2022) FTP / SFTP over SSH Dedicated SFTP User Credentials & SSH Keys Upload of bulk shapefiles, raw surveyor coordinates, and deed archives.
2. Auth & Login cis-bff (:8080) cis-auth (:8085) OAuth 2.1 / OIDC Authorization Code Flow with PKCE (S256) Authenticates users, validates LDAP/WebAuthn, issues signed JWTs.
Directory Auth cis-auth (:8085) OpenLDAP (:10389) LDAPv3 over TCP Service Bind Account Verifies internal staff credentials and group memberships.
3. API Proxy cis-bff (:8080) cis-api (:8089) HTTP REST Authorization: Bearer <JWT> Proxies cadastral queries, reservation, and lodgement requests.
4. Workflow Proxy cis-bff (:8080) cis-workflow (:8090) HTTP REST Authorization: Bearer <JWT> Proxies user task lists, approvals, and process transitions.
5. Process Sync cis-api (:8089) cis-workflow (:8090) REST / BPMN Internal Mutual Auth / Bearer Triggers stage escalations, SLA checks, and status changes.
Database I/O cis-api / workflow Oracle 23 (:1521) JDBC (HikariCP) Encrypted DB Credentials Persists spatial records, land registers, and audit events.
Caching & Sync cis-bff / api Redis 7.4 (:6379) RESP over TCP Redis Auth Password Distributed sessions, token revocation blacklist, and ShedLock.
Object Storage cis-api (:8089) RustFS S3 (:9000) AWS S3 REST API AWS Access Key & Secret Key Stores and retrieves survey diagrams, deeds, and PDF dockets.
Batch Ingestion cis-api (:8089) FTP/SFTP (:2121/:2022) SFTP Client (JSch) SFTP Service Account Automated polling and ingestion of surveyor batch files.
Email Relay cis-emailer (in cis-api) Mailpit (:1025) SMTP Standard SMTP Dispatches customer receipts, approval notices, and certificates.
SMS Dispatch cis-api (:8089) SMS Gateway (HTTP) REST API (POST) API Key / Token Authentication Sends instant SMS status notifications and OTP verification alerts.
Stamping Service cis-api (:8089) Stamping Service (:8000) HTTP REST Internal Service Token Digital watermarking and official seal generation for cadastral plans.

[!TIP] For in-depth domain specifications of the 6 core business modules inside cis-api (Information System, Reservation, Lodgement, Relodgement, Maintenance, and Archival & HRA), see the cis-api Deep Dive.


Section Description
Getting Started Prerequisites, local setup with Docker, and building services
Architecture Subproject roles, runtime topology, and inter-service communication
Security & Authentication OIDC / OAuth2 token flows, Passkeys (WebAuthn), and BFF pattern
Database & Persistence Oracle 23 schema baseline, Flyway migrations, and JPA query optimization
Testing & Quality RestTestClient, Testcontainers (Oracle, Redis, LDAP), and Jacoco standards
Operations & Deployment Bitbucket CI/CD pipelines, Docker tagging, and Mailpit setup
Requirements Business workflows (cancellation, exercision, maintenance)
Engineering Audits Compiler warnings remediation, startup benchmarks, and security audits
PDF & Single HTML Export Complete unified documentation book formatted for PDF download or single HTML export

Core Technologies

  • Language Runtime: Java 25
  • Framework: Spring Boot 4.1.2 (Spring Framework 7)
  • Build System: Gradle 8.10+
  • Security: Spring Authorization Server (OIDC 1.0, OAuth 2.1, Passkeys / WebAuthn)
  • Data Stores: Oracle Database 23 Free / Enterprise, Redis 7.4 Alpine
  • Object Storage: RustFS (High-performance S3-compatible storage with Web Console on port 9000/9001)
  • File Transfer: FTP / SFTP Server (Port 2121 / 2022) for bulk surveyor files & shapefiles
  • External Integrations: SMS Gateway (Applicant mobile alerts), Stamping Service (Port 8000 watermarking), Mailpit / SMTP (Port 1025)
  • Directory Service: OpenLDAP / Microsoft Active Directory (Port 10389)
  • Documentation: MkDocs Material (Hermetic, repo-sandboxed)