Home - bounswe/bounswe2026group4 GitHub Wiki

🗺️ StoryMap

Welcome to the official wiki of the Local History Story Map project.

An interactive platform for collecting, mapping, and sharing neighborhood histories and historical photographs - preserving disappearing community stories through technology.

Story Map Logo

👥 Who Are We?

We are a group of Computer Engineering students at Boğaziçi University. We are developing a platform for sharing local histories for our course CmpE 354 - Software Engineering.

Name Email
Oğuz Semih Arık [email protected]
Ömer Faruk Çelik [email protected]
Sezin Doğan [email protected]
Ahmet Çağdaş Girit [email protected]
Mert Eren Kaplan [email protected]
Aysu Keskin [email protected]
Kemal Mahmutoğulları [email protected]
Osman Yusuf Tosun [email protected]

📖 Project Description

StoryMap is a digital storytelling platform designed to preserve community memory.
It enables users to collect, upload, map, and explore:

  • 🎙️ Oral histories from local residents
  • 🖼️ Historical photographs
  • 📍 Location-based community stories
  • 🕰️ Timeline-based historical narratives

The platform connects places with memories, ensuring that valuable neighborhood stories are not lost over time.

Core Features (Planned)

  • Interactive map-based story browsing
  • Timeline visualization of historical events
  • Media upload and management system
  • Tagging and metadata support
  • Search by location, date, or theme

🧩 Team Structure & Roles

We organized our development responsibilities based on functional areas of the system. This structure helps us coordinate development efficiently and clearly distribute responsibilities.

Backend Development

Responsible for server-side logic, data handling, API development, and database integration.

  • Aysu Keskin (primary responsibility)
  • Ahmet Çağdaş Girit
  • Kemal Mahmutoğulları (secondary responsibility)

Frontend Development - Mobile Team

Responsible for user interface, client-side interactions, visual components, and user experience.

  • Sezin Doğan (web)
  • Ömer Faruk Çelik (web)
  • Osman Yusuf Tosun (mobile)
  • Mert Eren Kaplan (mobile)
  • Oğuz Semih Arık (mobile)

DevOps

Responsible for deployment processes, development environment setup, and infrastructure support.

  • Kemal Mahmutoğulları (primary responsibility)
  • Aysu Keskin (secondary responsibility)

🚀 Planning

Here you can find everything we documented during the initial phases of our project: Requirement Elicitation and Design

Team Conventions

Customer Meetings

Tech Stack

Backend

  • Language: Python 3.12
  • Framework: Django 4.2 + Django REST Framework 3.15
  • Database: MySQL 8.0
  • Testing: pytest, pytest-django, factory-boy

Frontend

  • Framework: React 19 (Vite 8)
  • Styling: Tailwind CSS 4 + shadcn/ui
  • Routing: React Router v7
  • Maps: Leaflet
  • Testing: Vitest + React Testing Library

Mobile

  • Framework: React Native 0.81 via Expo 54
  • Language: TypeScript 5.9
  • Maps: react-native-maps
  • Testing: Jest + jest-expo + testing-library/react-native
  • Platforms: iOS, Android

Deployment & Infrastructure

  • Containers: Docker (multi-stage builds), Docker Compose (dev + prod configs)
  • Reverse Proxy / Static Serving: Nginx (Alpine)
  • CI/CD: GitHub Actions — runs pytest, ESLint + Vite build, Jest; auto-deploys to self-hosted server via SSH on successful CI

Milestones

Here you can find our detailed implementation plans for our milestones:

Here you can find the reviews and reports of our completed milestones:

Scenarios

Use-Case Diagrams

Class Diagram

Sequence Diagrams

📅 Weekly Meetings

Backend Team Meetings
Mobile Team Meetings
Frontend Team Meetings

💻 Lab Reports

Templates

Here we have some templates to make our contributions to the project easier

🌍 Vision Statement

"Every neighborhood has stories. We make sure they are not forgotten."

Last updated: [04.04.2026]

Footer Placholder.

⚠️ **GitHub.com Fallback** ⚠️