IlumWeave Platform Whitepaper

Document version: 1.24 Platform version: development-v0.1.38-alpha (July 2026) Status: Living document — reflects shipped capabilities and the public roadmap

Executive summary

IlumWeave is a multi-domain operations platform built on a single conviction: the space between matters most. A successful real estate transaction is not only about the buyer or the seller — it is about everything that happens in between: vetting, handoffs, updates, and trust among every professional on the path.

We connect specialized property seller outlets with a vetted connector network — with honesty about who touches a lead, how information is used, where a transaction stands, and what happens next.

Property owners submit listings through focused public websites (RV parks, mobile home parks, foreclosure situations). Vetted Connectors use an integrated CRM to manage contacts, discover social intelligence, work leads, schedule calls, and collaborate across a shared contact graph — under staff oversight, fair reporting rules, and published policies.

The platform unifies:

• We Believe — a public mission on every outlet and at /mission: verified properties, vetted connectors, full documentation and signed agreements before anything moves forward, and seller-visible answers without chasing updates
• Transparent lead capture across branded seller outlets — clear disclaimers, no sold contact lists, honest status updates
• Team operations (roles, onboarding, referrals, billing) with visible permissions and accountability
• CRM (connections, leads, calendar, notes, imports) where shared contacts, private notes, and vetting protect network integrity
• AI-assisted research metered through ilumWeave Credits (SC) with upfront cost disclosure before every action
• Trust & safety (moderation, support tickets, account controls) so bad actors cannot hide behind opacity
• Self-serve help (FAQ, feedback, release notes, mission) so policies and capabilities stay public

IlumWeave is built on Laravel with a single codebase serving multiple hostnames, domain-aware branding, and a consistent authenticated experience at the operations hub.

We Believe

Nothing moves forward until it's verified.

When you submit your property, we confirm that you, your contact details, and your property information are real before anything happens next.

We verify properties and vet the people in the path. Every step has full documentation and signed agreements — nothing happens here until validation and verification are complete and a signed agreement is in place. You stay informed at every step — who has your information, what's happened, and what comes next.

We commit to:

• Verify every property — listings are validated before they move through the network
• Vet every connector — facilitators are reviewed before they work with seller leads
• Keep every step visible — status and handoffs you can see without chasing updates
• Document every step with signed agreements — verification comes first; only then does anything move forward

As a seller, you should always know:

• Who has my information?
• What verification has been done?
• Where is my submission now?
• What happens next?

Verification first. Signed agreements before action. Clear answers — no chasing updates for information that should already be visible.

Connectors grow the same verified network. Founding Connectors help test, vet, and expand ilumWeave — with lifetime platform access, earned AI credits, and an advisory voice on major decisions. ilumWeave retains final say on all platform choices.

On ilumweave.com, a Written agreements callout sits above the mission hero — linking to /mission and the published Membership Agreement. Outlet homepages show a compact mission summary with the same verification-and-agreements message.

This mission expands on the full Our Mission page (/mission) — seller and connector sections, founding program callout, and links to /founding. It is the test we run against features, policies, and handoffs — not a marketing slogan.

Our foundation: transparency, honesty, ethics, and integrity

Real estate has a long history of closed doors, unclear intermediaries, and sellers who never learn what happened to their information. IlumWeave exists to do better — by making the space between seller, buyer, and every professional visible, vetted, and spoken for (see We Believe above).

What transparency means here

Ethics and integrity in practice

• Honest intake — Each outlet describes what property type it serves and what submitters should expect. Forms include clear contact consent; guest and registered sellers can track progress without guessing.
• Verification before action — Phone, email, property address, and public records are checked before outreach or connector assignment. Nothing moves forward without validation and the right signed agreement in place.
• People, not profiles — Connectors are approved after admin review. Shared connections merge duplicates fairly; private notes stay private; research costs split transparently across members.
• No hidden economics — Property sellers stay free. Connectors see tier limits, SC balances, and green $ hints on AI actions before spending credits.
• Accountability — Moderation uses fair thresholds (one report alone does not hide someone). Staff review support tickets and product feedback. Suspension and ban reasons are communicated.
• Living documentation — FAQ, What's New, Future Updates, Our Mission (/mission), published agreements (Membership Agreement, Terms, Privacy), and this whitepaper describe what ships today and what is planned — not vaporware.

