# BELAR Score — Simple Software Flow

## Main Flow

```text
Visitor / User
    ↓
Register or Log In
    ↓
Dashboard
    ↓
Add Property (when relevant)
    ↓
Create Assessment
    ↓
Choose Score Type
Renter / Landlord / Property / Property Manager
    ↓
Enter Subject + Five Dimension Scores
    ↓
Upload Supporting Evidence (optional)
    ↓
System Calculates Overall Score
    ↓
Assessment Goes to Admin Review
    ↓
Admin Approves / Rejects / Requests Information
    ↓
User Opens Printable Final Report
```

## User Roles

### Admin
- Sees all users, properties, leads and assessments.
- Reviews submitted assessments.
- Changes status to Under Review, Approved, Needs Information or Rejected.
- Can open every assessment report and supporting document.

### Landlord
- Adds rental properties.
- Creates renter, landlord, property or manager assessments.
- Sees only their own properties and assessments.

### Property Manager
- Adds managed properties.
- Creates and tracks assessments.
- Sees only their own account data.

### Property Owner / Investor
- Adds owned properties.
- Creates property and management-related assessments.

### Renter
- Can create an account, access the dashboard and create or view assessments attached to their own account.

## Scoring Logic

The user enters five values from 0 to 100:

1. Financial
2. Legal
3. Maintenance
4. Operational
5. Regulatory

The software calculates the rounded average.

```text
Overall Score = (Financial + Legal + Maintenance + Operational + Regulatory) / 5
```

Risk levels:

- 80–100: Low Risk
- 65–79: Moderate Risk
- 50–64: Elevated Risk
- 0–49: High Risk

The ranges are editable in `config/belar.php`.

## Assessment Status Flow

```text
Submitted
    ↓
Under Review
    ├── Approved
    ├── Needs Information
    └── Rejected
```

## Lead Generation Flow

```text
Public Homepage
    ↓
Request Demo Form
    ↓
Lead Saved in MySQL
    ↓
Admin → Leads
    ↓
BELAR Team Contacts Lead
```

## What This MVP Does Not Include

- Credit bureau integration
- Criminal-record API
- Automated background checks
- Stripe subscriptions
- Lease signing
- Rent collection
- Full property-management accounting
- AI approval or rejection

These can be added in later phases without changing the core Laravel structure.