# adnanummer/ncct architecture

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

- Interactive diagram: https://gitdiagram.com/adnanummer/ncct
- Repository: https://github.com/adnanummer/ncct

## Overview

NCCT DXB is a server-rendered Django homepage and enquiry workflow, not a multi-page catalogue. Visitors browse homepage content and submit an enquiry; the server validates and protects the submission before storing it for staff review. The architecture also includes editable categories, featured products and projects, capabilities, published metrics, structured data, and one-time content seeding. Edges reflect the shown homepage and enquiry calls plus README-documented behavior; unsampled template and admin wiring is not expanded.

Main entry points: [`core/views.py`](https://github.com/adnanummer/ncct/blob/main/core/views.py) (Homepage assembly), [`core/management/commands/seed_homepage.py`](https://github.com/adnanummer/ncct/blob/main/core/management/commands/seed_homepage.py) (Homepage seeding), [`enquiries/views.py`](https://github.com/adnanummer/ncct/blob/main/enquiries/views.py) (Enquiry endpoint), [`enquiries/security.py`](https://github.com/adnanummer/ncct/blob/main/enquiries/security.py) (Submission security)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Homepage experience"]
  node_routes["URL routing<br/>[urls.py]"]
  node_homepage["Homepage assembly<br/>[views.py]"]
  node_page["Rendered homepage<br/>[home.html]"]
  node_schema["Structured data<br/>[structured_data.py]"]
  node_sitejs["Homepage interactions<br/>[site.js]"]
end

subgraph group_content["Managed content"]
  node_homecontent[("Homepage settings<br/>[models.py]")]
  node_capabilities[("Capabilities<br/>[models.py]")]
  node_metrics[("Verified metrics<br/>[models.py]")]
  node_categories[("Lighting categories<br/>[models.py]")]
  node_products[("Verified products<br/>[models.py]")]
  node_projects[("Featured projects<br/>[models.py]")]
  node_imagecontent["Image content<br/>[models.py]"]
end

subgraph group_inquiry["Enquiry workflow"]
  node_enquiryform["Form validation<br/>[forms.py]"]
  node_security["Submission security<br/>[security.py]"]
  node_submit["Enquiry endpoint<br/>[views.py]"]
  node_enquiries[("Enquiry records<br/>[models.py]")]
  node_ratewindows[("Rate windows<br/>[models.py]")]
end

subgraph group_operations["Content operations"]
  node_seed["Homepage seeding<br/>[seed_homepage.py]"]
end

node_visitor(("Visitor"))
node_staff(("Content administrators"))

node_visitor -->|"requests page"| node_routes
node_routes -->|"routes homepage"| node_homepage
node_routes -->|"routes submissions"| node_submit
node_homepage -->|"reads"| node_homecontent
node_homepage -->|"reads"| node_capabilities
node_homepage -->|"reads published"| node_metrics
node_homepage -->|"reads"| node_categories
node_homepage -->|"reads featured"| node_products
node_homepage -->|"reads featured"| node_projects
node_homepage -->|"initializes form"| node_enquiryform
node_homepage -->|"issues token"| node_security
node_homepage -->|"renders"| node_page
node_page -->|"renders JSON-LD"| node_schema
node_visitor -->|"uses interactions"| node_sitejs
node_visitor -->|"submits enquiry"| node_submit
node_submit -->|"validates"| node_enquiryform
node_submit -->|"checks token and rate"| node_security
node_submit -->|"stores submission"| node_enquiries
node_security -->|"updates counts"| node_ratewindows
node_security -->|"checks duplicates"| node_enquiries
node_staff -->|"reviews records"| node_enquiries
node_staff -->|"edits content"| node_homecontent
node_staff -->|"edits content"| node_categories
node_staff -->|"edits content"| node_products
node_staff -->|"edits content"| node_projects
node_staff -->|"edits content"| node_capabilities
node_staff -->|"publishes"| node_metrics
node_seed -->|"initializes"| node_homecontent
node_seed -->|"initializes"| node_categories
node_seed -->|"initializes"| node_products
node_seed -->|"initializes"| node_projects
node_seed -->|"initializes"| node_capabilities
node_homecontent -->|"inherits"| node_imagecontent
node_categories -->|"inherits"| node_imagecontent
node_products -->|"inherits"| node_imagecontent
node_projects -->|"inherits"| node_imagecontent

click node_routes "https://github.com/adnanummer/ncct/blob/main/config/urls.py"
click node_homepage "https://github.com/adnanummer/ncct/blob/main/core/views.py"
click node_page "https://github.com/adnanummer/ncct/blob/main/templates/home.html"
click node_schema "https://github.com/adnanummer/ncct/blob/main/core/templatetags/structured_data.py"
click node_sitejs "https://github.com/adnanummer/ncct/blob/main/static/js/site.js"
click node_homecontent "https://github.com/adnanummer/ncct/blob/main/core/models.py"
click node_capabilities "https://github.com/adnanummer/ncct/blob/main/core/models.py"
click node_metrics "https://github.com/adnanummer/ncct/blob/main/core/models.py"
click node_categories "https://github.com/adnanummer/ncct/blob/main/products/models.py"
click node_products "https://github.com/adnanummer/ncct/blob/main/products/models.py"
click node_projects "https://github.com/adnanummer/ncct/blob/main/projects/models.py"
click node_imagecontent "https://github.com/adnanummer/ncct/blob/main/core/models.py"
click node_enquiryform "https://github.com/adnanummer/ncct/blob/main/enquiries/forms.py"
click node_security "https://github.com/adnanummer/ncct/blob/main/enquiries/security.py"
click node_submit "https://github.com/adnanummer/ncct/blob/main/enquiries/views.py"
click node_enquiries "https://github.com/adnanummer/ncct/blob/main/enquiries/models.py"
click node_ratewindows "https://github.com/adnanummer/ncct/blob/main/enquiries/models.py"
click node_seed "https://github.com/adnanummer/ncct/blob/main/core/management/commands/seed_homepage.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_routes,node_homepage,node_page,node_schema,node_sitejs toneBlue
class node_homecontent,node_capabilities,node_metrics,node_categories,node_products,node_projects,node_imagecontent toneAmber
class node_enquiryform,node_security,node_submit,node_enquiries,node_ratewindows toneMint
class node_seed toneRose
class node_visitor,node_staff toneIndigo
```

## Components

### Homepage experience

- [URL routing](https://github.com/adnanummer/ncct/blob/main/config/urls.py): `config/urls.py`
- [Homepage assembly](https://github.com/adnanummer/ncct/blob/main/core/views.py): `core/views.py`
- [Rendered homepage](https://github.com/adnanummer/ncct/blob/main/templates/home.html): `templates/home.html`
- [Structured data](https://github.com/adnanummer/ncct/blob/main/core/templatetags/structured_data.py): `core/templatetags/structured_data.py`
- [Homepage interactions](https://github.com/adnanummer/ncct/blob/main/static/js/site.js): `static/js/site.js`

### Managed content

- [Homepage settings](https://github.com/adnanummer/ncct/blob/main/core/models.py): `core/models.py`
- [Capabilities](https://github.com/adnanummer/ncct/blob/main/core/models.py): `core/models.py`
- [Verified metrics](https://github.com/adnanummer/ncct/blob/main/core/models.py): `core/models.py`
- [Lighting categories](https://github.com/adnanummer/ncct/blob/main/products/models.py): `products/models.py`
- [Verified products](https://github.com/adnanummer/ncct/blob/main/products/models.py): `products/models.py`
- [Featured projects](https://github.com/adnanummer/ncct/blob/main/projects/models.py): `projects/models.py`
- [Image content](https://github.com/adnanummer/ncct/blob/main/core/models.py): `core/models.py`

### Enquiry workflow

- [Form validation](https://github.com/adnanummer/ncct/blob/main/enquiries/forms.py): `enquiries/forms.py`
- [Submission security](https://github.com/adnanummer/ncct/blob/main/enquiries/security.py): `enquiries/security.py`
- [Enquiry endpoint](https://github.com/adnanummer/ncct/blob/main/enquiries/views.py): `enquiries/views.py`
- [Enquiry records](https://github.com/adnanummer/ncct/blob/main/enquiries/models.py): `enquiries/models.py`
- [Rate windows](https://github.com/adnanummer/ncct/blob/main/enquiries/models.py): `enquiries/models.py`

### Content operations

- [Homepage seeding](https://github.com/adnanummer/ncct/blob/main/core/management/commands/seed_homepage.py): `core/management/commands/seed_homepage.py`

### Other components

- **Visitor**
- **Content administrators**

## Connections

- Visitor → URL routing: requests page (evidence: `README.md`)
- URL routing → Homepage assembly: routes homepage (evidence: `config/urls.py`)
- URL routing → Enquiry endpoint: routes submissions (evidence: `config/urls.py`)
- Homepage assembly → Homepage settings: reads (evidence: `core/views.py`)
- Homepage assembly → Capabilities: reads (evidence: `core/views.py`)
- Homepage assembly → Verified metrics: reads published (evidence: `core/views.py`)
- Homepage assembly → Lighting categories: reads (evidence: `core/views.py`)
- Homepage assembly → Verified products: reads featured (evidence: `core/views.py`)
- Homepage assembly → Featured projects: reads featured (evidence: `core/views.py`)
- Homepage assembly → Form validation: initializes form (evidence: `core/views.py`)
- Homepage assembly → Submission security: issues token (evidence: `core/views.py`)
- Homepage assembly → Rendered homepage: renders (evidence: `core/views.py`)
- Rendered homepage → Structured data: renders JSON-LD
- Visitor → Homepage interactions: uses interactions (evidence: `README.md`)
- Visitor → Enquiry endpoint: submits enquiry (evidence: `README.md`)
- Enquiry endpoint → Form validation: validates (evidence: `enquiries/views.py`)
- Enquiry endpoint → Submission security: checks token and rate (evidence: `enquiries/views.py`)
- Enquiry endpoint → Enquiry records: stores submission (evidence: `enquiries/views.py`)
- Submission security → Rate windows: updates counts (evidence: `enquiries/security.py`)
- Submission security → Enquiry records: checks duplicates (evidence: `enquiries/views.py`)
- Content administrators → Enquiry records: reviews records (evidence: `README.md`)
- Content administrators → Homepage settings: edits content (evidence: `README.md`)
- Content administrators → Lighting categories: edits content (evidence: `README.md`)
- Content administrators → Verified products: edits content (evidence: `README.md`)
- Content administrators → Featured projects: edits content (evidence: `README.md`)
- Content administrators → Capabilities: edits content (evidence: `README.md`)
- Content administrators → Verified metrics: publishes (evidence: `README.md`)
- Homepage seeding → Homepage settings: initializes (evidence: `core/management/commands/seed_homepage.py`)
- Homepage seeding → Lighting categories: initializes (evidence: `core/management/commands/seed_homepage.py`)
- Homepage seeding → Verified products: initializes (evidence: `core/management/commands/seed_homepage.py`)
- Homepage seeding → Featured projects: initializes (evidence: `core/management/commands/seed_homepage.py`)
- Homepage seeding → Capabilities: initializes (evidence: `core/management/commands/seed_homepage.py`)
- Homepage settings → Image content: inherits (evidence: `core/models.py`)
- Lighting categories → Image content: inherits (evidence: `products/models.py`)
- Verified products → Image content: inherits (evidence: `products/models.py`)
- Featured projects → Image content: inherits (evidence: `projects/models.py`)