Transparency is not a marketing line. It is how we earn trust from sellers under pressure, connectors doing outreach, and everyone connected to a property transaction.

1. Problem statement

Specialized property sellers (RV parks, mobile home communities, distressed or foreclosure-adjacent situations) need outlet-specific messaging and forms—not a generic CRM landing page. They also deserve honesty: who will contact them, how their data is used, and where their submission stands.

At the same time, acquisition teams need:

• Reliable lead intake with abuse protection
• Attribution (referrals, campaigns, outlet source)
• A shared view of people in the network without duplicating records
• Tools to prepare for outreach (social discovery, personality signals from public posts)
• Clear roles so sellers, connectors, and staff each see the right tools
• Sustainable monetization for AI-heavy workflows without charging casual property sellers
• Operational transparency so sellers, connectors, and staff share a truthful picture of each lead

IlumWeave addresses this by combining outlet sites + operations hub + connector CRM + staff admin in one platform — with ethics and integrity designed in, not bolted on afterward.

2. Platform architecture

2.1 Multi-domain design

One Laravel application resolves the request hostname to a site profile (config/site_profiles.php). Each profile defines brand, SEO copy, hero content, property types, and outlet-specific form behavior.

Local development maps the same hostnames via Herd or equivalent so copy, emails, and OAuth callbacks stay domain-correct.

2.2 Technology stack

2.3 High-level system diagram

┌─────────────────────────────────────────────────────────────────────────┐
│                        Public seller outlets (HTTPS)                     │
│  RV · Mobile Home · Foreclosure · Land · Single Family · Multifamily    │
└───────────────────────────────┬─────────────────────────────────────────┘
                                │ property_leads, attachments, referrals
                                ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                     IlumWeave authenticated platform                     │
│  ┌─────────────┐  ┌──────────────┐  ┌────────────┐  ┌─────────────────┐ │
│  │ Onboarding  │  │ CRM          │  │ Billing/SC │  │ Admin & settings│ │
│  │ roles       │  │ leads/conns  │  │ gamification│  │ moderation     │ │
│  └─────────────┘  └──────────────┘  └────────────┘  └─────────────────┘ │
└───────────────────────────────┬─────────────────────────────────────────┘
                                │ email, calendar, AI APIs
                                ▼
┌─────────────────────────────────────────────────────────────────────────┐
│ Resend · Google (OAuth, Calendar, Contacts) · PayPal · Grok · OAuth IdPs │
└─────────────────────────────────────────────────────────────────────────┘

3. User personas and journeys

3.1 Property seller (lead-only)

• Submits a property via a public outlet form (guest or signed-in)
• May create an account to track submissions in My Submissions
• Uploads follow-up documents while a submission is open
• Does not need a paid subscription; no CRM access
• Uses Help & Support, FAQ, and email updates on listing progress

3.2 Connector

• Applies during onboarding; submits a public profile link for vetting
• Accepts the Levaterra Foundation Member Agreement at registration and before verified app access
• Receives Connector role after admin approval (or via signed email invite to a connection)
• Uses Leads, Connections, Calendar, and AI tools
• May need a subscription tier and ilumWeave Credits for AI features
• Earns gamification rewards (streaks, badges, referral SC) when eligible
• Founding Connectors (first 250 slots) lock lifetime platform access at $499 — stakeholder benefits and advisory votes, not equity; see /founding

3.3 Owner

• Works leads and calendar; scoped operational access
• No user administration or full site settings

