Skip to content

System Architecture

The Cadastral Information System (CIS) is an integrated national land management platform designed for strict perimeter security, multi-role cadastral workflows, and high-throughput spatial land transaction processing.


System Architecture Diagram

Below is the verified end-to-end system architecture representing all active application tiers, security boundaries, internal services, persistence engines, and external integrations:

CIS System Architecture

End-to-End Request Lifecycle & Flow

Every request within CIS follows a deterministic 4-stage lifecycle ensuring strict defense-in-depth, token privacy, stateless microservice processing, and decoupled asynchronous storage:

CIS End-to-End Request Flow

Subsystem Topology & Domain Architecture

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 exhaustive domain specifications of the 6 core business modules inside cis-api, see cis-api Deep Dive.


Subproject Ecosystem Matrix

Subproject / Component Responsibility Primary Stack Dependencies
cis-auth Identity Provider & OAuth2 / OIDC Authorization Server Spring Authorization Server, Nimbus JOSE, LDAP, Redis, Oracle Oracle, Redis, LDAP
cis-bff Backend-for-Frontend & Reverse Proxy Spring Boot Web, Spring Security OAuth2 Client, Redis Session Store cis-auth, cis-api, Redis
cis-api Cadastral domain entities, REST APIs, land parcel management Spring Boot Web, Spring Data JPA, Hibernate, Oracle JDBC Oracle DB, cis-workflow, RustFS, SFTP
cis-workflow Long-running BPMN business processes, transitions, and approvals Spring Boot, Flowable / Camunda workflow engine Oracle DB, cis-api
cis-emailer Asynchronous email formatting, notification dispatch, and attachments Spring Boot Mail, Flying Saucer PDF, Thymeleaf, JavaMailSender Mailpit / SMTP Server
cis-search High-performance full-text search indexing and spatial queries Solr / Elasticsearch / Spring Data Search Search Cluster
RustFS S3 S3-compatible high-performance object and blob storage RustFS Server & Console, S3 API Persistent Volume Storage
FTP / SFTP Server Secure external bulk shapefile, scan, and surveyor coordinates ingestion Apache MINA / OpenSSH SFTP Daemon (Ports 2121, 2022) Local / Network Filesystem
SMS Gateway Instant SMS notifications and OTP dispatch to applicants & surveyors HTTP REST Client External Telco / SMS Provider
Stamping Service Dedicated plan watermarking, cryptographic digital signing, and seals Python / Java Microservice (Port 8000) cis-api REST callers

Architectural Principles

  1. Defense-in-Depth & Boundary Security:
  2. cis-bff acts as the exclusive public ingress point for user browsers.
  3. Browser sessions hold an HTTP-only, SameSite encrypted session cookie.
  4. OIDC Bearer tokens (access_token, refresh_token) never leak to the client browser.
  5. Stateless Business Processing:
  6. cis-api and cis-workflow operate purely as stateless OAuth2 Resource Servers verifying cryptographically signed JWT tokens issued by cis-auth.
  7. Dedicated Object Storage (RustFS):
  8. Cadastral documents, reservation acknowledgement receipts, scan attachments, and batch dockets are stored as blobs in RustFS via S3 API (:9000), rather than bloating the relational database tables with BLOBs.
  9. Resilient Asynchronous Ingestion (FTP / SFTP):
  10. External land surveyor batch submissions, GIS shapefiles, and large deed scan archives are transferred via secure SFTP/FTP endpoints on ports 2022/2121, decouled from synchronous REST API timeouts.
  11. Database Federation:
  12. Schemas are partitioned logically; migrations are governed strictly via Flyway scripts.