The Grand Project — Architecture Summary

This file is a concise implementation map. `GRAND-PROJECT-SPECIFICATION.md` remains authoritative.

Layers

```text

Identity

└── Central Authentication / SSO

Framework

├── Common Application Framework

└── Administration Portal

Core System Services

├── Update Server

├── Backup / Restore Server

├── Storage Server

└── Analytics Server

Plugin Modules

├── Asset Registry

├── Suppliers

├── Products

├── ServiceVault

│ ├── Customer Portal

│ └── Technician Portal

├── OpsRoom

├── Partner Portal

├── Supplier Portal

├── Business Intelligence & Reporting

├── Website Builder

├── E-commerce

├── Payments & Billing

├── Invoice Generation

├── Lead Pipeline

├── Project Tendering

├── Inventory Tracking

├── Order Processing

└── Developer Platform

```

Core rule

Core provides platform capability. Plugin Modules provide business functionality.

Request path

```text

Request

→ Bootstrap

→ Authentication

→ User/Company Context

→ Routing

→ Permission/Policy

→ Plugin/Framework Service

→ Response

→ Audit

```

Cross-plugin interaction

Prefer:

```text

Framework service/capability

API

Event

Queue

Workflow

```

Never:

```text

direct SQL into another plugin

direct include of another plugin's internals

```

Data rule

One authoritative owner per record. Other modules reference, cache derived values, or store historical snapshots.

Update rule

No live change without a pre-created restore path.