Home

360 Ghar Backend

360 Ghar is a unified real estate platform backend built with FastAPI, PostgreSQL+PostGIS, SQLAlchemy 2.x async, and Pydantic v2. It powers six integrated modules from a single async codebase, authenticates against Supabase Auth, and exposes both a REST API at /api/v1/* and two MCP servers at /mcp and /mcp-admin for LLM clients.

Overview video

A 2-3 minute silent walkthrough of the platform's six modules and architecture.

The six modules

Module	Purpose
Ghar Core	Buy/rent marketplace with swipe-based discovery, geospatial search, agent coordination, and visits.
360 Stays	Short-stay bookings with availability checks and dynamic pricing.
360 Flatmates	Roommate and PG discovery with swipe matching, conversations, and moderation.
Property Management	Landlord tools: leases, rent collection, maintenance, documents, inspections, reports.
360 Virtual Tours	Immersive 360 degree tour builder with AI hotspot generation and analytics.
360 Data Hub	Real estate data aggregation: bank auctions, RERA, circle rates, gazette, jamabandi, zoning.

Start here

• Architecture — layered structure, request flow, MCP architecture with diagrams.
• Getting started — prerequisites, install, build, test, run.
• By the numbers — codebase statistics snapshot.
• Glossary — domain vocabulary (ghar, vastu, RERA, jamabandi, flatmates, MCP).

Browse by lens

• Features — cross-cutting product capabilities (11 pages).
• Systems — internal building blocks (8 pages).
• Primitives — foundational domain objects (8 pages).
• API — REST surface map and authentication.

Operations

• Deployment — Railway, Docker, serverless mode.
• Security — auth, rate limiting, security headers, OAuth.
• Monitoring — logging, Sentry, health checks.
• Design decisions — ADRs and rationale.
• Pitfalls — overlapping bookings, serverless trade-offs, anti-patterns.

Reference

• Configuration — environment variables.
• Data models — entity relationships with ERD.
• Dependencies — Python and JavaScript dependencies.
• Maintainers — subsystem ownership.

Repository

• Source code
• README
• CLAUDE.md — coding guidelines and architecture reference.
• AGENTS.md — operating contract for contributors and agents.