A full-stack TypeScript tourist booking platform with debit card (Stripe) and cryptocurrency (Solana) payments, admin analytics, customer dashboard, communication hub, and AI support.

• Tour browsing, booking, and payment (Stripe card + Solana wallet)
• Jupiter DEX integration for Solana token swaps (frontend)
• JWT authentication with MFA (TOTP), sessions, and OAuth URL helpers
• Customer dashboard (account, invoices, analytics, feedback)
• Admin panel (users, billing, analytics, audit logs, system health)
• Communication (chat, forums, broadcasts, AI chatbot, calls)
• AI support assistant with FAQ suggestions
• Docker Compose deployment for production-like stacks

crypto-card-integration-dapp/
├── frontend/                 # Next.js TypeScript app
│   ├── app/                  # App Router pages
│   ├── components/           # React components
│   ├── contexts/             # Auth context
│   └── lib/                  # API clients, Solana helpers
├── backend/                  # Fastify TypeScript API
│   └── src/
│       ├── db/               # SQLite schema & seed
│       ├── middleware/       # JWT auth
│       ├── routes/             # API route handlers
│       └── services/         # Business logic
├── aws/                      # Docker Compose deployment
└── package.json              # Root monorepo scripts

• Node.js 20+ and npm
• Optional: Stripe account (card payments), Solana wallet (crypto payments)

npm run install-all

Frontend uses .npmrc with ignore-scripts=true to avoid optional native postinstall failures on Windows.

Backend — copy and edit:

cp backend/env.example backend/.env

Frontend — copy and edit:

cp frontend/env.example frontend/.env.local

npm run db:seed

This creates sample tours, forum categories, FAQs, and a welcome broadcast.

Both frontend and backend together:

npm run dev

Or separately:

npm run dev:backend   # http://localhost:8000
npm run dev:frontend  # http://localhost:3000

Full interactive docs: start the backend and visit the route handlers in backend/src/routes/.

# Type-check everything
npm run typecheck

# Production build (backend + frontend)
npm run build

# Start production servers
npm run start

cd aws
docker compose up --build

See aws/README.md for deployment details.

1. User selects a tour and opens the payment modal.
2. Frontend calls POST /payments/stripe with payment_method_id, amount, and tour_id.
3. Backend confirms with Stripe (or mock mode without STRIPE_SECRET_KEY).
4. Booking and payment records are created in SQLite.

1. User connects a Solana wallet via @solana/wallet-adapter.
2. Transaction is signed client-side; signature is sent to POST /payments/solana.
3. Optional Jupiter DEX swap via frontend/lib/solana.ts.

Register a user, then promote to admin in the database:

UPDATE users SET role = 'admin' WHERE email = 'your@email.com';

Or use SQLite CLI:

cd backend
npx tsx -e "import {getDb} from './src/db/database.js'; getDb().prepare(\"UPDATE users SET role='admin' WHERE email=?\").run('your@email.com');"

This project was migrated from a Python FastAPI + PostgreSQL stack to a 100% TypeScript codebase:

• Backend: FastAPI → Fastify with SQLite (zero external DB for local dev)
• Frontend: Already TypeScript; configs moved to .ts / .mjs
• Removed: All .py files, Alembic, requirements.txt, shell deploy scripts

For questions, integration support, or custom development:

Telegram: https://t.me/solzen77

MIT