GeoLokal Manual

GeoLokal turns a Philippine land title into computed coordinates, closure, area, DXF plans and ready-to-file LRA / LMB / DENR survey returns. This manual walks you through every module from upload to final bundle.

The 60-second overview

1. Sign in with your email (tier login) or Google OAuth. Super-admins have a dedicated password login at /admin/login.
2. Upload a TCT / CCT PDF or snap the title pages with your phone.
3. Review the OCR-extracted bearings, distances, tie line and header (lot number, claimant, municipality).
4. Compute closure — the solver enforces the configured cadastral tolerances for bearings and distances.
5. Export a DXF, CSV, KML, GeoJSON, Shapefile, Survey Returns ZIP, or draft a deed — all from the same lot record.

The left rail at a glance

Everything in GeoLokal is one click away from the collapsible left rail. Analyzer sits at the top, with Atlas, Survey Returns, Sketch Plan, DXF Editor, Deeds, Vault, Workspace and your Admin pages beneath.

GeoLokal supports three sign-in paths, each landing on a different cookie-based session.

Tier Login (end users)

1. Open /login — you'll see 5 tier badge cards (Free, Advance, Real Estate Pro, Geodetic Engineer, Enterprise).
2. Enter your email + password; the login endpoint rate-limits to 10/min + 40/hr per IP.
3. On success a httpOnly session cookie is set and you land on your Workspace.

Google OAuth

First-time Google sign-up auto-provisions a Free-tier account. Subsequent logins restore your tier and modules exactly as they were.

Super-Admin Password Login

