README_HF.md

metadata

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 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.