3.4 Admin / Super Admin

• User management, moderation queue, support inbox, product feedback triage
• Full lead pool and assignment; can view all connections for oversight
• Site settings per domain, announcements, billing comp/adjustments (super admin)
• Connector vetting with the same social discovery tools used in CRM

4. Core capabilities (shipped)

4.1 Lead capture and seller outlets

Public forms on each outlet collect property details with profile-specific fields (e.g., mobile home park type descriptions, age ranges, foreclosure toggle).

Submission pipeline:

1. Host resolves to site profile; form renders with outlet copy
2. Submission persists to property_leads with attachments when authenticated
3. Internal notification to admin/superadmin recipients
4. Confirmation email to submitter from support@{domain}
5. Guest success state encourages registration; duplicate email prompts login
6. Guest submissions link to the seller account when they register with the same email

Abuse protection: whitelist/blacklist by IP or email; rate limits on login and lead submission; auto-blacklist patterns for repeated failed logins.

Referral attribution: ?ref=CODE on outlet links and per-user referral codes attribute leads; referrers receive email and dashboard visibility.

4.2 Onboarding and access control

After email verification, new users choose a path:

• Property seller — submit/track listings; free tier behavior
• Connector applicant — pending until admin approves; social vetting workflow

Until onboarding completes, dashboard, CRM, billing, submissions (for sellers), and support are gated appropriately.

Roles: Super Admin, Admin, Owner, Connector — permissions gate leads, connections, calendar, users, site settings, and billing admin.

Account safety: suspend (limited access + reason) or ban (cannot sign in); configurable suspension reasons; session idle timeout with in-app warning and extend option.

4.3 My Submissions (seller dashboard)

Property sellers track their own listings in My Submissions:

• Status timeline (draft through closed) with plain-language explanations
• Staff-updated seller status on admin lead records
• Follow-up document uploads on open submissions
• Email updates when staff changes status to received, reviewing, contacted, or closed (configurable)
• Email opt-out via signed links while retaining in-app visibility when signed in
• Guest-to-account linking — submit without logging in, then register with the same email to see prior submissions without re-entering onboarding
• Resume submissions left at the terms confirmation step while logged in

4.4 CRM — Connections

The connections module is the network graph for connectors:

• Add, edit, search, filter, tag, and export contacts — Livewire list with instant search, tag/Blinq filters, and sort (no full-page reload)
• CSV import with sample file, progress UI, and dismissible summary modal
• Blinq personal contacts import with deduplication and social link merge
• Blinq link text import — paste URLs and/or Zoom-style meeting chat exports in a plain text file; each card imports one at a time with live progress; failed links skip without aborting the run; photos deferred until Enrich from Blinq
• Files library — upload and reuse your own import CSV/txt files from CRM Files and your profile; saved files appear in import modals for one-click re-import
• Import source on connections — profiles show which file created or updated a contact (name, type, date & time) in a collapsible panel below Contact and Your notes; other users' file downloads are never exposed
• Import from link — paste Blinq/LinkedIn/social URL to prefill fields and photo
• Per-connection notes (private on shared contacts), social links, photos, property-type interests
• Blinq enrichment — batch re-scrape treats the live card as source of truth; progress UI names the current contact; interrupted runs resume where they left off
• Google Contacts sync — push unsynced or full re-sync after Calendar OAuth
• Shared connections — global identity matching (email, Blinq URL, rules) merges duplicates; each connector keeps private notes; research costs can split fairly across members
• Social discovery — find public profiles across every tracked network (Blinq scrape, Gravatar, full-name handle probes, Google top-10 search, Grok for gaps); skips bare first-name guesses when a surname is known; parallel probes for speed; Whitepages phone clues for US numbers; results saved and reopenable; website links handled separately
• Personality analysis — Grok summarizes themes/tone from recent public posts; load-more posts on demand
• Connector invites — email signed link to register as Connector tied to a CRM record
• Super-admin duplicate merge — one-click global dedupe from the Connections toolbar
• Connection limits by subscription tier (Free: 3, Business: 50, unlimited on higher tiers)

