# 00 — Table of Contents

```yaml
document_id: SPEC-00
status: locked
```

**System:** mou.cinegrid.net — Hybrid Film & Media Agreement Management Platform (Nepal-first)
**Purpose of this document:** A single, clickable map of every file in `docs/spec/`. This is the entry point for anyone new to the pack — start at §1 and follow the Reading Order, or jump directly to the section you need. See [`README.md`](./README.md) for the locked product decisions and ownership model that govern this entire pack.

---

## 1. Foundation Chapters

| # | File | Summary |
|---|---|---|
| 00 | [00-toc.md](./00-toc.md) | This document |
| 01 | [01-vision-srs.md](./01-vision-srs.md) | Vision, goals, non-goals, success metrics, stakeholders, assumptions, constraints, Nepal context, disclaimer |
| 02 | [02-personas-accounts.md](./02-personas-accounts.md) | Full persona catalog, tenancy model, account lifecycle, identity verification tiers |
| 03 | [03-information-architecture.md](./03-information-architecture.md) | Navigation, full URL map, document state machine, mobile vs. desktop |
| 04 | [04-domain-model.md](./04-domain-model.md) | Canonical entity/relationship model, table catalog, retention, migration ordering |
| 05 | [05-agreement-types.md](./05-agreement-types.md) | Type A Crew Engagement vs. Type B Client Service architecture |

---

## 2. Professions & Clauses

### 2.1 Profession Catalog (118 Roles + Governance)

| File | Summary |
|---|---|
| [professions/_index.md](./professions/_index.md) | Master index — department taxonomy, Universal Skeleton (U-01–U-25), uniqueness governance, CI overlap gate, High-Risk Roles Registry |
| [professions/_uniqueness-matrix.md](./professions/_uniqueness-matrix.md) | Per-department sibling differentiation matrix |
| [professions/client-service-production-agreement.md](./professions/client-service-production-agreement.md) | Type B architecture — Client Skeleton (C-Series) |

