How fudarren/mutiara-connect works
Mutiara-Connect is a community portal for Penang LRT construction information, news, notifications, and public feedback, with a separate staff management area. Residents browse project updates and map details, read news and alerts, or submit and track reports; staff manage complaints, construction updates, and announcements. The README describes feedback and the Telegram bot as mock/in-memory prototypes, and admin data as browser-localStorage backed. Source-index references and README route descriptions support the shown links; unsampled details and integrations are omitted where their wiring is not established.
Main entry points: page.tsx Portal home · ConstructionExplorer.tsx Project explorer · store.ts Admin records · NotificationCenter.tsx Notification centre
Components 25
Community portal
- Portal home
app/page.tsx - Sign-in
components/LoginPage.tsx - Browser session
lib/session.ts - Construction news
app/news/page.tsx - News data
lib/news.ts - News endpoint
app/api/news/route.ts
Construction information
- Project explorer
components/construction/ConstructionExplorer.tsx - Construction map
components/construction/ConstructionMap.tsx - Update filtering
lib/construction.ts - Update store
lib/constructionStore.ts - Project details
components/construction/ConstructionDetail.tsx
Staff management
- Admin overview
components/admin/DashboardPage.tsx - Complaint management
components/admin/ComplaintsPage.tsx - Announcement management
components/admin/AnnouncementsPage.tsx - Construction management
components/admin/ConstructionPage.tsx - Admin records
lib/admin/store.ts
Feedback and alerts
- Construction notices
lib/constructionNotices.ts - Notification centre
components/notification/NotificationCenter.tsx - Notification state
lib/notificationStore.ts - Feedback centre
components/feedback/FeedbackCenter.tsx - Feedback helpers
lib/feedback.ts - Notification preferences
components/notification/NotificationPreferences.tsx - Mock Telegram bot
telegram-bot/bot.mjs
Other components
- Community visitor
- Staff administrator
Connections 27
- Community visitor → Portal home: browses
- Portal home → Browser session: checks session
app/page.tsx - Community visitor → Sign-in: signs in
- Sign-in → Browser session: authenticates locally
components/LoginPage.tsx - Portal home → Construction news: opens news
- Construction news → News data: loads articles
app/news/page.tsx - News endpoint → News data: reads news
app/api/news/route.ts - Portal home → Project explorer: opens projects
- Project explorer → Update filtering: filters updates
components/construction/ConstructionExplorer.tsx - Project explorer → Update store: reads updates
components/construction/ConstructionExplorer.tsx - Project explorer → Construction map: renders map
- Project explorer → Project details: opens details
- Portal home → Notification centre: opens alerts
- Notification centre → Notification state: reads and marks
components/notification/NotificationCenter.tsx - Notification centre → Construction notices: uses notice dates
components/notification/NotificationCenter.tsx - Community visitor → Feedback centre: submits report
- Feedback centre → Feedback helpers: formats reports
components/feedback/FeedbackCenter.tsx - Community visitor → Notification preferences: sets preferences
- Staff administrator → Admin overview: opens admin
- Staff administrator → Complaint management: reviews complaints
- Staff administrator → Announcement management: manages notices
- Staff administrator → Construction management: manages updates
- Admin overview → Admin records: loads records
- Complaint management → Admin records: updates records
- Announcement management → Admin records: updates records
- Construction management → Admin records: manages records
components/admin/ConstructionPage.tsx - Community visitor → Mock Telegram bot: uses mock bot