How ishitasem/planzypop works
PlanzyPop is a student-focused event planning and budget-management application. Hosts use the React workspace to create and manage events, record and split expenses, track preparation tasks, and request rule-based planning suggestions; they can also discover and save nearby Chandigarh spots. The backend exposes FastAPI routes, validates requests, and persists event-related records and saved spots in SQLite, while spot discovery uses external place sources. The graph includes documented capabilities whose implementation was not sampled; dashed edges mark screen links that the README describes but the excerpts do not establish individually.
Main entry points: App.tsx Workspace Router · api.ts Typed API Client · main.py FastAPI Application · database.py SQLite Store
Components 34
Planning Workspace
- Workspace Router
frontend/src/App.tsx - Dashboard
frontend/src/pages/Overview.tsx - Event Management
frontend/src/pages/MyEvents.tsx - Event Details
frontend/src/pages/EventDetail.tsx - Budget & Splits
frontend/src/pages/Budget.tsx - Checklist Timeline
frontend/src/pages/Checklist.tsx - Planning Suggestions
frontend/src/pages/Planner.tsx - Host Preferences
frontend/src/pages/Profile.tsx - Settings
frontend/src/pages/SettingsScreen.tsx
Planning API
- Typed API Client
frontend/src/services/api.ts - FastAPI Application
backend/main.py - Event Routes
backend/routers/events.py - Expense Routes
backend/routers/expenses.py - Task Routes
backend/routers/tasks.py - Suggestion Routes
backend/routers/suggestions.py - Rule Engine
backend/suggestions.py - Validation Schemas
backend/schemas.py - Relational Models
backend/models.py - SQLite Store
backend/database.py
Nearby Discovery
- Nearby Finder
frontend/src/pages/Nearby.tsx - Cafe Suggestions
frontend/src/components/nearby/CafeSuggestions.tsx - Spot Map
frontend/src/components/nearby/SpotMap.tsx - Spot Routes
backend/routers/spots.py - Spot Discovery Service
backend/spots_service.py - Geoapify Client
backend/geoapify_client.py - Chandigarh Boundary
backend/chandigarh_boundary.py - Food Intelligence
backend/food_intelligence.py
UI Foundation
- Button
frontend/src/components/common/Button.tsx - Icon
frontend/src/components/common/Icon.tsx - Icon Button
frontend/src/components/common/IconButton.tsx - Header
frontend/src/components/common/Header.tsx - Display Formatters
frontend/src/utils/formatters.ts - Progress Indicator
frontend/src/components/common/Progress.tsx
Other components
- Host
Connections 42
- Host → Workspace Router: uses
README.md - Workspace Router → Dashboard: routes to
- Workspace Router → Event Management: routes to
- Workspace Router → Event Details: routes to
- Workspace Router → Budget & Splits: routes to
- Workspace Router → Checklist Timeline: routes to
- Workspace Router → Planning Suggestions: routes to
- Workspace Router → Host Preferences: routes to
- Workspace Router → Settings: routes to
- Workspace Router → Nearby Finder: routes to
- Dashboard → Typed API Client: requests data
frontend/src/pages/Overview.tsx - Event Management → Typed API Client: manages events
frontend/src/pages/MyEvents.tsx - Event Details → Typed API Client: loads event
frontend/src/pages/EventDetail.tsx - Budget & Splits → Typed API Client: tracks spending
frontend/src/pages/Budget.tsx - Checklist Timeline → Typed API Client: manages tasks
- Planning Suggestions → Typed API Client: requests ideas
frontend/src/pages/Planner.tsx - Typed API Client → FastAPI Application: calls HTTP API
frontend/src/services/api.ts - FastAPI Application → Event Routes: registers
backend/main.py - FastAPI Application → Expense Routes: registers
backend/main.py - FastAPI Application → Task Routes: registers
backend/main.py - FastAPI Application → Suggestion Routes: registers
backend/main.py - FastAPI Application → Spot Routes: registers
backend/main.py - Event Routes → SQLite Store: opens sessions
backend/routers/events.py - Expense Routes → SQLite Store: opens sessions
backend/routers/expenses.py - Task Routes → SQLite Store: opens sessions
backend/routers/tasks.py - Event Routes → Relational Models: queries events
backend/routers/events.py - Expense Routes → Relational Models: queries expenses
backend/routers/expenses.py - Task Routes → Relational Models: queries tasks
backend/routers/tasks.py - Relational Models → SQLite Store: maps through
backend/models.py - Suggestion Routes → Rule Engine: delegates to
backend/routers/suggestions.py - Suggestion Routes → Validation Schemas: validates with
backend/routers/suggestions.py - Nearby Finder → Typed API Client: searches spots
- Nearby Finder → Cafe Suggestions: shows suggestions
- Spot Routes → Spot Discovery Service: searches through
backend/routers/spots.py - Spot Routes → SQLite Store: stores favorites
backend/routers/spots.py - Spot Discovery Service → Geoapify Client: uses provider
backend/geoapify_client.py - Spot Discovery Service → Chandigarh Boundary: checks coordinates
backend/spots_service.py - Typed API Client → Spot Routes: calls spot endpoints
frontend/src/services/api.ts - Button → Icon: renders
frontend/src/components/common/Button.tsx - Icon Button → Icon: renders
frontend/src/components/common/IconButton.tsx - Header → Icon Button: uses
frontend/src/components/common/Header.tsx - Budget & Splits → Display Formatters: formats values
frontend/src/pages/Budget.tsx