**118 individual profession files** (all under `professions/`, kebab-case, one per role) — see [`professions/_index.md` §6](./professions/_index.md#6-profession-catalog-by-department) for the full department-grouped list with clause-prefix and agreement-family columns. Representative entries: [director.md](./professions/director.md), [actor.md](./professions/actor.md), [dop-cinematographer.md](./professions/dop-cinematographer.md), [drone-operator.md](./professions/drone-operator.md), [child-artist.md](./professions/child-artist.md), [influencer.md](./professions/influencer.md), [producer.md](./professions/producer.md) — and 111 more spanning Direction, Producing, Camera, Lighting, Sound, Post-Production, Art Department, Costume & HMU, Talent, Digital & Creator Economy, Logistics & Unit Support, and Specialist/Consulting departments.

### 2.2 Clause Library

| File | Summary |
|---|---|
| [clauses/catalog.md](./clauses/catalog.md) | 355+ reusable global clauses across 30 categories (PAY, LEG, CON, INS, TRV, ACC, EQP, TRM, IP, HSE, PRI, DEL, CRV, GOV, TAX, CND, SAF, EMG, INT, CHD, DRN, AI, DIG, NFT, VP, LED, MOC, CLD, and more) |
| [clauses/conflict-rules.md](./clauses/conflict-rules.md) | Conflict types (HARD/SOFT/REQ/SUP), resolution precedence, detection algorithm, UX resolution flow |
| [clauses/role-specific-packs.md](./clauses/role-specific-packs.md) | Index over role-pack prefixes, cross-links to `professions/`, High-Risk Role Pack review governance |

### 2.3 Variables

| File | Summary |
|---|---|
| [variables/dictionary.md](./variables/dictionary.md) | Canonical merge-tag registry (850+ tags), resolution rules, defaults, deprecated tags |
| [variables/resolution-pipeline.md](./variables/resolution-pipeline.md) | 10-stage variable resolution pipeline, trigger points, performance targets, error codes |

---

## 3. Functional Requirements (FRD)

| File | Summary |
|---|---|
| [frd/00-frd-index.md](./frd/00-frd-index.md) | FRD navigation, ID block allocation, traceability convention |
| [frd/01-functional-requirements.md](./frd/01-functional-requirements.md) | FR-001–FR-240: numbered, testable requirements across all 25 modules plus cross-cutting Nepal-compliance/tenancy/non-functional requirements |

---

## 4. System Modules (1–27)

| File | Summary |
|---|---|
| [modules/INDEX.md](./modules/INDEX.md) | Master module catalog, dependency graph, cross-cutting concerns, reading order |
| [modules/authentication.md](./modules/authentication.md) | Company/Platform/External-tier identity, MFA, password reset, signer token auth |
| [modules/dashboard.md](./modules/dashboard.md) | Role-scoped landing experience, widget architecture, Business Unit filtering |
| [modules/document-management.md](./modules/document-management.md) | Agreement creation, list/filter/organization, Type A↔B traceability, attachments |
| [modules/profession-templates.md](./modules/profession-templates.md) | Markdown-to-product ingestion pipeline, publishing, template selection, overrides |
| [modules/dynamic-form-builder.md](./modules/dynamic-form-builder.md) | Schema-driven wizard rendering, conditional fields, Type B matrix grids |
| [modules/clause-library.md](./modules/clause-library.md) | Clause versioning/publishing, selection/assembly, company customization, conflict engine |
| [modules/variable-engine.md](./modules/variable-engine.md) | Live draft resolution, pre-sign finalization, tenant-level default overrides |
| [modules/document-builder.md](./modules/document-builder.md) | Document assembly, section/annexure ordering, draft-vs-frozen state transitions |
| [modules/rich-text-editor.md](./modules/rich-text-editor.md) | TipTap/ProseMirror editing, negotiation/tracked-changes mode, inline comments |
| [modules/pdf-docx-export.md](./modules/pdf-docx-export.md) | Live preview, final export, watermark integration, annexure rendering |
| [modules/digital-signature.md](./modules/digital-signature.md) | Signature request issuance, signer auth/identity tiers, signing ceremony, evidence |
| [modules/version-control.md](./modules/version-control.md) | Version bumping, named negotiation rounds, diff viewing, post-execution amendments |
| [modules/audit-logs.md](./modules/audit-logs.md) | Universal logging contract, Platform vs. tenant audit scope, retention |
| [modules/admin-panel.md](./modules/admin-panel.md) | Platform-tier surface — tenant verification, support access, content curator delegation |
| [modules/template-management.md](./modules/template-management.md) | Company-tier override editing UI, review queue |
| [modules/role-permissions.md](./modules/role-permissions.md) | Role/permission resolution architecture, custom roles, nav filtering, PII grants |
| [modules/user-settings.md](./modules/user-settings.md) | Personal profile, security settings, notification preferences, Company Switcher |
| [modules/company-branding.md](./modules/company-branding.md) | Logo/color/letterhead, PDF typography, branded Signer Portal/emails |
| [modules/watermark.md](./modules/watermark.md) | Watermark profile configuration, automatic application, executed-copy exception |
| [modules/approval-workflow.md](./modules/approval-workflow.md) | Default Type A/B chains, custom workflows, approver experience, Owner override |
| [modules/notifications.md](./modules/notifications.md) | Multi-channel dispatch, Company policy floors, digests/reminders |
| [modules/document-sharing.md](./modules/document-sharing.md) | Share links, external comment-only access, revocation |
| [modules/search-filters.md](./modules/search-filters.md) | Per-tenant Meilisearch indices, permission-filtered query execution, typeahead |
| [modules/reports-analytics.md](./modules/reports-analytics.md) | Standard reports, governance metrics, export & scheduled delivery |
| [modules/future-ai-integrations.md](./modules/future-ai-integrations.md) | Guarded, human-gated AI scope; hard boundaries on autonomous AI action |

---

## 5. Database

| File | Summary |
|---|---|
| [db/schema.md](./db/schema.md) | Legacy/companion schema notes (historical) |
| [db/erd.md](./db/erd.md) | Entity-relationship diagram reference |

> **Authoritative schema note:** [`04-domain-model.md`](./04-domain-model.md) is the canonical, single-source-of-truth entity/relationship model for engineering purposes (MySQL 8 / Laravel 11 Eloquent conventions, `companies`-based tenancy). `db/schema.md` predates that consolidation; where the two differ, `04-domain-model.md` governs, per its own self-declared authority in §1.

---

## 6. UX

| File | Summary |
|---|---|
| [ux/01-ux-principles.md](./ux/01-ux-principles.md) | Core UX principles, visual language, interaction patterns, accessibility |
| [ux/screens/INDEX.md](./ux/screens/INDEX.md) | Screen catalog, global layout, shared components, routing map |
| [ux/screens/dashboard.md](./ux/screens/dashboard.md) | Dashboard screen spec |
| [ux/screens/wizard.md](./ux/screens/wizard.md) | Agreement creation wizard screen spec |
| [ux/screens/editor.md](./ux/screens/editor.md) | Agreement editor screen spec |
| [ux/screens/preview.md](./ux/screens/preview.md) | Preview screen spec |
| [ux/screens/sign.md](./ux/screens/sign.md) | Sign screen spec |
| [ux/screens/admin.md](./ux/screens/admin.md) | Admin screen spec |
| [ux/screens/settings.md](./ux/screens/settings.md) | Settings screen spec |
| [ux/screens/approvals.md](./ux/screens/approvals.md) | Approvals inbox screen spec |
| [ux/screens/empty-states.md](./ux/screens/empty-states.md) | Empty-state patterns |

---

## 7. API, Security & Roadmap

| File | Summary |
|---|---|
| [api/api-surface.md](./api/api-surface.md) | Full REST API surface, conventions, webhooks, error codes |
| [security/security-compliance.md](./security/security-compliance.md) | Nepal regulatory framework, ETA 2063 compliance, encryption, RBAC, incident response |
| [roadmap.md](./roadmap.md) | Phase 0–6 delivery plan, risk register, success metrics |

---

## 8. Reading Order (Recommended, First-Time Readers)

1. [README.md](./README.md) — locked decisions, directory map, ownership
2. [00-toc.md](./00-toc.md) — this document
3. [01-vision-srs.md](./01-vision-srs.md) — why the product exists
4. [02-personas-accounts.md](./02-personas-accounts.md) — who uses it
5. [03-information-architecture.md](./03-information-architecture.md) — navigation & states
6. [04-domain-model.md](./04-domain-model.md) — core entities
7. [05-agreement-types.md](./05-agreement-types.md) — Type A vs. Type B
8. [professions/_index.md](./professions/_index.md) — 118-role catalog
9. [clauses/catalog.md](./clauses/catalog.md) + [clauses/role-specific-packs.md](./clauses/role-specific-packs.md) — clause library
10. [variables/dictionary.md](./variables/dictionary.md) — merge tags
11. [modules/INDEX.md](./modules/INDEX.md) — Modules 1–27 (then read modules per the dependency-ordered sequence in that file)
12. [frd/00-frd-index.md](./frd/00-frd-index.md) → [frd/01-functional-requirements.md](./frd/01-functional-requirements.md) — numbered FRs
13. [ux/01-ux-principles.md](./ux/01-ux-principles.md) — UX
14. [security/security-compliance.md](./security/security-compliance.md) — security & Nepal law
15. [roadmap.md](./roadmap.md) — phased delivery

---

## 9. Directory Map (Current, Post-Completion)

```
docs/spec/
  README.md                        ← locked decisions, ownership
  00-toc.md                        ← you are here
  01-vision-srs.md
  02-personas-accounts.md
  03-information-architecture.md
  04-domain-model.md
  05-agreement-types.md
  professions/                     ← 118 role files + _index + _uniqueness-matrix + Type B
  clauses/                         ← catalog, conflict-rules, role-specific-packs
  variables/                       ← dictionary, resolution-pipeline
  frd/                             ← 00-frd-index, 01-functional-requirements
  modules/                         ← INDEX + 25 module files (27 named capabilities)
  db/                              ← schema, erd (04-domain-model.md is authoritative)
  ux/                              ← 01-ux-principles + screens/
  api/                             ← api-surface
  security/                        ← security-compliance
  roadmap.md
```

## 10. Cross-References

- Locked product decisions this entire pack implements: [`README.md`](./README.md#locked-product-decisions)
- Authoring standard and nine-part module template: [`README.md`](./README.md#authoring-standard)
- Change management policy for this documentation tree: [`README.md`](./README.md#change-management)