4.5 CRM — Leads

Leads are the operations pipeline (distinct from seller My Submissions):

• Admin/connector lead index with filters and CSV export
• Assignment, notes, call logs, scheduled calls (Google Calendar)
• Property listing creation by connectors on Business+ tiers
• Share listings with selected connections by email
• Property-type routing — connectors declare handled types; rotation assigns unreferred pool leads
• Attachment preview/download; note attachments
• Contact preference flags (do-not-call/text/email) with admin indicators
• Owner & property research — discover public social profiles and property websites from submitted lead data; apply suggested fields; same expanded discovery ladder as connections
• Validation workflow — mark leads validated after research; requires a successful map pin (metered geocode) so bogus addresses cannot pass
• Legitimacy verification — phone lookup (Twilio), SMS YES/STOP/HELP confirmation when consent is on file, and Grok parcel corroboration against public assessor records; append-only verification timeline on the lead detail page
• Map geocode status — explains when Google cannot pin an address (not found, too broad, or API issue)

Staff admins see the unassigned lead pool for triage; connectors see assigned leads and ones they listed.

4.6 Calendar

Per-user Google Calendar connection (not a shared org calendar). Scheduled lead calls create events on the connector’s primary calendar.

4.7 Billing and ilumWeave Credits (SC)

1 SC ≈ $0.01 retail value. AI operations consume SC from a ledger; green $ hints on buttons show estimated cost before running an action.

Founding Connectors (first 250 slots, identical positions): lifetime platform access at $499, then standard Lifetime at $2,499. Founding members do not receive bundled monthly SC — they fund AI through earned credits (feedback, referrals, streaks) or purchased top-ups. They help test, vet, and expand the same verified network described in We Believe — with numbered slots, a founding badge, and program perks that are not equity or profit share.

Approved Founders (invite-only) complete a Founder Agreement application and receive an advisory vote on major platform decisions affecting revenue and platform usefulness; ilumWeave retains final say. See /founding, the Founder Agreement, and the mission page founding callout.

Quarterly and annual multipliers offer discounts vs monthly pay.

Checkout today: PayPal Standard links and manual ACH/wire instructions; staff activation after payment confirmation. Stripe/Cashier is scaffolded for self-serve when price IDs are configured.

Exemptions: Lead-only sellers, staff admins, super admins, and comped accounts do not consume SC.

Admin billing (super admin): search, tier overrides, comp accounts, manual credit adjustments, founder invitations, founding slot grants.

Founding Connectors: public /founding program page — lifetime access vs pay-as-you-go AI, stakeholder benefits (not equity), live slot counter; invite-only Founder role with Founder Agreement; Founding Lifetime at $499 (250 slots, 0 included SC/mo); feedback tester SC rewards; advisory votes on major platform decisions (ilumWeave retains final say).

Written agreements: Levaterra Foundation Member Agreement at registration and before verified app access (versioned audit in user_agreement_acceptances); Founder Agreement for invite-only Founder applications; connector invites via signed email links; two-step lead submit with terms confirmation; published Terms of Service and Privacy Policy. Nothing proceeds until verification is complete and the appropriate agreement is signed.

4.8 Referrals and gamification

• Personal referral code for team invites (/invite/CODE) and lead attribution (?ref=CODE)
• Rewards: SC for sign-ups, connector conversions, and sharing referral links (caps apply; staff exempt)
• Daily login streaks with multipliers (up to 3×) into a promo bucket with expiry
• Badges for milestones (connections, referrals, streaks, invites) with optional one-time SC bonuses
• Achievements visible on profile; dashboard streak card

4.9 Moderation and support

Content moderation (v0.1.18):

