---
title: Participatory Planning Application
emoji: 🏙️
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
license: mit
---

# Participatory Planning Application

An AI-powered collaborative urban planning platform for multi-stakeholder engagement sessions.

**Created by: Marcos Thadeu Queiroz Magalhães** (thadillo@gmail.com)
Copyright © 2024-2025. All rights reserved.

*Developed using [Claude Code](https://claude.com/claude-code) for AI-enhanced development.*

## Features

- 🎯 **Token-based access** - Self-service registration for participants
- 🤖 **AI categorization** - Automatic classification using Hugging Face models (free & offline)
- 🗺️ **Geographic mapping** - Interactive visualization of geotagged contributions
- 📊 **Analytics dashboard** - Real-time charts and category breakdowns
- 💾 **Session management** - Export/import for pause/resume workflows
- 👥 **Multi-stakeholder** - Government, Community, Industry, NGO, Academic, Other

## Quick Start

1. Access the application
2. Login with admin token: `<see-startup-logs-or-set-ADMIN_TOKEN>`
3. Go to **Registration** to get the participant signup link
4. Share the link with stakeholders
5. Collect submissions and analyze with AI

## Default Login

- **Admin Token**: `<see-startup-logs-or-set-ADMIN_TOKEN>`
- **Admin Access**: Full dashboard, analytics, moderation

## Tech Stack

- Flask (Python web framework)
- SQLite (database)
- Hugging Face Transformers (AI classification)
- Leaflet.js (maps)
- Chart.js (analytics)
- Bootstrap 5 (UI)

## Demo Data

The app starts empty. You can:
1. Generate tokens for test users
2. Submit sample contributions
3. Run AI analysis
4. View analytics dashboard

## License

MIT License - Copyright © 2024-2025 Marcos Thadeu Queiroz Magalhães (thadillo@gmail.com)

This software must be cited and credited to Marcos Thadeu Queiroz Magalhães whenever used or employed.