Super-admins (listed in the ADMIN_EMAILS env var) sign in via /admin/login with the password set in ADMIN_PASSWORD. The admin cookie unlocks the Admin Dashboard and all /admin/* pages.

The Analyzer is where every lot starts. Upload a TCT / CCT PDF or snap photos of the title; GeoLokal OCRs the bearings, distances, tie line and header, computes the lot points, perimeter, area and closure ratio, and lets you export every downstream format.

The flow

1. Open the Analyzer from the left rail.
2. Drop a PDF or up to 8 photographed title pages — the OCR runs in the background.
3. Review the extracted bearings table; red cells mean the OCR is unsure — click to correct and the fix feeds back into the training pipeline.
4. Press Compute Closure. The solver enforces the configured cadastral tolerances for bearings and distances.
5. Save the lot — valuation, location, and OCR header are persisted together.
6. Export: DXF, Bare DXF, CSV, KML, GeoJSON, Shapefile, Survey Report PDF, or push straight into Survey Returns.

Property Valuation Card (Iter866-867)

After the OCR locates your lot, the Analyzer auto-fetches the BIR zonal value for the barangay and computes a market range using the regional multiplier table. The low / mid / high estimate shows directly in the right-hand Property Valuation card.

1. Confirm the auto-detected zonal classification (RR, CR, AG) — tap to override if the OCR picked the wrong one.
2. Enter your own market_value if you have a comparable sale; it's saved alongside the zonal estimate.
3. On Save, both market_value and zonal_total are persisted on the lot so the Atlas value overlay can colour by them without re-querying.

OCR → Survey Returns Shortcut (Iter859)

Once the OCR + closure look right, click "Start Survey Returns from this title" at the top of the Analyzer. Survey Returns opens pre-filled with the lot's header (plan name, lot number, claimant, municipality, province) and geometry — no re-upload required.

Export formats

1. DXF (bare boundary) — polygon LINE elements only, no metadata.
2. DXF (fully-labelled) — polygon + corner numbers + bearings + LDC table.
3. CSV — one row per leg (station, bearing, distance, northing, easting).
4. KML — WGS84 polygon ready for Google Earth.
5. GeoJSON + Shapefile — PRS92 / WGS84, ready for QGIS / ArcGIS.
6. Survey Returns bundle — the full LRA / LMB / DENR ZIP (see Survey Returns section).

Location preview

The right-hand column shows a Leaflet preview centred on the lot. If a tie point (BLLM or private monument) is far away, the Analyzer flags it as an outlier and excludes it from the centroid so the preview doesn't drift kilometres away. Pick a Zone (PRS92 I–V) from the dropdown if the title doesn't declare one.

When two lots share a common boundary but their bearings disagree by a few centimetres, the Overlap Resolver snaps shared vertices to a single mediated point — preventing sliver polygons in Survey Returns and Consolidation.

1. Analyze both lots individually.
2. Open Analyzer → Overlap Resolver.
3. Pick the two lots — the app highlights the disputed edge.
4. Accept the mediated vertex, drag a custom snap point, or lock one lot's version as canonical.
5. The snap is saved on both lots so every downstream export inherits it.

Load multiple lot folders side-by-side on a single Leaflet canvas — perfect for comparing a proposed subdivision against nearby cadastral lots or verifying a road-widening claim.

1. Open Multi-Folder Viewer from the left rail (route /viewer).
2. Add each folder from your Workspace — each lot is colour-coded.
3. Toggle layer visibility, opacity and label visibility per folder.
4. Export the current view as PNG or copy the shareable URL.

Consolidation merges multiple parent-lot boundaries into a single polygon, then optionally re-splits them into evenly-partitioned children. Use it when a client is buying up neighbouring lots and wants a single title, or when a subdivision needs child lots of specific target areas.

1. Open Consolidation from the left rail.
2. Add each parent lot from your Analyzer history, or paste bearing/distance tables directly.
3. Preview the merged polygon — the app flags overlaps and gaps.
4. Optionally define child-lot target areas and run auto-subdivision.
5. Export the consolidated DXF or hand it to Survey Returns to generate the returns bundle.

Every lot you analyze, every bundle you generate and every deed you draft is persisted on your account. The History page lists them chronologically; My Works groups them by project / folder for team review.

1. Open History for a chronological feed of all generated artefacts.
2. Open My Works to see them grouped by project, folder, or org.
3. Click any row to re-open the record, re-export, or hand it off to Survey Returns / Consolidation.
4. Use the filter chips (province, municipality, date range) to narrow the list.

GeoLokal ships a curated registry of BLLM monuments and private tie points covering Laguna, Batangas and parts of Cotabato. The Tie Points page lets you search, map and use any point as a reference for the Analyzer or Survey Returns.

1. Open Tie Points from the left rail.
2. Filter by province / municipality or search by point reference (e.g. BLLM-1, PLS 395).
3. Click a point to see its PRS92 and WGS84 coordinates, map pin, source batch and audit history.
4. Hit 'Use in Analyzer' to pre-fill the tie point in a new session.

Browse the curated municipal lot database and search by CAD / PSD number, lot number, plan name or owner. Currently covers 21,591+ lots across San Pablo City Laguna, select Batangas municipalities and Alamada Cotabato — with new municipalities added via Admin → Zonal Uploader.

1. Filter by Province → Municipality → Barangay.
2. Type in the search bar to fuzzy-match lot #, plan #, owner name.
3. Click a marker on the map to inspect the metes-and-bounds record.
4. Lasso-select multiple lots to export a bulk DXF / KML.

Value Overlay (Iter868)

Flip the "Colour by value" toggle in the Layers panel to repaint every visible polygon by estimated ₱ value. The 5-step viridis ramp (deep blue → cyan → yellow → orange → red) is quantile-bucketed across whichever lots are currently in the viewport, so the top red polygon is always your highest-value lot right now — zoom in and the ramp re-fits automatically.

1. Open the Layers panel on the right of the Atlas.
2. Tick Colour by value — the field picker appears underneath.
3. Pick Market (High), Market (Low), or Zonal Total to switch the ramp basis.
4. Legend at the bottom of the panel shows the current ₱ min and ₱ max.
5. Click any coloured polygon — the popup now shows the exact ₱ figure for the chosen field.

My Plottings layer

Every lot you save from the Analyzer (with its persisted market_value / zonal_value) renders as a cyan dashed polygon on the Atlas. Click a plotting → "Open in Analyzer" to jump back into the computed record.

Upload a DXF drawing of a subdivided parent lot and the app extracts every child lot, generates the LRA + LMB + DENR forms, renders the DXF plan, and packages a single ZIP — ready for filing.

The flow

1. Open Survey Returns from the left rail.
2. Upload the parent + children DXF (one file). The parser auto-detects the parent polygon vs. each child polygon.
3. Fill the title-block header (plan name, GE credentials, dates, purpose, province, municipality, barangay). Fields auto-fill from your GE Profile when registered.
4. Edit the Plan Notes per lot — a tabbed editor exposes a Shared tab (prints on every plan) and one tab per child lot for per-lot overrides.
5. Review adjoiners for the parent + each child; the app auto-detects neighbours from the Atlas and lets you edit the labels inline.
6. Hit Review & Edit Plans to open the DXF Editor on the LMB + LRA plans, or Generate Bundle Directly to download the ZIP.

Region Auto-Detect + Crowd-sourced Signatories (Iter855-857)

The OCR now infers the DENR / LMB region (CAR, NCR, I–XIII, BARMM) from your province so the LRA / LMB / DENR forms stamp the correct Regional Executive Director and Chief of Survey block without you looking anything up. A sticky Region chip in the Survey Returns header shows which region was detected — click to override.

If the baked-in signatory looks stale, hit "Suggest a correction" on the signatory card. When 5 distinct users submit the same name, the override auto-promotes to the public default — you can watch the vote count climb before it flips.

What ships in the ZIP

1. LRA plan DXF + LRA field notes PDFs (per lot).
2. LMB plan DXF + LMB field notes PDFs (per lot).
3. DENR FNC lot PDF + traverse computation sheets.
4. Sketch plan DXF (LMB GSD-C-3 template; info-only, not for approval).
5. GeoJSON FeatureCollection + Shapefile ZIP per lot (QGIS / ArcGIS ready).
6. Per-lot technical description tables, azimuth sheets, ledger sheets.

Rules enforced by the renderer

1. Corner numbers sit in the angle-bisector of each vertex so they never cross a boundary line (mother outside 3 mm paper, children inside 5 mm paper).
2. Technical description tables scale with the drawing bounds (never shrink to microscopic sizes).
3. Tie-line captions auto-shrink when they would overflow the table.
4. Date Prepared / GE Name slots auto-shrink to prevent overlap when the OCR date is long.

The Sketch Plan renders a draft LMB GSD-C-3 Sketch Plan DXF for information / drafting purposes (never for approval). It mirrors the LMB plan's rules: adjoiners, tie-line sub-section, technical description tables and corner-number non-overlap.

1. Open Sketch Plan from the left rail (route /sketch-plan).
2. Upload a lot DXF or fill the form directly (lot points, header, tie point).
3. Preview the sketch — adjust Plan Notes (shared with LRA/LMB).
4. Download the DXF (editable in AutoCAD / BricsCAD / DWG FastView) or the one-page A3-landscape PDF.

The Survey Report is a 1-click PDF that summarises a lot's bearings, distances, closure, area and GE certification — a client-friendly handover document.

1. Open Survey Report from the left rail.
2. Pick the lot (parent BOUNDARY or child-N) and the survey type (Original, Subdivision, Consolidation, Relocation, Verification).
3. Confirm your GE credentials auto-filled from your profile.
4. Download the PDF — one page, header, body, closure summary and signature block.

Draft Deeds of Absolute Sale, Contracts to Sell, Extrajudicial Settlements, Special Powers of Attorney and companion affidavits — autofilled from OCR'd title data + party IDs, with due-diligence attachments bundled into a single PDF.

Autofill from a title

Click Autofill from TCT/CCT and upload a PDF or up to 8 photographed pages. The extracted title number, lot number, area and technical description drop into the form; if the OCR finds an owner name it seeds the first seller.

Autofill from an ID

Each Party row has an Autofill from ID button. Snap the front + back of a driver's license or PhilID and the app fills name, address, civil status, citizenship and ID details.

Attach due-diligence

1. Tax Declaration, Lot Plan, Approved Plan, Buyer ID, Seller ID tiles accept up to 8 image pages each.
2. Drag rows to reorder — the appendix follows the same sequence.
3. Tap 90° / 180° to rotate a scan without re-uploading.
4. Add a note per attachment (e.g. 'TD 2024-08-01') that shows on the appendix divider.

Export

Download PDF or DOCX. Toggle Include Attachments to concatenate the due-diligence pages after the deed. Signed versions can be uploaded back to the deed record for a complete audit trail.

A catalogue of the common Philippine real-estate forms (CGT return, BIR 2000-OT, DST return, Transfer Fee calculator, Assumption of Mortgage, Disclosure of Beneficial Ownership). Each form has a guided wizard that pulls title + party data from your Deed so you don't retype anything.

1. Open Real Estate Docs from the left rail (route /realestate-docs).
2. Pick a form — the wizard pre-fills from the most recent Deed in your workspace.
3. Review each field, add signatures / dates, and download the completed PDF.

Look up official BIR zonal values by RDO / province / municipality / barangay / street — essential for Capital Gains Tax computations.

1. Open Zonal Values from the left rail (route /zonal-values).
2. Filter by RDO or search by barangay / street.
3. Click a row to see the full schedule PDF reference.

The Property Vault is your permanent digital filing cabinet. Every lot lives inside a Vault with its own map, survey data, title documents and tax records — one URL you can share with a buyer, bank, or your DPO.

Create a Vault

1. Open Property Vault from the left rail.
2. Tap New Vault, give it a name (e.g. 'Lot 4-B San Pablo').
3. Optionally attach it to a Lot record from the Analyzer so its computed coordinates auto-link.

Auto-analyze titles on upload

Drop a TCT/CCT PDF into a Vault and the Analyzer runs quietly in the background — you'll see a computed KML, closure ratio and survey report attached to the same vault without leaving the page.

Deep Tag Tax Miner

Uploaded Tax Declarations and RPT receipts are OCR-mined for tax-dec numbers, ARP, PIN, year, assessed value and dates. Extracted tags show up as searchable pills on the Vault document row.

Public share link

1. Open a Vault → Share.
2. Toggle Public link ON — copy the /vault/public/... URL.
3. Send it to your client; they see a read-only view without login.
4. Toggle it back OFF any time to revoke access.

Workspaces group your lots, folders and survey jobs. Orgs let you invite colleagues into a shared workspace with per-role permissions (Owner / Admin / Member / Viewer).

Create an Org

1. Open Team from the left rail.
2. Tap New Org, name it, and pick a plan tier.
3. Invite members by email — they get an /invite/:token link.
4. Assign each member to a role and specific folders.

Projects & Calendar

Inside an Org, group work into Projects (a survey job, a subdivision, a due-diligence engagement). Each Project has its own calendar for field visits, deadlines and export reminders.

Folder sharing

Project folders can be shared via /folder-invite/:token so an external reviewer (e.g. a lawyer or a bank officer) can read documents without joining your Org.

Upload a scanned PRC ID and current PTR receipt so admin can verify your licence before you export official forms. Once verified, your name, license number and PTR appear on every generated LMB/LRA/DENR return and your firm footer auto-signs each plan.

1. Open GE Profile from your account menu.
2. Fill name, license number, PRC-ID issue + expiry, PTR OR number, PTR date and place of issue.
3. Upload a photo of your PRC ID (front + back) and a photo of the current PTR receipt.
4. Submit for review. Admins approve within 2 business days.

GeoLokal uses a 5-tier plan ladder with monthly quotas (artefacts generated per calendar month) and per-tier module entitlements.

• Free2 artefacts / month — Analyzer, watermarked outputs
• Advance5 artefacts / month — adds exports (KML), Atlas, Save Lots, Project Folders
• Real Estate10 artefacts / month — adds title reconciliation, overlap resolver, overlay maps, deeds
• Geodetic Eng.20 artefacts / month — adds full DXF/SHP/GeoJSON exports, Survey Returns, sharing, consolidation
• Enterprise30 artefacts / month — adds team management, SSO, priority support

Upgrading / downgrading

1. Open Billing from the account menu.
2. Pick a tier card and continue to Xendit's hosted checkout.
3. Confirm the payment — your plan upgrades instantly and your module entitlements refresh in the current session.
4. Downgrades take effect at the end of the current billing period so your quota isn't retroactively cut.

The Service Marketplace lists verified Geodetic Engineers and Real-Estate agents in your area so a buyer or seller can commission a licensed professional directly from GeoLokal.

1. Open Services from the left rail (route /services).
2. Filter by profession, region or specialty.
3. Click a GE / agent card to see their portfolio, verified credentials and typical rates.
4. Hit Request Service — the professional gets a notification and your conversation starts inside GeoLokal.

Convert points between the Philippine Reference System 1992 (PRS92, all 5 zones) and WGS84 (GPS lat/lon). Handy for verifying a BLLM monument or plotting a legacy PRS92 coordinate onto Google Maps.

1. Open CRS Converter from the left rail (route /converter).
2. Pick the direction (PRS92 → WGS84 or WGS84 → PRS92).
3. Enter the coordinate pair and the PRS92 zone (I–V) if applicable.
4. Copy the result or paste directly into your DXF/GIS software.

A GE-only crowdsourced game where Registered Geodetic Engineers audit BLLM monuments in the field — snap a geotagged photo, submit the reading, and earn points that rank you on a live leaderboard.

Who can play

You must be a Registered Geodetic Engineer with a verified PRC + PTR on your GE Profile. Unverified accounts see a gate screen.

How to submit an audit

1. Open Control Hunt from the left rail (route /audit-game).
2. Tap Submit New Audit and pick a nearby BLLM from the map.
3. Snap a photo of the monument (EXIF geotag required) or upload from your camera roll.
4. Enter the measured northing/easting and note any damage / displacement.
5. Submit — the app watermarks your photo and awards points based on accuracy vs. the reference value.

Levels & leaderboard

• 100 ptsBronze Auditor
• 500 ptsSilver Auditor
• 2,000 ptsGold Auditor
• 5,000 ptsPlatinum Auditor

Super-admins unlock a dedicated /admin dashboard with every operational tool: user management, template locks, tie-point curation, moderation queues and observability.

Key sub-pages

• /adminDashboard overview (counts, trends, revenue)
• /admin/usersUsers panel (approve, tier override, reset)
• /admin/grantsTemporary tier upgrades with expiry
• /admin/review-queueFlagged OCR failures + moderation inbox
• /admin/title-mismatch-queueTitle vs. DXF mismatch tickets
• /admin/duplicatesLot duplicate detection + merge
• /admin/abuse-clustersAbuse cluster triage
• /admin/ge-prc-reviewGE verification queue (PRC + PTR)
• /admin/tie-pointsTie-point registry editor
• /admin/map-layersUpload GeoTIFF base layers
• /admin/nudge-insightsIn-app nudge analytics
• /admin/observabilityError logs, API latency, system health
• /admin/templatesTemplate upload (BIR, LMB, LRA)
• /admin/zonal-uploaderUpload new BIR zonal schedules
• /admin/osm-ingestOpenStreetMap ingest history
• /admin/bulk-datasetBulk municipal-lot ingest

Super-admins can upload GeoTIFF raster layers (cadastral overlays, aerial imagery, hazard maps) that appear as toggleable base layers across the Atlas, Viewer and Vault maps.

1. Sign in as a Super-admin.
2. Open Admin Console → Map Layers (route /admin/map-layers).
3. Tap Upload GeoTIFF and pick a .tif / .tiff file — Emergent Object Storage hosts it and rio-tiler serves tiles on demand.
4. Name the layer, set default visibility and choose which modules it appears on.
5. Users see the new layer in their map's layer toggle immediately.

Project Folders are shared containers that bundle a client's lots, DXFs, deeds and vault documents under one logical name. Share a folder with a reviewer and they see every artefact without touching your workspace.

1. Open Project Folders from the left rail (route /projects).
2. Create a folder; set a name, client reference and private / shared visibility.
3. Add existing lots from the Analyzer or save new ones directly into the folder.
4. Invite reviewers via email — they get an /folder-invite/:token link.

The Beta page (/beta) explains what "BETA" means in practice (occasional OCR drops, every export carries a disclaimer, early-adopter grandfathered pricing), and the Known Issues page (/known-issues) is a public changelog of what's broken, what shipped, and what we're working on next.

How to become a beta tester

1. Open geolokal.app and click Sign In — Google OAuth or the tier login both work.
2. Every new sign-up is auto-approved while AUTO_APPROVE_REGISTRATIONS is on; you land in /analyzer immediately.
3. Your trial counter starts at 10 uses per feature (OCR parses, lot saves, Atlas downloads, Survey Returns bundles, DXF files).
4. Hit the yellow BETA banner at the top of any page to open /beta for the full ground rules.

What beta testers get (Iter863)

1. 10 uses per feature instead of the GA tier quotas.
2. Full access to every module — Atlas Value Overlay, Property Valuation, Survey Returns, DXF Editor, Deeds, Vault, Workspace.
3. Grandfathered beta pricing when GeoLokal flips to GA.
4. Bug Reporter button always visible with session replay auto-attached.

GeoLokal ships a built-in bug reporter so testers never need to leave the app to flag a problem. Every submission auto-attaches a Session Replay — the last 20 clicks, API calls and screen states — so engineering can reproduce the bug without a 20-message back-and-forth.

Report a bug (Iter860-862)

1. Click the floating 🐛 button at the bottom-right of any page.
2. Add a short note describing what you expected vs. what happened.
3. The modal shows the auto-captured session trail — review and submit.
4. Super-admins triage from Admin → Bug Reports (status: open / investigating / fixed).

Known Issues (public changelog)

Open /known-issues to read the running list of known limitations, in-flight fixes and recently shipped items. Super-admins curate the list from Admin → Known Issues; everything there is public.

GeoLokal is a Progressive Web App — no app-store install required. It runs fullscreen with its own icon and web-push notifications work on iOS 16.4+ once installed.

iPhone (Safari)

1. Open geolokal.app in Safari.
2. Tap the Share button (square with an arrow).
3. Scroll down and tap Add to Home Screen.
4. Confirm the name — done. Launch the icon from your home screen.

Android (Chrome / Edge)

1. Open the site in Chrome.
2. Tap the three-dot menu → Install App (or the Install popup that appears in-page).
3. Confirm — the icon lands on your home screen.

Get pinged when a deed export finishes or a survey-returns bundle is ready — even when the browser is closed.

1. Open Settings → Data Privacy.
2. In the Push Notifications card tap Enable Notifications and allow the browser prompt.
3. Tap Send Test to confirm delivery.

Every visitor is greeted with the GeoLokal Disclaimer & Data Use Notice — a consolidated policy covering both the Data Privacy Act of 2012 (RA 10173) AND the platform disclaimer (approximate map visualisations, no government affiliation, user-verification requirement).

Consent is revocable any time from Settings → Data Privacy. Your DPO controls (deletion request, correction request) live on the same page and are answered within 15 working days.

• G then AGo to Lot Analyzer
• G then MGo to GeoLokal Land Atlas
• G then RGo to Real Estate Toolkit
• G then SGo to Survey Returns
• G then VGo to Vault
• G then HOpen this manual (Help)
• /Focus the search / command bar (where available)
• EscClose a modal, picker, or focused mode