Trade Show System
A multi-tenant web app: every customer company gets its own account that
its users log in to. Inside an account users are invited, given a role and
keep the company profile up to date; billing and features follow in the next steps.
Kort fortalt (dansk)
- Hver kunde er en konto (i koden hedder det
Organization). En bruger kan være med i flere konti.
- Roller: Owner (alt, inkl. betaling), Admin (brugere, profil, funktioner), Member (bruger systemet).
- Brugere inviteres med et link, som en admin kopierer og sender. Automatisk e-mail kommer senere.
- Exhibition centers (og senere messer, arrangører og udstillere) er én fælles liste for alle konti. Alle kan se den; kun e-mails i
PLATFORM_ADMIN_EMAILS kan rette i den.
- Feature control (menuen "Super admin") ses kun af e-mails i
PLATFORM_ADMIN_EMAILS. Her oprettes kommende funktioner. De starter slukket (skjult for kunder) og kan tændes for udvalgte konti eller for alle.
- AI trade show finder (Feature control → AI trade show finder): læser events-siden (Local events URL) for de messecentre, der er sat flueben ved, den 1. i hver måned og lægger nye messer de næste 6 måneder direkte på messelisten. En super admin kan fjerne en tilføjet messe; så tilføjes den ikke igen. Kræver
ANTHROPIC_API_KEY og CRON_SECRET i Vercel.
- Fetch exhibitors (på en messes side): AI læser messens Exhibitor directory URL side for side og lægger udstillerne på messen. Lister, der bygges med JavaScript, åbnes i en headless Chrome (
@sparticuz/chromium på Vercel; sæt CHROMIUM_PATH til en lokal Chrome ved udvikling). Kræver ANTHROPIC_API_KEY.
- Hunter.io (valgfrit): når
HUNTER_API_KEY er sat i Vercel, spørger "Find contact with AI" og "Find missing contacts" også Hunter.io (Domain Search) om navne og e-mails, som virksomhedens hjemmeside ikke viser. Kun tomme felter udfyldes, og hver udstiller spørges højst én gang. Natkørslen bruger ikke Hunter, så credits kun bruges, når en super admin trykker.
- Billing (Account settings → Billing): kontoens Owner starter abonnementet via Stripe Checkout og retter kort, opsiger og ser fakturaer i Stripes kundeportal. En ny konto sendes direkte fra oprettelsen til Stripe Checkout (
/a/[slug]/billing/checkout) for at indtaste kort og betale. Prisen er pr. bruger: antallet i abonnementet følger kontoens brugere og rettes automatisk, når en bruger kommer til eller bliver fjernet. En ny bruger faktureres og trækkes med det samme for resten af perioden; en fjernet bruger bliver til en kreditering på næste faktura. Stripe sender ændringer til /api/stripe/webhook, som kopierer abonnement og fakturaer til databasen. Kræver STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET og STRIPE_PRICE_ID i Vercel. Konti uden betalt abonnement er spærret: de kan kun åbne Billing, Users og Company profile, indtil Owner har betalt. Platform admins spærres aldrig, og intet spærres, så længe Stripe-nøglerne mangler. Mislykkes en betaling, har kontoen adgang, mens Stripe prøver kortet igen.
- Filer på favoritter (Favorites → Exhibitors): under Lead og Notes på hver favorit kan man tilføje links til tilbud, præsentationer m.m., der ligger i kundens egen lagring (Google Drive, Dropbox, Box, OneDrive, SharePoint eller andet). Kun linket og et navn gemmes; filerne bliver i kundens lagring, som også bestemmer, hvem der kan åbne dem. Links følger virksomheden til næste års messe og slettes, når favoritten fjernes. Op til 30 links pr. favorit.
- Login-beskyttelse (så et login ikke deles af flere personer): logger man ind fra en ny enhed, sendes en 6-cifret kode på e-mail, og enheden huskes i 30 dage. Kun ét login ad gangen pr. bruger: et nyt login logger det gamle ud. Koden kræver, at e-mail (Resend) er sat op;
LOGIN_DEVICE_CHECK=off i Vercel slår koden fra.
- Kortoplysninger gemmes aldrig hos os. De ligger i Stripe, og vi gemmer kun Stripes id'er.
Status
| Step | What | State |
|---|
| 1 | Login, accounts, users with roles, invitations | ✅ done |
| 2 | Company profile and primary contact, approved design applied | ✅ done |
| – | Shared directory: exhibition centers (list, search, add, edit, CSV import) | ✅ done |
| – | Shared directory: exhibition organizers (same features) | ✅ done |
| – | Shared directory: trade shows (status follows the dates) | ✅ done |
| – | Shared directory: exhibitors per trade show; trade shows linked to their exhibition center | ✅ done |
| – | Super admin feature control: add upcoming features, switch them on for selected accounts or everyone | ✅ done |
| – | AI trade show finder: reads chosen centers' events pages on the 1st of each month and adds new trade shows | ✅ done |
| 3 | Stripe: subscription via Checkout, customer portal, invoices, webhooks | ✅ this version |
| 4 | Selectable features | data model ready |
Design
Approved in September 2026: white left sidebar with the current page as a solid
blue pill, light grey page, white cards, and the logo blue (#287bbf) as the only
accent colour. Green, amber and red are only used for small status badges. The
tokens live in src/app/globals.css; logo files are in public/brand.
Tech
- Next.js 16 (App Router, server actions) + TypeScript
- PostgreSQL via Prisma
- Auth.js (email + password, signed-cookie sessions)
- Tailwind CSS
- Stripe (from step 3)
Run it locally
You need Node.js 22 and Docker (for the database).
cp .env.example .env # then set AUTH_SECRET: npx auth secret
docker compose up -d # starts PostgreSQL
npm install
npm run db:migrate # creates the tables
npm run db:seed # adds example features
npm run dev # http://localhost:3000
Other commands: npm test, npm run typecheck, npm run build, npm run db:studio (browse the database).
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
