Estate mail archive
The company-mail workspace is a read-only view of Estate Data Hub’s archive. Toolora indexes a bounded projection, applies company/mailbox policy and links messages to internal business records. It does not operate an IMAP/Gmail client, send replies or turn an address match into a confirmed customer relationship. Original preservation owns byte identity and coverage; this reference owns connection, reader and projection behavior.
Binding and setup contract
Section titled “Binding and setup contract”An archive binding names the Toolora company, archive account, cell, connection and attested fingerprint. The setup page lists only accounts allowlisted and mapped by the archive owner. Tenant administrators cannot supply arbitrary external account identifiers. Adding or reindexing rechecks the directory and live attestation. A changed account/cell/connection stops the operation; a stale fingerprint with unchanged verified identity can be refreshed without resetting the sync cursor.
Managing this policy requires tenant:update and roles:manage. Enabling reads
records a purpose, one responsible active company administrator and the archive’s
retention policy. The responsible person is accountable; that selection does not
exclude the other eligible administrator readers.
Reader and feature policy
Section titled “Reader and feature policy”| Operation or setting | Reviewed boundary |
|---|---|
| List/read mailbox messages | Staff mail:read, active company, enabled/read-enabled binding and current active non-worker company-admin reader |
| Open from customer, opportunity or project | The same mailbox checks plus read authority over the named target |
| Add/remove internal link | Mailbox authority and the target operation’s resource/capability checks; no source-mailbox mutation |
| Add a communications mailbox | Archive-attested setup; bounded projection sync; document copying/intake and agent tools remain disabled |
| Enable AI quote proposal use | Explicit mailbox policy plus quote permissions, current source links and reader access |
Current reader eligibility is checked on each request. Previously returned text
or downloaded files cannot be recalled by revoking the role. Source deletion is
observed when its tombstone reaches the projection, not at the instant an external
mailbox changes. The recorded mail-source-policy and source_observation.lifecycle
contract supplies retention/deletion meaning; Toolora must not invent a fixed
expiry interval.
Projection and internal links
Section titled “Projection and internal links”Projection records preserve source lifecycle, readable body text, attachment
metadata, email-date status and coverage. Archive event kind values identify
observations such as metadata/original verification or gaps; they are not separate
message categories that search may silently discard. Indexed body text is bounded.
On-demand original extraction can improve the detail view without rewriting the
search index.
Address matches are suggestions. A staff member explicitly links a message to a customer, opportunity or project; removing that link changes Toolora’s association, not the source message. Customer and project views reuse the reader, so linking does not publish the message in the customer portal. A standalone mail proposal and an opportunity proposal also retain their distinct identities and source permissions. AI context explains bounded attachment selection.
Errors and recovery
Section titled “Errors and recovery”For synthetic Company A, a mailbox row with mail_read_enabled=false is not
readable merely because indexing succeeded. Conversely, a readable projection may
still report incomplete original coverage. Diagnose those separately: verify the
reader, binding/policy, attestation, projection checkpoint and byte availability.
Never repair a mismatch by allowing an arbitrary source account or broadening the
reader set.
Mail routes return unavailable/not-found results for inaccessible bindings and unverifiable attachments. The response does not establish whether a provider lost a message or the projection simply lacks verified bytes. Reindex using the existing attested identity and preserve checkpoint semantics. Test fixtures should exercise active-reader allow, foreign company/disabled-reader deny, source tombstone and hash/MIME mismatch using synthetic mail. The delivery PR records executions; this source review performs no real-mail read, link change or send.