{"id":49510604,"url":"https://github.com/williamw-dev/party","last_synced_at":"2026-05-01T19:01:15.487Z","repository":{"id":315760531,"uuid":"1017222588","full_name":"williamw-dev/party","owner":"williamw-dev","description":"Party is a party planning application that allows users to create and manage events","archived":false,"fork":false,"pushed_at":"2025-09-01T20:07:54.000Z","size":21732,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-20T15:54:11.670Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/williamw-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-10T07:57:58.000Z","updated_at":"2025-09-02T15:33:30.000Z","dependencies_parsed_at":"2025-09-20T16:04:37.507Z","dependency_job_id":null,"html_url":"https://github.com/williamw-dev/party","commit_stats":null,"previous_names":["williamw-dev/party"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/williamw-dev/party","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/williamw-dev%2Fparty","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/williamw-dev%2Fparty/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/williamw-dev%2Fparty/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/williamw-dev%2Fparty/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/williamw-dev","download_url":"https://codeload.github.com/williamw-dev/party/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/williamw-dev%2Fparty/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32508912,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-01T19:01:14.367Z","updated_at":"2026-05-01T19:01:15.479Z","avatar_url":"https://github.com/williamw-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎉 Party — Web Platform for Social Event Discovery\n\nParty is a full-stack web application enabling users to **explore, create, and join social events** hosted in bars and restaurants via an interactive map. The goal is to promote **social experiences** by recommending vibrant venues and fostering meaningful encounters.\n\n## 🧹 Tech Stack\n\n* **Monorepo** with `pnpm` workspaces\n* **Frontend**: Next.js (React) — component-driven architecture\n* **Backend**: Hono.js with RPC (type-safe API interaction)\n* **ORM**: Drizzle ORM (PostgreSQL)\n* **Realtime**: Redis\n* **Monitoring**: Prometheus + Grafana\n* **Validation**: `zodValidator` (Zod)\n* **Authentication**: JWT (stored in cookies, server-verified via middleware)\n\n## ⚙️ Installation Guide\n\n\u003e Make sure Docker and Make are installed on your system.\n\n```bash\ncd docker/prometheus \u0026\u0026 chmod +x entrypoint.sh\nmake build\nmake up\n```\n\nAccess the frontend via `http://localhost:3000`.\n\nPrometheus and Grafana dashboards are available at their respective ports.\n\n---\n\n## 🌐 API Overview\n\nAll request/response types are strongly typed via Hono RPC. Zod is used server-side to validate incoming payloads.\n\n| Method | Endpoint                                         | Description                        |\n| ------ | ------------------------------------------------ | ---------------------------------- |\n| POST   | `/auth/register`                                 | Register a new user                |\n| POST   | `/auth/login`                                    | Login and receive JWT in cookies   |\n| POST   | `/auth/logout`                                   | Logout and clear cookies           |\n| GET    | `/users/me`                                      | Get current authenticated user     |\n| PUT    | `/users`                                         | Update user profile                |\n| DELETE | `/users`                                         | Delete user account                |\n| GET    | `/places/search`                                 | Search for venues by name/type     |\n| GET    | `/places/search-cords`                           | Search places by coordinates       |\n| GET    | `/events/search`                                 | Search events with filters         |\n| GET    | `/events/:eventId`                               | Get details of a specific event    |\n| POST   | `/events`                                        | Create a new event                 |\n| PUT    | `/events/:eventId`                               | Update an existing event           |\n| DELETE | `/events/:eventId`                               | Delete an event                    |\n| POST   | `/participants/:eventId`                         | Request to join an event           |\n| GET    | `/participants/:eventId`                         | List pending/approved participants |\n| POST   | `/participants/:eventId/:participationId/accept` | Accept a participant request       |\n| POST   | `/reviews/:eventId`                              | Leave a review on an event         |\n| GET    | `/reviews/:eventId`                              | Get reviews for an event           |\n| GET    | `/metrics`                                       | Expose metrics (Prometheus format) |\n\nAll protected routes use an `auth` middleware checking the JWT stored in cookies.\n\n---\n\n## ✨ Key Features\n\n### 🗺️ Interactive Map\n\n* Dynamic map powered by Leaflet + OpenStreetMap\n* Filters by venue type, proximity, date\n* Real-time updates when filters change\n\n### 🎭 Event Management\n\n* Create/edit/delete events (requires a linked venue)\n* Add images and set participant limits\n* Only event owners can modify/delete events\n\n### 👥 Participation Flow\n\n* Users request to join events\n* Owners manually accept or reject\n* Accepted users can see the participants list\n\n### ⭐ Reviews\n\n* Participants can rate and review events\n* Optional image upload in reviews\n\n### 👤 User Accounts\n\n* Secure registration and login\n* Profile with joined and created events\n* Profile updates and deletion\n\n### 🔔 Organizer Dashboard\n\n* Admin view for event owners\n* Notification on new participation requests\n\n### 🧠 Recommendation System\n\n* Highlights trending places based on past events and reviews\n* Personalized suggestions based on user history\n\n---\n\n## 🧱 Project Structure\n\nThe codebase follows **domain-driven modular architecture**, with clear separation of concerns:\n\n```bash\nfeatures/\n  └── events/\n        ├── messages/       # Request/response types (RPC-safe)\n        ├── repository/     # Drizzle queries scoped to domain\n        ├── types/          # Domain-specific types\n        └── routes.ts       # Entry point for event-specific routes\n```\n\nThe backend logic is **grouped by domain** (e.g. `events`, `auth`, `users`), each featuring:\n\n* validated routes\n* business logic\n* repository access (Drizzle)\n\n---\n\n## 🎨 Frontend Design Pattern\n\nOur frontend applies a **component-driven approach**, strictly separating responsibilities:\n\n* All UI components are atomic and reusable\n* API calls are isolated in service modules (e.g., `eventsService.ts`)\n* We use the Hono client for RPC-style typed communication with the backend\n\nReact best practices followed:\n\n* **Smart/Dumb component separation**\n* **Colocation of logic and styling**\n* **Hooks for reusable behavior**\n* **Zustand (or equivalent) for lightweight state management**\n* **Framer Motion** for transitions (if used)\n\n---\n\n## 🔐 Security Measures\n\n* JWT stored in **HTTP-only cookies**, set with `SameSite=Strict`\n* JWT is verified in a backend **auth middleware** (no local/session storage)\n* Input data is validated with **Zod**\n* Routes are protected via role checks and context-aware guards\n\n\u003e Extra hardening (rate limits, CORS headers, helmet, etc.) can be added later if project scales.\n\n---\n\n## 📊 Observability\n\n* **Prometheus** exposes application metrics\n* **Grafana** dashboards visualize events, requests, and custom KPIs\n* `/metrics` endpoint exposes Prometheus-compatible data\n\n---\n\n## 📌 Additional Resources\n\n* See [ARCHITECTURE.md](./ARCHITECTURE.md) for architectural rationale and diagrams.\n* See [MCD](./docs/mcd.png) \u0026 [Optimisation SQL / DrizzleORM / Caching](./docs/sql.md) for DB schema, entity structure, and example data.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwilliamw-dev%2Fparty","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwilliamw-dev%2Fparty","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwilliamw-dev%2Fparty/lists"}