Software Engineering Academy — COMPFEST 18
Welcome to the SEAPEDIA documentation. SEAPEDIA is a multi-role e-commerce platform connecting Buyers, Sellers, Drivers, and Administrators in a single marketplace. This documentation covers the complete technical and business flow across all 7 challenge levels.
| Component | URL |
|---|---|
| Frontend | seapedia.sayyidrafee.com |
| API gateway (Kong) | api-seapedia.sayyidrafee.com |
| API Docs (Scalar) | api-seapedia.sayyidrafee.com/docs |
| Document | Description |
|---|---|
| SETUP.md | Local development and the production-like stack, environment variables |
| DEPLOYMENT.md | Dokploy runbook: one application per service, memory budget, cut-over |
| SEED-DATA.md | Demo accounts, test data, and seed data reference |
| DEMO-GUIDE.md | Step-by-step walkthrough script for judges |
| Document | Description |
|---|---|
| architecture/overview.md | Services, data stores, and how they connect |
| architecture/data-ownership.md | Which service owns which table; replicas and read models |
| architecture/communication.md | Events on RabbitMQ, the remaining synchronous calls, failure behaviour |
| architecture/security.md | Tokens, sessions, Kong and service authorization, broker permissions |
| architecture/platform.md | Consul configuration and service discovery |
| architecture/decisions/ | Architecture decision records |
| AUTH.md | Authentication system, JWT sessions, multi-role model, and role selection |
| BUSINESS-RULES.md | Core business rules, financial calculations, and constraints |
| ORDER-LIFECYCLE.md | Order status flow, transitions, and status history |
| SCHEMA.md | Database schema reference with all tables and relationships |
| API.md | API overview, endpoint reference, and request/response formats |
| Document | Description |
|---|---|
| GUEST.md | Guest browsing, product catalog, public reviews |
| SELLER.md | Store management, product CRUD, order processing, income reports |
| BUYER.md | Wallet, addresses, cart, checkout, order history, spending reports |
| DRIVER.md | Find jobs, take jobs, complete delivery, earnings |
| ADMIN.md | Monitoring dashboard, discount management, time simulation, overdue handling |
| Document | Description |
|---|---|
| DISCOUNTS.md | Voucher and promo system, combination rules, validation |
| DELIVERY.md | Delivery methods, SLA rules, driver assignment |
| OVERDUE.md | Overdue detection, auto-refund, auto-return, time simulation |
| SECURITY.md | SQL injection, XSS prevention, RBAC, input validation |
| Layer | Backend | Frontend |
|---|---|---|
| Runtime | Bun | Bun (Vite) |
| Framework | Hono | React 19 |
| Database | PostgreSQL 17 | — |
| ORM | Drizzle ORM | — |
| Auth | JWT (HS256, HttpOnly cookie) | Cookie-based session |
| Validation | Zod | — |
| API Docs | Scalar (OpenAPI) | — |
| API Client | — | hey-api (generated SDK) |
| Routing | Hono routes | TanStack Router |
| Styling | — | Tailwind CSS v4 + shadcn/ui |
| Object Storage | Cloudflare R2 | — |
| i18n | — | i18next (EN/ID) |
seapedia/
├── apps/web/ # React SPA
│ └── src/
│ ├── routes/ # TanStack Router file routes
│ ├── features/ # Domain feature slices
│ ├── components/ # Shared + shadcn/ui components
│ ├── hooks/ # Custom React hooks
│ └── lib/
│ ├── api/ # hey-api generated SDK
│ ├── auth/ # Auth context + route guards
│ ├── query/ # TanStack Query client
│ └── i18n/ # i18next (EN/ID locales)
├── services/ # identity, catalog, commerce, search
│ └── <service>/src/
│ ├── modules/ # Feature slices owned by that service
│ └── db/ # That service's own data store
├── packages/platform/ # Technical code shared by services
├── infra/ # Kong, Consul, RabbitMQ, MongoDB bootstrap, seed tool
├── docs/ # This documentation
├── docker-compose.yml # Dev infrastructure + Kong
└── docker-compose.prod.yml # Every service from its production image
| Level | Feature | Points | Status |
|---|---|---|---|
| 1 | Public marketplace, auth & role awareness, public reviews | 20 | ✅ |
| 2 | Seller store & product management, public catalog | 15 | ✅ |
| 3 | Buyer wallet, cart, checkout, order history | 20 | ✅ |
| 4 | Voucher/promo discounts, seller order processing, reports | 15 | ✅ |
| 5 | Delivery workflow, driver dashboard & earnings | 10 | ✅ |
| 6 | Admin monitoring, discount management, overdue handling | 10 | ✅ |
| 7 | Security hardening (XSS, SQLi, RBAC, input validation) | 10 | ✅ |
| Bonus | UI quality + deployment | 25 | In Progress |
| Role | Password | |
|---|---|---|
| Admin | admin@gmail.com | password123 |
| Seller | budi@gmail.com | password123 |
| Buyer | dewi@gmail.com | password123 |
| Driver | joko@gmail.com | password123 |
| Multi-role | rina.m@gmail.com | password123 |
| Service | Local | Production |
|---|---|---|
| Frontend | localhost:5173 | seapedia.sayyidrafee.com |
| Backend API | localhost:3001 | api-seapedia.sayyidrafee.com |
| API Docs | localhost:3001/docs | api-seapedia.sayyidrafee.com/docs |
| OpenAPI JSON | localhost:3001/openapi.json | api-seapedia.sayyidrafee.com/openapi.json |