Harimohan'12 Alumni Portal
Ex-student registration with admin approval, a public alumni directory, a member portal with notices, and event fee payment through bKash Tokenized Checkout. Laravel 13, PHP 8.4, Tailwind CSS v4, mobile-first.
Live: https://harimohan-12.vercel.app · New to the code? Read this file, then docs/ARCHITECTURE.md.
Features
Visitors (welcome page)
- Hero banner, latest notices, and the alumni directory of approved members: photo, SSC batch, job, blood group, LinkedIn / Facebook
- Search by name, job or batch and filter by batch; phone numbers only for logged-in approved members ("Log in to contact")
Members
- Register with name, email, 11-digit mobile (01XXXXXXXXX), SSC batch, optional details and photo, plus any extra questions the admin adds
- Choose a photo and position it in a card-shaped frame (drag, zoom, pinch); iPhone HEIC photos are converted automatically
- Log in with email or mobile number; logins are remembered for 10 days; Forgot password by email
- Portal: account status, current event, notices (pinned first), payment history, My Profile
- Pay the event fee with bKash once approved (switched off until bKash goes live)
Admins (/admin, menu grouped into Members, Events and Communication)
- Dashboard: registrations, paid count, money collected, batch chart; a 🔔 bell for new registrations
- Students: search, filter by status, batch or any answer, approve / reject, answer columns and totals (e.g. T-shirt size XL: 12), CSV export, Adjust card photo
- Student fields: extra questions as short text, number, long text, date, dropdown, radio buttons, checkboxes or an image only (e.g. a size chart)
- Announcements with banner, pin, schedule and draft; Email members (one copy per member, Brevo daily limit shown); Welcome page hero editor
- Events and Payments (filters, TrxID search, CSV export)
- Super admins can make approved students admins
Run it on your computer
You need PHP 8.4, Composer, Node.js 22 and MySQL 8 (or SQLite for a quick look).
git clone https://github.com/rafiulalamantar/harimohan-12.git && cd harimohan-12
composer install
npm install
cp .env.example .env
php artisan key:generate
php artisan storage:link # serves uploaded photos and banners from storage/app/public
.env.example uses SQLite. For MySQL (closer to the live site), create a database and set:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=harimohan_local
DB_USERNAME=root
DB_PASSWORD=your-local-password
Create the tables and data, then start the app:
php artisan migrate --seed # tables, the admin, a demo member, a sample event and notice
php artisan db:seed --class=DemoAlumniSeeder # optional: 120 realistic demo alumni
composer run dev # app + Vite at http://localhost:8000
The demo seeders refuse to run in production. Locally, emails (password resets, member emails) are written to storage/logs/laravel.log instead of being sent.
Everyday commands
composer run dev # run the app with live CSS/JS reloading
php artisan test --compact # all tests (in-memory SQLite, no setup needed)
php artisan test --compact --filter=StudentFieldTest
vendor/bin/pint --dirty # format the PHP files you changed
npm run build # production CSS/JS (needed if you are not running composer run dev)
php artisan route:list --except-vendor # every URL and its controller
If a page looks unstyled or you see "Unable to locate file in Vite manifest", run npm run build or composer run dev.
How we work
- Create a branch from
main (feat/..., fix/..., refactor/...).
- Make the change with a test, run
vendor/bin/pint --dirty and php artisan test --compact.
- Push the branch; GitHub Actions runs Pint, the tests and the asset build.
- When CI is green, merge into
main with git merge --no-ff and push. Pushing main deploys the live site. Run new migrations on production first.
- For a release, bump
version in config/app.php and push an annotated tag vX.Y.Z whose message holds the release notes. CI publishes the GitHub release and updates CHANGELOG.md.
Where code belongs, naming rules and the main flows (photos, payments, student fields) are explained in docs/ARCHITECTURE.md.
Email (password reset)
Locally MAIL_MAILER=log writes emails to storage/logs/laravel.log, so reset links can be copied from there.
In production use any SMTP provider. With the Brevo free plan (300 emails/day):
MAIL_MAILER=smtp
MAIL_HOST=smtp-relay.brevo.com
MAIL_PORT=587
MAIL_USERNAME=<Brevo SMTP login>
MAIL_PASSWORD=<Brevo SMTP key>
MAIL_FROM_ADDRESS=<a sender verified in Brevo>
Gmail SMTP also works (smtp.gmail.com, port 587, an App Password). Reset links expire after 60 minutes.
bKash integration
Uses PGW Tokenized Checkout v1.2.0-beta (app/Services/BkashService.php):
grant token (cached ~50 min)create → student is redirected to bkashURL- bKash redirects back to
/payment/bkash/callback?paymentID=..&status=success|failure|cancel
execute; if execute errors or times out, payment/status query is used to confirm- Payment is marked completed only if bKash says
Completed and the amount and invoice match our record. The row is locked during this, so a page refresh can't double-execute.
.env:
BKASH_SANDBOX=true
BKASH_USERNAME=...
BKASH_PASSWORD=...
BKASH_APP_KEY=...
BKASH_APP_SECRET=...
This is the beginning of the README. Read the rest at the original. Read the full README ↗
