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.
[!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:
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.
Documentation Quick Links¶
| 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)