Project Plan - bounswe/bounswe2025group8 GitHub Wiki
📌 Project Plan: Neighborhood Assistance Board
🎯 Project Goal
Build a full-stack, cross-platform platform that connects people who need day-to-day help (shopping, small repairs, tutoring …) with nearby volunteers, while fostering trust through reviews and transparent task management.
🚀 Key Features
| Area |
Highlights |
| Assistance Requests |
Create, edit, cancel, update status; attach photos; set urgency & category |
| Volunteer Flow |
Browse/search tasks, volunteer, requester selects assignee, confirm completion |
| Rating & Reviews |
Mutual rating after task completion to build reputation |
| Personalised Feed & Search |
Filter by distance, category, urgency; real-time updates |
| Notifications |
Real-time (web/mobile push + email) for request status, messages, reviews |
| User Profiles |
Public profile with stats; editable personal info & photo |
| Admin Panel |
User & content moderation, ban users, view system metrics |
🧱 Tech Stack
| Layer |
Technology |
Rationale |
| Backend |
Django + Django REST Framework, PostgreSQL |
Rapid CRUD, robust auth, GIS extensions for distance queries |
| Frontend (Web) |
React, React Router, Redux Toolkit, Tailwind CSS |
SPA with predictable state, fast styling and routing |
| Mobile |
React Native + Expo |
Code-sharing with web React team, quick device testing |
| API Docs & Tests |
OpenAPI (drf-spectacular) + Postman |
Automated docs & regression tests |
| CI/CD & DevOps |
GitHub Actions, Docker, Fly.io |
Zero-downtime deploys, review apps per PR |
👥 Team Roles
| Role |
Responsibilities |
| Backend |
REST endpoints, DB schema, Postman tests |
| Frontend (Web) |
React pages (home, categories, auth, task detail), state mgmt |
| Mobile |
Expo app: bottom-bar nav, feed, search, request detail |
| DevOps & QA |
CI/CD, Docker files, automated testing matrix |
| Docs & PM |
Wiki structure, effort logs, sprint planning |
🗓️ Timeline (Feb 18 – May 15, 2025)
| Date Range |
Phase |
Key Deliverables / Relevant Issues |
| Feb 18 – Feb 25 |
Team On-boarding & Wiki Setup |
Wiki home/sidebar, labels & templates, communication plan |
| Feb 26 – Mar 10 |
Requirements Elicitation |
Functional + non-functional requirement docs approved |
| Mar 11 – Mar 31 |
System Design |
Use-case map, UML (class, sequence), high-level architecture, conceptual DB model |
| Apr 01 – Apr 15 |
UI/UX & Tech Finalisation |
Figma wire-frames, design tokens, tech-stack decision notes, API style-guide |
| Apr 16 – Apr 30 |
Sprint 1 • Core Implementation |
• Backend skeleton (auth + task CRUD) • PostgreSQL migrations & seed script • GitHub Actions CI • React base layout • Expo project bootstrap |
| May 01 – May 07 |
Sprint 2 • Feature Expansion |
API endpoints, notification module draft, React feed filters, Expo bottom-nav POC |
| May 08 – May 12 |
Integration & Testing |
Web+mobile wired to staging API, Postman regression suite, unit/integration tests ≥ 80 % |
| May 13 – May 14 |
UX Polish & Documentation |
Lighthouse ≥ 90, responsive tweaks, EN/TR localisation, wiki refresh, architecture diagram export, demo script |
| May 15 |
Demo Day (Milestone-2) |
Live demo, code-freeze, tag v1.0.0, presentation deck, recorded video |
✅ Deliverables
- Functional REST API
- Responsive web SPA (React)
- Expo mobile app
- Docker-compose stack
- Comprehensive Postman collection
- Updated Wiki: requirements, UML diagrams, sequence diagrams, communication & project plans
- Presentation deck + demo video
📁 Suggested Repo Structure
/backend # Django project & app modules
│ └─ Dockerfile
/frontend # React SPA
/mobile # React Native (Expo)
/infrastructure # docker-compose.yml, GitHub Actions, Fly configs
/docs # UML, API schema, meeting notes
/tests # Shared test utilities