# Build Brief — AiEntrepreneur.me

## What This Site Is

AiEntrepreneur.me is a subscription-based educational training platform for home-based AI professionals. It teaches people how to build profitable AI service businesses from scratch through a structured 5-pillar curriculum, curated tools, a resource hub, member success stories, and a per-lesson AI tutor.

---

## Who It Serves

**Members** — People learning to build and grow home-based AI service businesses. They access curriculum, tools, resources, and the AI tutor.

**Admin / Staff** — The team manages content, access codes, member accounts, welcome emails, promo codes, and the admin panel.

---

## Access Model

- **Subscription** — Monthly or annual via Stripe. Full platform access.
- **Access Code** — Single-use or multi-use codes distributed by admin. Grants full access without payment. Format: `XXXX-XXXX`.
- **Free Preview** — Home, Pricing, Stories, and partial tool listings are publicly visible.

---

## Technical Stack

- **Frontend:** React 19 + Vite 7, TypeScript, Tailwind CSS, shadcn/ui, Wouter (routing)
- **Backend:** Express 5 + Pino logging, TypeScript, Node.js 24
- **Database:** PostgreSQL via Drizzle ORM
- **Payments:** Stripe (subscriptions + one-time) via Replit integration
- **Email:** Resend via Replit connector proxy — welcome emails with `{{name}}` template support
- **AI Tutor:** Grok (`grok-3-mini`) via xAI API (`https://api.x.ai/v1`)
- **Auth:** localStorage session — email + role stored client-side; no server-side sessions
- **Hosting:** Replit (development + production deployment)
- **Monorepo:** pnpm workspaces

---

## Key URLs

- Homepage: https://aientrepreneur.me/
- Curriculum: https://aientrepreneur.me/curriculum
- Start Here: https://aientrepreneur.me/start-here
- Tools: https://aientrepreneur.me/tools
- Resources: https://aientrepreneur.me/resources
- Stories: https://aientrepreneur.me/stories
- Pricing: https://aientrepreneur.me/pricing
- User Guide: https://aientrepreneur.me/user-guide
- Admin Panel: https://aientrepreneur.me/admin (staff only)
- API Base: https://aientrepreneur.me/api

---

## Auth Roles

| Role | Access |
|---|---|
| Admin | Full platform + admin panel. Defined by env vars only (`ADMIN_EMAIL`, `ADMIN_PASSWORD`). |
| Moderator | View + edit welcome email template. DB-managed. |
| Viewer | Read-only admin panel access. DB-managed. |
| Member | Full curriculum access. Granted via code registration or active subscription. |

---

## Admin Panel Features

- To-do list with priority sorting
- Access code generation and revocation
- Partner magic links (cross-site JWT login links for partner network)
- User management (search, promote to staff role)
- Promo codes (create, toggle, delete — free/percent/fixed)
- Welcome email editor (subject + body, `{{name}}` variable support)
- Backup export / restore import

---

## Partner Network

AiEntrepreneur.me is the flagship site in a 7-site AI platform network. Partner links are signed JWTs (`PARTNER_JWT_SECRET`) that auto-log users into partner sites. Admin generates links; they appear in the user's nav dropdown for one-click access.

Partner sites: AiGigs.me, CertifyAI.me, AiNuby.com, CreationPointAI.com, AiBrokAgents.com, AiGets.me

---

## AI-Readable Files Index

| File | URL |
|---|---|
| `llms.txt` | https://aientrepreneur.me/llms.txt |
| `llms-full.txt` | https://aientrepreneur.me/llms-full.txt |
| `build-brief.txt` | https://aientrepreneur.me/build-brief.txt |
| `faq.md` | https://aientrepreneur.me/faq.md |
| `key-people.md` | https://aientrepreneur.me/key-people.md |
| `practice-areas.md` | https://aientrepreneur.me/practice-areas.md |
| `schema.jsonld` | https://aientrepreneur.me/schema.jsonld |
| `ai-sitemap.xml` | https://aientrepreneur.me/ai-sitemap.xml |
| Dynamic sitemap | https://aientrepreneur.me/api/sitemap.xml |