• Verified users report connections or users with category, details, and policy acknowledgment
• Fair threshold: one report alone does not hide a connection — interim hide requires multiple distinct reporters within a configurable window (default 3 in 30 days)
• Staff moderation queue: dismiss, no-action, restore visibility, suspend/ban reported user
• Site Settings → Moderation for threshold, window, retention policy text

Help & Support:

• Users open categorized support tickets; thread replies until closed
• Staff Support inbox: reply, assign, close; search users when creating tickets on behalf of someone
• Category picker suggests related app pages for faster triage
• Screenshot attachments on ticket create and reply
• Email notifications to user and SUPPORT_INBOX_EMAIL

4.10 Resources — help, feedback, and product communication

FAQ

• Searchable, collapsible help library under Resources
• Answers expand inline on /faq (no separate read page)
• Staff edit inline on the same page; add via modal; promote feedback into draft Q&A
• Seeded library covering onboarding, CRM, billing, referrals, safety, integrations

Feedback

• Verified users submit product ideas with attachments, voice memos, or video links
• Separate from support tickets (broken vs ideas)
• Staff triage queue with status and internal notes; Promote to FAQ creates draft entries

What's New / Future Updates / Our Mission

• Versioned release notes (/whats-new) from config/release_notes.php
• Public roadmap (/future-updates) from config/future_updates.php
• We Believe mission (/mission) from config/mission.php — verification-first hero, written agreements callout, seller and connector sections, founding program callout, and links to /founding and /membership-agreement
• ilumweave.com hub — platform intro, written-agreements callout, then mission hero with pillars; outlet domains show a compact mission summary banner

Platform whitepaper

• Public /whitepapers renders this living document with table of contents
• Logged-in members share by email; links include their referral code for attribution and SC rewards
• Each recipient email receives the whitepaper once; duplicate shares are thanked without re-sending
• Share emails include an anti-spam disclaimer and a signed report spam link so recipients can block future messages from that sender
• Optional site-update notifications from the whitepaper page or profile

4.11 Admin, announcements, and site settings

• Announcements — scheduled homepage CTAs per domain profile (priority, window, button URL)
• Site settings — per-outlet branding, disclaimers, email template overrides, logo and favicon uploads; add domains via Livewire UI; preview homepage in a new tab (superadmin/admin) without changing DNS
• Users & roles — roster, connector approval, vetting review (including confirm-from-connection when the applicant already exists in CRM), suspend/ban, referral stats
• Referral code log (super admin) — global uniqueness and claim history
• Product feedback and moderation queues under Administration

4.12 Authentication and legal

• Fortify/Jetstream: register, login, 2FA, password reset, email verification on all paths including OAuth
• OAuth complete-email flow when provider omits email
• Public Terms of Service and Privacy Policy
• Levaterra Foundation Member Agreement (/membership-agreement) — required at registration and before verified app access
• Founder Agreement (/founder-agreement) — invite-only Founder applications
• Connector invites — signed registration links tied to CRM records
• Lead submit terms confirmation step before final submission
• Google Analytics / GTM / Search Console hooks (config-driven)

5. Security, transparency, and data practices

• Secrets in environment variables only; never committed
• Production vs test database isolation; PHPUnit guards against destructive runs on non-sqlite DBs
• Public security headers on public and guest routes — CSP, HSTS, Referrer-Policy, Permissions-Policy, and related hardening (PublicSecurityHeaders middleware; authenticated app routes unchanged)
• Signed URLs for connector invites, email preferences, whitepaper spam reports, and sensitive actions
• Role-based authorization policies throughout admin and CRM
• Staff oversight on shared connection merges and connector vetting
• Session timeout and account status enforcement at login
• Seller transparency: submission status visible in My Submissions; email opt-out without losing in-app history when signed in; verification before assignment; signed agreements before outreach
• Connector transparency: SC ledger, tier limits, and per-action cost hints before AI runs; membership and founder agreements with versioned acceptance audit
• Network transparency: fair moderation thresholds, published reporting policy, support ticket threads with email notifications
• Policy transparency: public Terms of Service, Privacy Policy, and Membership Agreement; FAQ and roadmap kept current

