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:
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:
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:
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¶
- Defense-in-Depth & Boundary Security:
cis-bffacts as the exclusive public ingress point for user browsers.- Browser sessions hold an HTTP-only, SameSite encrypted session cookie.
- OIDC Bearer tokens (
access_token,refresh_token) never leak to the client browser. - Stateless Business Processing:
cis-apiandcis-workflowoperate purely as stateless OAuth2 Resource Servers verifying cryptographically signed JWT tokens issued bycis-auth.- Dedicated Object Storage (RustFS):
- 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. - Resilient Asynchronous Ingestion (FTP / SFTP):
- 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.
- Database Federation:
- Schemas are partitioned logically; migrations are governed strictly via Flyway scripts.