❤️ Plataforma solidaria, transparente y trazable
_{Conectamos instituciones que necesitan ayuda con personas y organizaciones dispuestas a brindarla.}

---

✨ Highlights

---

🍁 Introducción

Conectando Corazones es una plataforma digital sin fines de lucro que vincula a instituciones que necesitan ayuda —como escuelas, hospitales y comedores— con personas, ONGs y empresas dispuestas a brindarla en Argentina.

---

🎯 Propósito

Facilitar la ayuda con trazabilidad total.
Cada proyecto tiene evidencias verificables para garantizar confianza entre instituciones, colaboradores y comunidad.

---

🚀 Funcionalidades

Característica	Descripción
✅ Registro verificado	Email institucional, revisión documental, RENAPER (post-MVP)
📄 Publicación de proyectos	Solo por instituciones verificadas
🤝 Colaboraciones	Personas, ONGs, empresas
💬 Chat seguro	Habilitado tras aceptación
📸 Evidencias	Cierre obligatorio con fotos/documentos
📊 Dashboard	Métricas, seguimiento y recomendaciones
💞 Accesibilidad	Diseño inclusivo y ético

⚖️ Aviso legal: no procesamos pagos, no actuamos como escrow, no garantizamos legitimidad absoluta. La plataforma provee trazabilidad para control ciudadano.

---

👥 Usuarios

Rol	Permisos	Ejemplos
🏫 Instituciones	Publicar proyectos, gestionar colaboradores, subir evidencias	Escuelas, comedores, hospitales
🤲 Colaboradores	Postularse, enviar recursos, participar en chats	Voluntarios, empresas, ONGs
🛡️ Administradores	Verificar cuentas, moderar contenido, auditar proyectos	Equipo técnico y ético

Cómo funciona (en 6 pasos)

flowchart LR
  A[Institución publica necesidad] --> B[Define objetivos]
  B --> C[Colaboradores exploran y se postulan]
  C --> D[Institución acepta propuestas]
  D --> E[Chat grupal para coordinar]
  E --> F[Evidencias + Cierre con impacto]

Loading

---

💻 Stack Tecnológico

Frontend

Backend

Infraestructura

---

📖 Documentación

Sección	Contenido
📘 Guía Usuarios	Cómo publicar, colaborar y subir evidencias
🤝 Guía Devs	Diagramas, ADRs y decisones técnicas
🔐 Marco Legal	Datos y políticas de privacidad

---

📂 Estructura del Repositorio

📦 Conectando-Corazones
├── 🟦 frontend/       → SvelteKit + TailwindCSS
├── ⬛ backend/         → Express + Prisma + PostgreSQL
├── 🟨 docs-site/       → Documentación con Docusaurus
├── 📂 .github/         → Workflows, issues, CODE_OF_CONDUCT
├── 📄 CONTRIBUTING.md  → Guía de contribución
├── 📄 LICENSE          → AGPL-3.0
└── 📄 SECURITY.md      → Política de seguridad

---

🤝 Contribuir

🛠️ Comenzá así:

# 1. Clonar el repositorio
git clone https://github.com/MVRU/Conectando-Corazones.git

# 2. Instalar dependencias
cd frontend && npm install
cd ../backend && npm install

# 3. Crear una rama
git checkout -b feature/descripcion-clara

👉 Guía completa → CONTRIBUTING.md

---

🛡️ Comunidad y Seguridad

• 📜 Código de Conducta
• 🔐 Política de Seguridad
• 🧾 Licencia AGPL-3.0

🔒 Datos y privacidad

Política	Acciones
Privacidad	Datos mínimos, cifrado en Firebase, eliminación de metadatos
Acceso	Restringido a roles autorizados
Responsabilidad	Control total del usuario sobre su información
Ética	Difuminado de rostros, protección de menores

---

🎓 Créditos

Proyecto desarrollado como trabajo final de Ingeniería en Sistemas de Información – UTN FRRo.

Alexis Julián Sklate	Marina Ana Milo	Martín Tomás Álvarez
@AleSklate0807	@MVRU	@TomasAlvarez0

---

📬 Contacto

---

_{❤️ Hecho con propósito, código limpio y mucho corazón.}