System
Tutorials.

A comprehensive step-by-step guide to operating the Core ERP platform. Learn how to initialize your workspace, execute neural predictions, and interpret the algorithmic health scores.

Step 1.1: Authentication

Accessing the ERP requires a strictly validated JSON Web Token (JWT). The system utilizes an access-refresh token lifecycle. Upon your first session, you must establish node access via the central `Access Terminal`.

Action: Authenticate

Navigate to the Sign In route.
Input your administrator email (e.g., yousuf.h.faysal@foxmenstudio.com).
Input the initialization passphrase (e.g., Faisal1234).
Upon successful handshake, the system will inject the cryptographic JWT into your LocalStorage layer and redirect you to the Executive Dashboard.

Step 1.2: Corporate Synchronization

Because CORE enforces row-level multi-tenancy hardware isolation, logging in without an assigned company limits system access entirely.

Critical Authorization Step

If the Dashboard displays "Failed to load AI Health Metrics" or the Inventory page shows a "Request failed with status code 403", your cached JWT lacks a `company_id`.Resolution: Simply log out and log back in to pull down your synchronized company identity.

Step 2.1: Interpreting AI Health

The Executive Dashboard immediately queries back-end Python microservices to calculate a dynamic `0` to `100` health score. This is not a static average. It is computed actively against historical data.

Mock API Trajectory

GET /api/v1/accounts/companies/{id}/health/
Response:
{
  "score": 87.4,
  "status": "Green",
  "explanation": "Revenue velocity is outpacing operational friction.",
  "metrics": {
    "revenue_growth_pct": 12.5,
    "operating_cash_ratio": 1.2,
    "inventory_turnover_rate": 4.2
  }
}

The top-level card shifts color dynamically: Green (High stability), Yellow (Minor efficiency loss), or Red (Critical capital/stockout risk).

Step 2.2: Generating Forecasts

Navigate to Inventory & AI via the left-hand navigation sidebar.

Locate the XGBoost Prophecy panel in the upper right.
Wait for the loading indicator; the system is actively polling the FastAPI AI microservice (`port 8001`).
Review the line-chart rendering. The Y-Axis represents predicted demand volume, while the X-Axis spans the upcoming 30 day window.
Use this predictive curve to trigger wholesale supplier orders before your current kinetic stock dips below the reorder threshold.

Troubleshooting: The 403 Forbidden

Core ERP enforces absolute cryptographic isolation between companies. If you encounter a `403 Forbidden` wall when clicking 'Sales' or 'Inventory', your session lacks context.

# Solution Checklist

[ ] Did the admin assign your User object a Company Foreign Key?
[ ] Did you generate a new JWT token AFTER the company assignment?
[ ] If not, click "LOGOUT" in the top right user dropdown and authenticate again.

System Tutorials.