# eswarimadhavarapu/ap_rera_project architecture

> Architecture diagram of the GitHub repository eswarimadhavarapu/ap_rera_project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eswarimadhavarapu/ap_rera_project
- Repository: https://github.com/eswarimadhavarapu/ap_rera_project

## Overview

This is a web portal for real-estate regulatory workflows (RERA), with a React frontend and Flask/SQLAlchemy backend. A user-facing project flow includes project registration, preview assembly, and review; the repository also has separate agent, change-request, scrutiny, complaint, RTI, quarterly-update, search, rating, and support capabilities. The preview route and its data-building/database access are directly evidenced. Other domain branches are represented from the source tree, but their internal calls are not asserted because their implementations were not sampled and the README is empty.

Main entry points: [`BACKEND/app/controllers/project_preview_controller.py`](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/project_preview_controller.py) (Project preview route), [`FRONTEND/src/App.jsx`](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/FRONTEND/src/App.jsx) (React application), [`FRONTEND/src/api/api.js`](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/FRONTEND/src/api/api.js) (HTTP client), [`FRONTEND/src/pages/ProjectPreview.jsx`](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/FRONTEND/src/pages/ProjectPreview.jsx) (Project preview UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_frontend["React application<br/>[App.jsx]"]
  node_frontend_api["HTTP client<br/>[api.js]"]
  node_preview_ui["Project preview UI<br/>[ProjectPreview.jsx]"]
end

subgraph group_project["Project workflows"]
  node_project_registration["Project registration"]
  node_project_preview["Project preview route"]
  node_preview_builder["Preview data builder"]
  node_project_records["Project records"]
  node_engineer_records["Engineer records<br/>[engineer.py]"]
  node_project_extensions["Project lifecycle"]
end

subgraph group_regulatory["Regulatory services"]
  node_agent_workflows["Agent workflows"]
  node_change_requests["Change requests"]
  node_scrutiny["Application scrutiny"]
  node_complaints["Complaints"]
  node_rti["RTI requests<br/>[rti_controller.py]"]
end

subgraph group_support["Portal services"]
  node_search["Search<br/>[search_service.py]"]
  node_ratings["Project ratings"]
  node_chat_faq["Chat and FAQs<br/>[chat_service.py]"]
end

subgraph group_data["Persistence"]
  node_database[("SQLAlchemy database<br/>[database.py]")]
end

node_user(("Portal user"))
node_operator(("Portal operator"))

node_user -.->|"uses"| node_frontend
node_frontend -.->|"presents"| node_preview_ui
node_preview_ui -.->|"requests preview"| node_frontend_api
node_frontend_api -.->|"sends HTTP request"| node_project_preview
node_project_preview -->|"builds preview"| node_preview_builder
node_preview_builder -->|"queries records"| node_database
node_project_preview -->|"fetches registration"| node_project_records
node_project_preview -->|"imports model"| node_engineer_records
node_operator -.->|"submits application"| node_project_registration
node_operator -.->|"manages lifecycle"| node_project_extensions
node_operator -.->|"registers agent"| node_agent_workflows
node_operator -.->|"requests changes"| node_change_requests
node_operator -.->|"reviews applications"| node_scrutiny
node_operator -.->|"handles complaints"| node_complaints
node_operator -.->|"handles RTI"| node_rti
node_user -.->|"searches portal"| node_search
node_user -.->|"rates projects"| node_ratings
node_user -.->|"seeks help"| node_chat_faq

click node_frontend "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/FRONTEND/src/App.jsx"
click node_frontend_api "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/FRONTEND/src/api/api.js"
click node_preview_ui "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/FRONTEND/src/pages/ProjectPreview.jsx"
click node_project_registration "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/project_registration_controller.py"
click node_project_preview "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/project_preview_controller.py"
click node_preview_builder "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/project_preview_data_controller.py"
click node_project_records "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/models/project_registration_model.py"
click node_engineer_records "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/models/engineer.py"
click node_project_extensions "https://github.com/eswarimadhavarapu/ap_rera_project/tree/dev/BACKEND/app/controllers"
click node_agent_workflows "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/agent_registration_controller.py"
click node_change_requests "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/change_request_controller.py"
click node_scrutiny "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/agent_scrutiny_controller.py"
click node_complaints "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/complint_controller.py"
click node_rti "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/rti_controller.py"
click node_search "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/services/search_service.py"
click node_ratings "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/services/project_rating_service.py"
click node_chat_faq "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/services/chat_service.py"
click node_database "https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/models/database.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend,node_frontend_api,node_preview_ui,node_user toneBlue
class node_project_registration,node_project_preview,node_preview_builder,node_project_records,node_engineer_records,node_project_extensions toneAmber
class node_agent_workflows,node_change_requests,node_scrutiny,node_complaints,node_rti toneMint
class node_search,node_ratings,node_chat_faq toneRose
class node_database,node_operator toneIndigo
```

## Components

### Web interface

- [React application](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/FRONTEND/src/App.jsx): `FRONTEND/src/App.jsx`
- [HTTP client](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/FRONTEND/src/api/api.js): `FRONTEND/src/api/api.js`
- [Project preview UI](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/FRONTEND/src/pages/ProjectPreview.jsx): `FRONTEND/src/pages/ProjectPreview.jsx`

### Project workflows

- [Project registration](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/project_registration_controller.py): `BACKEND/app/controllers/project_registration_controller.py`
- [Project preview route](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/project_preview_controller.py): `BACKEND/app/controllers/project_preview_controller.py`
- [Preview data builder](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/project_preview_data_controller.py): `BACKEND/app/controllers/project_preview_data_controller.py`
- [Project records](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/models/project_registration_model.py): `BACKEND/app/models/project_registration_model.py`
- [Engineer records](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/models/engineer.py): `BACKEND/app/models/engineer.py`
- [Project lifecycle](https://github.com/eswarimadhavarapu/ap_rera_project/tree/dev/BACKEND/app/controllers): `BACKEND/app/controllers`

### Regulatory services

- [Agent workflows](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/agent_registration_controller.py): `BACKEND/app/controllers/agent_registration_controller.py`
- [Change requests](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/change_request_controller.py): `BACKEND/app/controllers/change_request_controller.py`
- [Application scrutiny](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/agent_scrutiny_controller.py): `BACKEND/app/controllers/agent_scrutiny_controller.py`
- [Complaints](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/complint_controller.py): `BACKEND/app/controllers/complint_controller.py`
- [RTI requests](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/controllers/rti_controller.py): `BACKEND/app/controllers/rti_controller.py`

### Portal services

- [Search](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/services/search_service.py): `BACKEND/app/services/search_service.py`
- [Project ratings](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/services/project_rating_service.py): `BACKEND/app/services/project_rating_service.py`
- [Chat and FAQs](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/services/chat_service.py): `BACKEND/app/services/chat_service.py`

### Persistence

- [SQLAlchemy database](https://github.com/eswarimadhavarapu/ap_rera_project/blob/dev/BACKEND/app/models/database.py): `BACKEND/app/models/database.py`

### Other components

- **Portal user**
- **Portal operator**

## Connections

- Portal user → React application: uses
- React application → Project preview UI: presents
- Project preview UI → HTTP client: requests preview
- HTTP client → Project preview route: sends HTTP request
- Project preview route → Preview data builder: builds preview (evidence: `BACKEND/app/controllers/project_preview_controller.py`)
- Preview data builder → SQLAlchemy database: queries records (evidence: `BACKEND/app/controllers/project_preview_data_controller.py`)
- Project preview route → Project records: fetches registration (evidence: `BACKEND/app/controllers/project_preview_controller.py`)
- Project preview route → Engineer records: imports model (evidence: `BACKEND/app/controllers/project_preview_controller.py`)
- Portal operator → Project registration: submits application
- Portal operator → Project lifecycle: manages lifecycle
- Portal operator → Agent workflows: registers agent
- Portal operator → Change requests: requests changes
- Portal operator → Application scrutiny: reviews applications
- Portal operator → Complaints: handles complaints
- Portal operator → RTI requests: handles RTI
- Portal user → Search: searches portal
- Portal user → Project ratings: rates projects
- Portal user → Chat and FAQs: seeks help
