Task E: Quotation Production Module

1. Files Added

crm_quotations
- organization-scoped quotation master with document code, customer/contact/enquiry linkage, pricing header, status, revision metadata, and soft-delete columns
crm_quotation_items
- server-calculated line items under quotation
crm_quotation_customers
- related parties such as owner, consultant, contractor, and billing
crm_quotation_topics
- quotation document sections such as scope, exclusions, and payment
crm_quotation_topic_items
- topic bullet items stored under each section
crm_quotation_followups
- post-send follow-up timeline under quotation
crm_quotation_attachments
- metadata-only attachment registry for future file-storage integration

/dashboard/crm/quotations
- production list with React Query, nuqs filters, create button, edit/view/delete actions
- filters: search, status, quotation type, branch, customer, enquiry, hot project
/dashboard/crm/quotations/[id]
- detail page with tabs: Overview, Items, Customers, Topics, Follow-ups, Attachments, Activity, Approval Placeholder, Document Preview Placeholder
- revision chain card with create-revision action
/dashboard/crm/enquiries/[id]
- related quotations tab now shows real quotation links for the enquiry
/dashboard/crm/customers/[id]
- related documents tab now shows both enquiries and quotations for the customer

Admin defaults include the full quotation permission set. Regular users inherit read access only unless their membership permissions are extended.

quotation create/update/delete writes audit entries with entityType = crm_quotation
item create/update/delete writes audit entries with entityType = crm_quotation_item
related customer create/update/delete writes audit entries with entityType = crm_quotation_customer
topic create/update/delete writes audit entries with entityType = crm_quotation_topic
follow-up create/update/delete writes audit entries with entityType = crm_quotation_followup
attachment metadata create/update/delete writes audit entries with entityType = crm_quotation_attachment
quotation detail activity tab now surfaces all quotation-side audit mutations together

quotation create uses generateNextDocumentCode({ documentType: 'quotation' })
revisions also consume the same document sequence and keep parentQuotationId linkage
item totals are calculated on the server
quotation subtotal, tax, and total are refreshed from current line items after item mutations

quotation create/update validates customer, contact, enquiry, branch, and salesman membership against the active organization
selecting an enquiry in the quotation form auto-fills customer/contact/project context where available
enquiry detail now links to real quotations instead of the old Task D placeholder
customer detail now links to both related enquiries and related quotations

quotation item taxRate is stored per line, but current aggregate total refresh still uses quotation-header tax for the final quote summary rather than a mixed per-line tax rollup
attachment handling is metadata-only; there is still no binary upload/storage pipeline
revision creation copies header, items, customers, and topics, but does not snapshot follow-ups or attachments
there are still no database foreign keys between quotation tables and the linked CRM entities; organization scoping is enforced in application logic