eid-salami 1.0.0

package/DEPLOY.md

@@ -0,0 +1,199 @@
+# 🚀 cPanel Deployment Guide
+
+## Overview
+
+| Part | Where | How |
+|---|---|---|
+| **Backend** (KeystoneJS API) | cPanel Node.js App | Runs as a Node.js application |
+| **Frontend** (React) | cPanel public_html | Static files uploaded via File Manager |
+| **Database** | PostgreSQL | cPanel PostgreSQL OR Neon.tech (free) |
+
+---
+
+## Step 1 — Set up PostgreSQL database
+
+### Option A: cPanel has PostgreSQL
+1. Go to cPanel → **PostgreSQL Databases**
+2. Create a new database e.g. `myuser_eidsalami`
+3. Create a database user with a strong password
+4. Add the user to the database with **All Privileges**
+5. Your connection URL will be:
+   ```
+   postgresql://myuser_dbuser:PASSWORD@localhost:5432/myuser_eidsalami
+   ```
+
+### Option B: cPanel only has MySQL → use Neon.tech (free)
+1. Go to [neon.tech](https://neon.tech) and sign up free
+2. Create a new project called `eid-salami`
+3. Copy the connection string — it looks like:
+   ```
+   postgresql://user:pass@ep-xxx.us-east-1.aws.neon.tech/neondb?sslmode=require
+   ```
+
+---
+
+## Step 2 — Upload & configure the backend
+
+### 2a. Upload files
+1. In cPanel → **File Manager**, go to your home directory (not public_html)
+2. Create a folder called `eid-salami-backend`
+3. Upload everything from the `backend/` folder into it
+4. Also upload `package.json` from the root (the workspace one is not needed — just the backend one)
+
+Your server structure should look like:
+```
+/home/yourusername/
+  eid-salami-backend/
+    keystone.ts
+    keystone/
+    bkash/
+    package.json
+    tsconfig.json
+    .env          ← you'll create this next
+```
+
+### 2b. Create .env file
+In File Manager, create a new file called `.env` inside `eid-salami-backend/`:
+
+```env
+DATABASE_URL=postgresql://YOUR_USER:YOUR_PASSWORD@localhost:5432/YOUR_DB
+SESSION_SECRET=paste_any_long_random_string_here_minimum_32_characters
+BKASH_PERSONAL_NUMBER=01XXXXXXXXX
+FRONTEND_URL=https://yourdomain.com
+PORT=3000
+NODE_ENV=production
+```
+
+> ⚠️ Replace all values with your real ones. Never share this file.
+
+---
+
+## Step 3 — Set up Node.js app in cPanel
+
+1. Go to cPanel → **Setup Node.js App**
+2. Click **Create Application**
+3. Fill in:
+   - **Node.js version:** 18
+   - **Application mode:** Production
+   - **Application root:** `eid-salami-backend`
+   - **Application URL:** `api.yourdomain.com` (or `yourdomain.com/api`)
+   - **Application startup file:** `node_modules/.bin/keystone`
+4. Click **Create**
+
+### 2. Install dependencies via cPanel terminal
+In cPanel → **Terminal** (or SSH):
+
+```bash
+cd ~/eid-salami-backend
+npm install
+```
+
+### 3. Build KeystoneJS
+```bash
+npm run build
+```
+
+### 4. Run database migrations
+```bash
+npx keystone prisma migrate deploy
+```
+
+### 5. Start the app
+Go back to **Setup Node.js App** → click **Run JS Script** or just **Restart**.
+
+### 6. Create your admin account
+Visit `https://api.yourdomain.com/keystonejs` — it will ask you to create the first admin user.
+
+### 7. Seed packages
+In terminal:
+```bash
+cd ~/eid-salami-backend
+node -e "
+const fetch = (...args) => import('node-fetch').then(({default: f}) => f(...args));
+// Run seed
+" 
+```
+Or just create packages manually from the admin panel.
+
+---
+
+## Step 4 — Build & upload the frontend
+
+### On your LOCAL computer:
+
+1. Create `frontend/.env` file:
+```env
+VITE_API_URL=https://api.yourdomain.com
+```
+
+2. Build the frontend:
+```bash
+cd frontend
+npm install
+npm run build
+```
+
+3. This creates a `frontend/dist/` folder.
+
+### Upload to cPanel:
+1. Go to cPanel → **File Manager** → `public_html`
+2. Upload all files from `frontend/dist/` directly into `public_html`
+3. Make sure `index.html` is in the root of `public_html`
+
+---
+
+## Step 5 — Fix React Router (important!)
+
+React Router needs all URLs to serve `index.html`. Create a `.htaccess` file in `public_html`:
+
+```apache
+Options -MultiViews
+RewriteEngine On
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteCond %{REQUEST_FILENAME} !-d
+RewriteRule ^ index.html [QSA,L]
+```
+
+---
+
+## Step 6 — Test everything
+
+1. Visit `https://yourdomain.com` — you should see the homepage
+2. Try placing a test order end-to-end
+3. Check `https://api.yourdomain.com/keystonejs` — admin panel should work
+4. Verify orders appear in admin panel after submission
+
+---
+
+## 🔁 How to update the site later
+
+**Backend changes:**
+```bash
+# In cPanel Terminal
+cd ~/eid-salami-backend
+# Upload new files, then:
+npm install
+npm run build
+# Restart app in Setup Node.js App
+```
+
+**Frontend changes:**
+```bash
+# On your local computer
+cd frontend
+npm run build
+# Upload dist/ contents to public_html again
+```
+
+---
+
+## 🛑 Common problems
+
+| Problem | Fix |
+|---|---|
+| `Cannot find module` | Run `npm install` again in terminal |
+| Database connection error | Double-check DATABASE_URL in .env |
+| Admin panel shows blank | Check FRONTEND_URL in .env matches your domain exactly |
+| Frontend shows old version | Clear browser cache (Ctrl+Shift+R) |
+| 404 on page refresh | Make sure .htaccess file is in public_html |
+| Port already in use | Change PORT in .env, update in cPanel Node.js App settings |

package/README.md

@@ -0,0 +1,133 @@
+# 🌙 ঈদ সালামি — Eid Salami Platform
+
+Send Eid Salami to loved ones via **bKash Personal** — no merchant account needed.
+
+---
+
+## 🏗️ Architecture
+
+```
+eid-salami/
+├── backend/                    # KeystoneJS + Node.js + TypeScript
+│   ├── keystone.ts             # App config (MongoDB, sessions, CORS)
+│   ├── keystone/
+│   │   ├── schema.ts           # Models: User, SalamiPackage, Order
+│   │   └── routes.ts           # REST: create order, submit TrxID, get order/packages
+│   └── seed.ts                 # Seed default packages
+│
+└── frontend/                   # Vite + React + TypeScript
+    └── src/
+        ├── api/client.ts       # Axios client
+        ├── pages/
+        │   ├── HomePage.tsx        # Landing page
+        │   └── OrderPage.tsx       # 4-step order form
+        └── components/
+            ├── Navbar / Footer / PackageCard
+```
+
+---
+
+## 💳 Payment Flow (bKash Personal)
+
+```
+1. User picks package + fills details
+         ↓
+2. POST /api/orders/create
+   → Order saved (status: pending)
+   → Returns your bKash number + amount
+         ↓
+3. User sends money via bKash app to YOUR number
+   then pastes TrxID into the form
+         ↓
+4. POST /api/orders/submit-trxid
+   → Order updated (status: pending_verification)
+         ↓
+5. YOU open KeystoneJS admin panel
+   → Check your bKash inbox for the TrxID
+   → Set paymentStatus = "completed"
+   → Set deliveryStatus = "sent"
+```
+
+---
+
+## 🚀 Quick Start
+
+### 1. Install
+
+```bash
+npm install             # from root (installs both workspaces)
+```
+
+### 2. Configure backend
+
+```bash
+cd backend
+cp .env.example .env
+```
+
+Edit `.env`:
+
+```env
+MONGODB_URI=mongodb://localhost:27017/eid-salami
+SESSION_SECRET=any_random_32_char_string_here
+BKASH_PERSONAL_NUMBER=01XXXXXXXXX     # ← YOUR bKash number
+FRONTEND_URL=http://localhost:5173
+```
+
+### 3. Run
+
+```bash
+# Terminal 1
+cd backend && npx keystone dev
+
+# Terminal 2
+cd frontend && npm run dev
+```
+
+- **Frontend:** http://localhost:5173
+- **Admin Panel:** http://localhost:3000/keystonejs
+
+### 4. First run setup
+
+On first launch, Keystone will ask you to create an admin user. After that:
+
+```bash
+cd backend && npx ts-node seed.ts
+```
+
+This creates 5 default packages: ৳100, ৳250, ৳500, ৳1000, ৳2000.
+
+---
+
+## 🛡️ Admin Panel Workflow
+
+Every time a user submits a TrxID:
+
+1. Go to http://localhost:3000/keystonejs/orders
+2. Orders with **"Pending Verification"** status need your attention
+3. Open your bKash app and verify the TrxID matches the amount
+4. If correct: set `paymentStatus = Completed`, `deliveryStatus = Sent`
+5. If fake: set `paymentStatus = Failed`, add a note in `adminNote`
+
+---
+
+## 🔒 TrxID Duplicate Protection
+
+The backend prevents the same TrxID from being used on multiple orders — if a user tries to reuse a TrxID, they get an error message.
+
+---
+
+## 📦 Tech Stack
+
+| | |
+|---|---|
+| Backend | KeystoneJS 6 (headless CMS + GraphQL + custom REST) |
+| Database | MongoDB |
+| Payment | bKash Personal (manual TrxID verification) |
+| Runtime | Node.js + TypeScript |
+| Frontend | React 18 + Vite + TypeScript + CSS Modules |
+
+---
+
+ঈদ মোবারক! 🌙
+# eid-salami

package/backend/.env.example

@@ -0,0 +1,25 @@
+# ─── Database ──────────────────────────────────────────────────────────────────
+# Option A — cPanel PostgreSQL:
+# DATABASE_URL=postgresql://DB_USER:DB_PASSWORD@localhost:5432/DB_NAME
+#
+# Option B — Neon.tech free PostgreSQL (if cPanel has no PostgreSQL):
+# DATABASE_URL=postgresql://user:password@ep-xxx.us-east-1.aws.neon.tech/neondb?sslmode=require
+
+DATABASE_URL=postgresql://neondb_owner:npg_7kTr9jUMhveZ@ep-lingering-paper-a1b0e5g5-pooler.ap-southeast-1.aws.neon.tech/neondb?sslmode=require&channel_binding=require
+
+# ─── Session ───────────────────────────────────────────────────────────────────
+# Any random string, 32+ characters
+SESSION_SECRET=asdfa4s5dfasa4df54sa4adf35s1df34sdf35s4fasdfasdfasdfasdfa
+
+# ─── bKash Personal ────────────────────────────────────────────────────────────
+# Your personal bKash number — users will send money to this number
+BKASH_PERSONAL_NUMBER=01956721941
+
+# ─── App ───────────────────────────────────────────────────────────────────────
+# Your actual domain where the frontend is hosted
+FRONTEND_URL=https://devsadik.me
+
+# Port — cPanel Node.js will set this automatically, leave as 3000 for local dev
+PORT=3000
+
+NODE_ENV=production

package/backend/.keystone_temp/admin/next.config.js

@@ -0,0 +1,14 @@
+const nextConfig = {
+    typescript: {
+      ignoreBuildErrors: true,
+    },
+    eslint: {
+      ignoreDuringBuilds: true,
+    },
+    // We use transpilePackages for the custom admin-ui pages in the ./admin folder
+    // as they import ts files into nextjs
+    transpilePackages: ['../../admin'],
+     
+  }
+  
+  module.exports = nextConfig

package/backend/.keystone_temp/admin/pages/_app.js

@@ -0,0 +1,22 @@
+import { getApp } from '@keystone-6/core/___internal-do-not-use-will-break-in-patch/admin-ui/pages/App';
+
+import * as view0 from "@keystone-6/core/___internal-do-not-use-will-break-in-patch/admin-ui/id-field-view";
+import * as view1 from "@keystone-6/core/fields/types/text/views";
+import * as view2 from "@keystone-6/core/fields/types/password/views";
+import * as view3 from "@keystone-6/core/fields/types/checkbox/views";
+import * as view4 from "@keystone-6/core/fields/types/timestamp/views";
+import * as view5 from "@keystone-6/fields-document/views";
+import * as view6 from "@keystone-6/core/fields/types/float/views";
+import * as view7 from "@keystone-6/core/fields/types/integer/views";
+import * as view8 from "@keystone-6/core/fields/types/relationship/views";
+import * as view9 from "@keystone-6/core/fields/types/select/views";
+
+var adminConfig = {};
+
+export default getApp({
+  lazyMetadataQuery: {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"query","selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"keystone","loc":{"start":22,"end":30}},"arguments":[],"directives":[],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"adminMeta","loc":{"start":39,"end":48}},"arguments":[],"directives":[],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"lists","loc":{"start":59,"end":64}},"arguments":[],"directives":[],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"key","loc":{"start":77,"end":80}},"arguments":[],"directives":[],"loc":{"start":77,"end":80}},{"kind":"Field","name":{"kind":"Name","value":"isHidden","loc":{"start":91,"end":99}},"arguments":[],"directives":[],"loc":{"start":91,"end":99}},{"kind":"Field","name":{"kind":"Name","value":"fields","loc":{"start":110,"end":116}},"arguments":[],"directives":[],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"path","loc":{"start":131,"end":135}},"arguments":[],"directives":[],"loc":{"start":131,"end":135}},{"kind":"Field","name":{"kind":"Name","value":"createView","loc":{"start":148,"end":158}},"arguments":[],"directives":[],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"fieldMode","loc":{"start":175,"end":184}},"arguments":[],"directives":[],"loc":{"start":175,"end":184}}],"loc":{"start":159,"end":198}},"loc":{"start":148,"end":198}}],"loc":{"start":117,"end":210}},"loc":{"start":110,"end":210}}],"loc":{"start":65,"end":220}},"loc":{"start":59,"end":220}}],"loc":{"start":49,"end":228}},"loc":{"start":39,"end":228}}],"loc":{"start":31,"end":234}},"loc":{"start":22,"end":234}},{"kind":"Field","name":{"kind":"Name","value":"authenticatedItem"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"User"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"name"}}]}}]}}]}}]},
+  fieldViews: [view0,view1,view2,view3,view4,view5,view6,view7,view8,view9],
+  adminMetaHash: "1pg71jx",
+  adminConfig: adminConfig,
+  apiPath: "/api/graphql",
+});

package/backend/.keystone_temp/admin/pages/index.js

@@ -0,0 +1 @@
+export { HomePage as default } from '@keystone-6/core/___internal-do-not-use-will-break-in-patch/admin-ui/pages/HomePage';

package/backend/.keystone_temp/admin/pages/init.js

@@ -0,0 +1,5 @@
+import { getInitPage } from '@keystone-6/auth/pages/InitPage';
+
+const fieldPaths = ["name","email","password"];
+
+export default getInitPage({"listKey":"User","fieldPaths":["name","email","password"],"enableWelcome":true});

package/backend/.keystone_temp/admin/pages/no-access.js

@@ -0,0 +1,3 @@
+import { getNoAccessPage } from '@keystone-6/core/___internal-do-not-use-will-break-in-patch/admin-ui/pages/NoAccessPage';
+
+export default getNoAccessPage({"sessionsEnabled":true})

package/backend/.keystone_temp/admin/pages/orders/[id].js

@@ -0,0 +1,3 @@
+import { getItemPage } from '@keystone-6/core/___internal-do-not-use-will-break-in-patch/admin-ui/pages/ItemPage';
+
+export default getItemPage({"listKey":"Order"})

package/backend/.keystone_temp/admin/pages/orders/create.js

@@ -0,0 +1,3 @@
+import { getCreateItemPage } from '@keystone-6/core/___internal-do-not-use-will-break-in-patch/admin-ui/pages/CreateItemPage';
+
+export default getCreateItemPage({"listKey":"Order"})

package/backend/.keystone_temp/admin/pages/orders/index.js

@@ -0,0 +1,3 @@
+import { getListPage } from '@keystone-6/core/___internal-do-not-use-will-break-in-patch/admin-ui/pages/ListPage';
+
+export default getListPage({"listKey":"Order"});

package/backend/.keystone_temp/admin/pages/salami-packages/[id].js

@@ -0,0 +1,3 @@
+import { getItemPage } from '@keystone-6/core/___internal-do-not-use-will-break-in-patch/admin-ui/pages/ItemPage';
+
+export default getItemPage({"listKey":"SalamiPackage"})

package/backend/.keystone_temp/admin/pages/salami-packages/create.js

@@ -0,0 +1,3 @@
+import { getCreateItemPage } from '@keystone-6/core/___internal-do-not-use-will-break-in-patch/admin-ui/pages/CreateItemPage';
+
+export default getCreateItemPage({"listKey":"SalamiPackage"})

package/backend/.keystone_temp/admin/pages/salami-packages/index.js

@@ -0,0 +1,3 @@
+import { getListPage } from '@keystone-6/core/___internal-do-not-use-will-break-in-patch/admin-ui/pages/ListPage';
+
+export default getListPage({"listKey":"SalamiPackage"});

package/backend/.keystone_temp/admin/pages/signin.js

@@ -0,0 +1,3 @@
+import { getSigninPage } from '@keystone-6/auth/pages/SigninPage'
+
+export default getSigninPage({"identityField":"email","secretField":"password","mutationName":"authenticateUserWithPassword","successTypename":"UserAuthenticationWithPasswordSuccess","failureTypename":"UserAuthenticationWithPasswordFailure"});

package/backend/.keystone_temp/admin/pages/users/[id].js

@@ -0,0 +1,3 @@
+import { getItemPage } from '@keystone-6/core/___internal-do-not-use-will-break-in-patch/admin-ui/pages/ItemPage';
+
+export default getItemPage({"listKey":"User"})

package/backend/.keystone_temp/admin/pages/users/create.js

@@ -0,0 +1,3 @@
+import { getCreateItemPage } from '@keystone-6/core/___internal-do-not-use-will-break-in-patch/admin-ui/pages/CreateItemPage';
+
+export default getCreateItemPage({"listKey":"User"})

package/backend/.keystone_temp/admin/pages/users/index.js

@@ -0,0 +1,3 @@
+import { getListPage } from '@keystone-6/core/___internal-do-not-use-will-break-in-patch/admin-ui/pages/ListPage';
+
+export default getListPage({"listKey":"User"});