AeThex-Corporation/aethex-forge
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

Insert Architecture & Troubleshooting before next-steps

Browse source 
cgen-5e922e9b1488408780229d43d892b69b
This commit is contained in:
Builder.io 2025-11-11 18:15:25 +00:00
parent ff45054472
commit 82b59a6f89
1 changed files with 43 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

43
client/pages/docs/DocsPlatform.tsx
View file

@ -361,6 +361,49 @@ export default function DocsPlatform() {
</Card>
</section>
{/* Architecture */}
<section id="architecture" className="space-y-6">
<div className="flex items-center gap-3">
<Globe className="h-6 w-6 text-cyan-300" />
<h3 className="text-2xl font-semibold text-white">Architecture overview</h3>
</div>
<Card className="bg-slate-900/60 border-slate-700">
<CardContent>
<p className="text-gray-300 text-sm leading-relaxed">
AeThex is composed of a lightweight React + Vite frontend, a Node.js backend that
exposes API endpoints (under <code>/api/*</code>), and a Supabase-backed PostgreSQL
database. The system integrates several services:
</p>
<ul className="list-disc pl-6 mt-3 text-gray-300 text-sm space-y-2">
<li><strong>Frontend:</strong> React + TypeScript, Docs and Internal hubs use a separate layout and access control.</li>
<li><strong>Backend:</strong> Node/Express handlers for public APIs, Discord webhooks, and OAuth flows.</li>
<li><strong>Database:</strong> Supabase (Postgres) stores user profiles, creator data, and operational tables. Migrations live under <code>code/supabase/migrations</code>.</li>
<li><strong>Integrations:</strong> OAuth providers (Google, GitHub, Discord, Roblox), Discord bot for role mapping & verification, and optional Web3 wallet linking.</li>
<li><strong>Docs & CMS:</strong> Public docs are rendered with DocsLayout and editable in Builder CMS (MCP). Internal docs live under <code>/internal-docs</code> and require authentication.</li>
</ul>
<p className="mt-3 text-gray-300 text-sm">This arrangement lets staff operate private operational processes while exposing curated platform docs publicly.</p>
</CardContent>
</Card>
</section>
{/* Troubleshooting */}
<section id="troubleshooting" className="space-y-6">
<div className="flex items-center gap-3">
<ShieldCheck className="h-6 w-6 text-cyan-300" />
<h3 className="text-2xl font-semibold text-white">Common troubleshooting</h3>
</div>
<Card className="bg-slate-900/60 border-slate-700">
<CardContent>
<h4 className="text-white font-semibold mb-2">OAuth redirect issues</h4>
<p className="text-gray-300 text-sm">If an OAuth provider returns an <code>invalid_redirect_uri</code> error, verify that the callback URL configured in the provider matches the deployed app's API base (e.g. <code>https://aethex.dev/api/discord/oauth/callback</code> for Discord). For local development use the configured VITE_API_BASE when available.</p>
<h4 className="text-white font-semibold mt-4 mb-2">Session/linking problems</h4>
<p className="text-gray-300 text-sm">If a linking flow (e.g. linking Discord) redirects to login or loses session, check cookie SameSite settings and ensure the redirect URI domain matches where cookies are set. Staff can consult internal docs under <code>/internal-docs/onboarding</code> for detailed diagnostic steps.</p>
<h4 className="text-white font-semibold mt-4 mb-2">Missing emails</h4>
<p className="text-gray-300 text-sm">Verification and notification emails are sent from <code>support@aethex.tech</code>. If emails are not arriving, check spam filters and outbound SMTP logs (Hostinger) for delivery failures.</p>
</CardContent>
</Card>
</section>
<section
id="next-steps"
className="rounded-2xl border border-cyan-500/40 bg-cyan-900/20 p-8"