README

Open-Source Civic Issue Tracking · Drupal 11 · Open311

Features

• Citizen Reporting – Photos, descriptions, geolocation
• Interactive Maps – Pinpoint locations, clustering, filtering
• Open311 API – Standard GeoReport v2 integration
• Workflow Management – Track issues from report to resolution

Built for municipalities, public service departments, and civic tech organizations.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                     Frontend (PWA)                          │
│         Vue 3 · TypeScript · Tailwind · MapLibre            │
└─────────────────────────────┬───────────────────────────────┘
                              │
                    HTTPS/JSON (REST)
                              │
┌─────────────────────────────▼───────────────────────────────┐
│                    Drupal 11 Backend                        │
│                                                             │
│  ┌──────────────────────┐  ┌──────────────────────┐        │
│  │     Open311 API      │  │       JSON:API       │        │
│  │     (GeoReport)      │  │        (CRUD)        │        │
│  └──────────────────────┘  └──────────────────────┘        │
└─────────────────────────────────────────────────────────────┘

Quick Start

Requires DDEV.

git clone https://github.com/markaspot/mark-a-spot.git
cd mark-a-spot
ddev start
ddev ssh
./scripts/start.sh -y
exit

Access:

• Backend: https://mark-a-spot.ddev.site
• Frontend: https://mark-a-spot.ddev.site:8040
• Admin: ddev drush uli

Installation Options

Combine flags as needed: ./scripts/start.sh -t -a

Multilingual Setup

Use -t for Drupal translations, -a for AI-powered content translation. Requires OPENAI_API_KEY. See ./scripts/start.sh --help for details.

API

Implements the Open311 GeoReport v2 standard.

Requirements

• PHP 8.3+
• Node.js 22+ (LTS)
• MySQL 8.0+ / MariaDB 10.6+
• Composer 2.x

Contributing

• GitHub Issues
• Mark-a-Spot Profile

License

GPL-2.0-or-later