CoDecide

---

Community portal for reporting and tracking neighborhood issues
— from infrastructure problems to coexistence conflicts.

---

Table of Contents

• Technologies and others
• Project Categories
• Structure
• Quick Start
• Team
• Documentation
• Contributing

---

Technologies and others

Build & Tooling

Frontend

Backend

---

Project Categories

• Social Inclusion — empowering residents to participate in community decisions
• Productivity — streamlining issue reporting and management
• Culture — fostering transparent coexistence and civic engagement

Structure

CoDecide/
├── apps/
│   ├── frontend/       # Vite + Vanilla JS SPA
│   └── backend/        # Flask REST API (MySQL + MongoDB)
├── docs/
│   ├── CONTRIBUTING.md      # Branch strategy, commit conventions, PR workflow (EN)
│   ├── CONTRIBUTING.es.md   # Same content in Spanish
│   ├── get-started/         # Quick start guides (EN/ES)
│   ├── frontend/            # Frontend architecture docs (EN/ES)
│   ├── backend/             # Backend architecture docs (EN/ES)
│   └── bug-report/          # Bug issue templates and guide (EN/ES)
├── LICENSE
├── .gitignore
├── README.md
└── README.es.md

Quick Start

See the Get Started guide for step-by-step setup instructions for Windows and Linux.

• Get Started (English)
• Primeros Pasos (Español)

Team

Backend

Name	Clan	GitHub
Brandon Carranza	Garabato	nastex123
Camilo Gale	Garabato	JuanGale-20

Frontend

Name	Clan	GitHub
Carlos Muñoz	Micaela	Carmuand
Maria Muñoz	Micaela	AngelusMunoz

QA, Test & DBA

Name	Clan	GitHub
Andrea Bernal	Cayena	Andrea2112Jotanicia

Scrum Master

Name	Clan	GitHub
Gustavo Guzmán	Micaela	Zerik-Official

Documentation

Language	Get Started	Frontend	Backend
English	Guide	Architecture	Architecture
Spanish	Guía	Arquitectura	Arquitectura

Contributing

See CONTRIBUTING.md for branch strategy, commit conventions, and PR workflow.

See the Bug Issue Guide for how to create and format bug reports.