# Corporate Data Model Decision

Date: 2026-05-08

## Decision

`Organization` is the official and canonical model for institutions and corporate/B2B accounts.

Canonical tables:

- `organizations`
- `organization_members`
- `org_employees`
- `org_enrollments`
- `org_audit_logs`

## Legacy Tables

The following structures are legacy and must not be used for new corporate features:

- `companies`
- `users.company_id`
- `companies.agreement_path`

They are not deleted in this phase because production data may exist. They remain compatibility-only until a migration/retirement plan is approved.

## Admin Corporate Dashboard Decision

`Admin\Corporate\CorporateDashboard` must not depend on `App\Models\Company` because that model is absent. The least-breaking correction is to move the component to `Organization` so any future route to that component remains safe and aligned with the canonical model.

## Future Direction

Future corporate proposals, agreements, billing, reports, and cohort ownership should be linked to `organization_id`, not `company_id`.