From ffae97d6d09ac240a6268253b1214fa942ae4a92 Mon Sep 17 00:00:00 2001
From: sirpiglr <49359077-sirpiglr@users.noreply.replit.com>
Date: Wed, 3 Dec 2025 00:49:23 +0000
Subject: [PATCH] Update domain architecture and API routing information

Update replit.md to document the refined domain architecture, including the role of aethex.foundation as the identity authority, and detail the updated routing for passport subdomains and API calls.

Replit-Commit-Author: Agent
Replit-Commit-Session-Id: 9203795e-937a-4306-b81d-b4d5c78c240e
Replit-Commit-Checkpoint-Type: full_checkpoint
Replit-Commit-Event-Id: 599b841b-e06a-4c18-9ee0-5cbc4d5bc7a6
Replit-Commit-Screenshot-Url: https://storage.googleapis.com/screenshot-production-us-central1/7c94b7a0-29c7-4f2e-94ef-44b2153872b7/9203795e-937a-4306-b81d-b4d5c78c240e/saoW2ee
Replit-Helium-Checkpoint-Created: true
---
 replit.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/replit.md b/replit.md
index fa11e64e..8798943e 100644
--- a/replit.md
+++ b/replit.md
@@ -103,6 +103,36 @@ npm start           # Start production server
 - `DISCORD_CLIENT_ID` - Application client ID
 - `SUPABASE_SERVICE_ROLE` - Service role key for database operations
 
+## Domain Architecture
+
+### Identity Authority
+- **aethex.foundation** - Single Source of Truth (SSOT) for all identity/passport data
+- All platforms are OAuth clients consuming Foundation-issued identities
+
+### Domain Routing
+| Domain | Purpose |
+|--------|---------|
+| `aethex.dev` | Main application platform |
+| `aethex.foundation` | Identity authority, passport API |
+| `*.aethex.me` | Creator Passports (wildcard subdomains) |
+| `*.aethex.space` | Project Passports (wildcard subdomains) |
+| `aethex.app`, `.locker`, `.site` | Redirect to aethex.dev |
+| `aethex.studio` | Redirect to aethex.dev/ethos |
+| `aethex.info` | Redirect to aethex.dev/foundation |
+
+### Passport API Flow
+```
+user.aethex.me → fetches from https://aethex.foundation/api/passport/subdomain/{user}
+project.aethex.space → fetches from https://aethex.foundation/api/passport/project/{slug}
+```
+
+## Recent Changes (December 3, 2025)
+- ✅ Fixed passport subdomain API to call aethex.foundation (identity authority)
+- ✅ Fixed API paths: `subdomain-data` → `subdomain`, `project-data` → `project`
+- ✅ Restored wildcard rewrites in vercel.json for `*.aethex.me` and `*.aethex.space`
+- ✅ Added missing routes to vercel.json: /community/*, /developers/*, /discord-verify/*, /ethos/*
+- ✅ Added catch-all route for future paths
+
 ## Recent Changes (December 2, 2025)
 - ✅ Configured Vite to run on port 5000 for Replit compatibility
 - ✅ Set up proper host configuration (0.0.0.0) for Replit proxy