6. Release history (summary)

The platform is versioned in VERSION (currently development-v0.1.38-alpha). Major milestones:

Recent capabilities tracked as Shipped on the roadmap: Six seller outlet domains, Cross-domain Links navigation, Admin site preview, Outlet seller landing pages, Mission improved layout, Lead confirmation registration, Signed agreements mission copy, Public security headers, SEO and social meta tags, Mission-first homepage, Outlet mission summaries, Development disclaimer, Our Mission page refresh, Founding Connectors program, Founder invite-only applications, Levaterra PMA membership, Collapsible import source on connection profiles, Expanded social discovery, Whitepages phone lookup in CRM, Per-domain branding uploads, Phone country code normalization, Personal Files library, Batched Blinq link import, Meeting chat contact extraction, Connection import file history, Blinq link import reliability, Seller submission status emails, Guest seller linking, Lead legitimacy verification, Platform whitepaper, My Submissions, FAQ, Feedback, Moderation & support tickets, Shared connections, social login (X/LinkedIn), connector vetting, livewire domain settings, gamification, subscriptions & SC foundation.

Full itemized notes: in-app What's New or config/release_notes.php.

7. Future updates and roadmap

Roadmap content is maintained in config/future_updates.php and displayed at Resources → Future Updates. Priorities evolve with seller and connector feedback.

7.1 In progress

Shipped initiatives are also listed on the public Future Updates page (config/future_updates.php).

7.2 Shipped (recent roadmap items)

7.3 Coming soon (planned)

7.4 On the roadmap (exploring)

7.5 FAQ / feedback Phase B (documented, not yet shipped)

• Helpful votes on FAQ articles
• Public unauthenticated FAQ on marketing hub
• Per-outlet FAQ overrides in site settings

8. Business model summary

AI margin is controlled via SC pricing derived from operational cost and a configured markup multiplier. Manual payment verification bridges the gap until PayPal IPN and Stripe automation fully close the loop.

9. Operational deployment notes

• Run migrations on deploy (php artisan migrate --force)
• Seed FAQ library: php artisan db:seed --class=FaqEntrySeeder
• Route cache must succeed before production optimize (php artisan route:cache)
• Environment branches: development, versioned development branches, production
• Configure: SUPPORT_INBOX_EMAIL, FEEDBACK_INBOX_EMAIL, LEAD_NOTIFICATION_EMAIL, OAuth credentials, Resend, PayPal, optional Stripe prices

10. Glossary

11. Conclusion

IlumWeave is not a generic CRM bolted onto a form builder. It is an outlet-aware lead operations system built for full transparency in real estate: specialized public intake with honest follow-up, verification and signed agreements before anything moves forward, fair network-wide contact identity, AI-assisted preparation with disclosed costs, role-separated experiences for sellers vs connectors vs staff, and a growing layer of trust, support, and self-serve documentation.

We connect properties, people, and teams — and we believe that connection only works when sellers can answer who has my information, what verification has been done, where their submission stands, and what happens next — without chasing anyone down. Founding Connectors help grow that same verified network with lifetime platform access, earned AI credits, and advisory input — not equity.

The roadmap focuses on payment automation, smarter routing, external integrations, and deeper analytics—while preserving the principles that property sellers stay free, connectors pay only for the operational and AI capacity they use, every step is documented with signed agreements, and everyone involved can see what the platform is doing on their behalf.

For our mission, see Our Mission (/mission). For founding connectors, see Founding Connectors (/founding). For the latest shipped details, see What's New in the app. For prioritized upcoming work, see Future Updates. For legal terms, see /terms-of-service, /privacy-policy, and /membership-agreement.