| 1 | # MAPS Connect |
| 2 | |
| 3 | **Plataforma Académica y de Mentoría** para Universidad Tecmilenio que conecta estudiantes, docentes y egresados. |
| 4 | |
| 5 | ## 🎯 ¿Qué es? |
| 6 | |
| 7 | MAPS Connect es una red colaborativa que permite: |
| 8 | - 💬 Foro de dudas académicas |
| 9 | - 💡 Compartir tips de estudio |
| 10 | - 📚 Repositorio de apuntes |
| 11 | - 👥 Círculos de estudio |
| 12 | - 💌 Mensajería privada |
| 13 | - 🏢 Reseñas de empresas (Semestre Empresarial) |
| 14 | - 🎓 Gestión del modelo académico MAPS |
| 15 | |
| 16 | ## 🏗️ Tecnología |
| 17 | |
| 18 | | Capa | Tecnología | |
| 19 | |------|-----------| |
| 20 | | **Backend** | Java 25, Spring Boot 3.3.0 | |
| 21 | | **Frontend** | HTML5, CSS3, JavaScript Vanilla | |
| 22 | | **BD** | MySQL 8.0 (22 entidades, 3FN) | |
| 23 | |
| 24 | ## 🚀 Quick Start |
| 25 | |
| 26 | ### Backend |
| 27 | ```bash |
| 28 | # Crear bases de datos |
| 29 | CREATE DATABASE maps_conect; |
| 30 | CREATE DATABASE maps_conect_dev; |
| 31 | |
| 32 | # Editar: src/main/resources/application.yml |
| 33 | # (actualizar credenciales MySQL) |
| 34 | |
| 35 | # Ejecutar |
| 36 | mvn spring-boot:run -Dspring-boot.run.arguments="--spring.profiles.active=dev" |
| 37 | # API en: http://localhost:8080/api |
| 38 | ``` |
| 39 | |
| 40 | ### Frontend |
| 41 | ```bash |
| 42 | # Abrir en Visual Studio Code |
| 43 | code frontend/ |
| 44 | |
| 45 | # Live Server (extensión VS Code) |
| 46 | # Clic derecho en index.html > "Open with Live Server" |
| 47 | # En: http://localhost:5500 |
| 48 | ``` |
| 49 | |
| 50 | ## 📋 Requisitos |
| 51 | |
| 52 | - Java 25+ |
| 53 | - Maven 3.8+ |
| 54 | - MySQL 8.0+ |
| 55 | - Node.js (opcional, para frontend) |
| 56 | |
| 57 | ## 🔐 Autenticación |
| 58 | |
| 59 | - **JWT Tokens** (24 horas) |
| 60 | - Email institucional: `@tecmilenio.mx` |
| 61 | - Contraseña segura: 8+ caracteres, mayúscula, número |
| 62 | |
| 63 | ## 📂 Estructura |
| 64 | |
| 65 | ``` |
| 66 | maps-conect/ |
| 67 | ├── src/main/java/... # Backend Java/Spring |
| 68 | ├── frontend/ # Frontend HTML/CSS/JS |
| 69 | │ ├── index.html |
| 70 | │ ├── css/ |
| 71 | │ ├── js/ |
| 72 | │ └── pages/ |
| 73 | └── pom.xml |
| 74 | ``` |
| 75 | |
| 76 | ## 📚 Módulos |
| 77 | |
| 78 | | Módulo | Descripción | |
| 79 | |--------|------------| |
| 80 | | 1️⃣ Gestión MAPS | Carreras, certificados, materias | |
| 81 | | 2️⃣ Usuarios | Login, perfiles, roles | |
| 82 | | 3️⃣ Foro | Dudas y respuestas académicas | |
| 83 | | 4️⃣ Tips | Consejos de estudio con votación | |
| 84 | | 5️⃣ Recursos | Apuntes y material de estudio | |
| 85 | | 6️⃣ Mensajes | Chat 1 a 1 estudiante-profesor | |
| 86 | | 7️⃣ Empresarial | Reseñas y experiencias vinculación | |
| 87 | | 8️⃣ Círculos | Grupos de estudio colaborativos | |
| 88 | |
| 89 | ## 🔗 Enlaces |
| 90 | |
| 91 | - 📖 Backend: `http://localhost:8080/api` |
| 92 | - 🌐 Frontend: `http://localhost:5500` |
| 93 | - ✅ Health: `http://localhost:8080/api/health` |
| 94 | |
| 95 | ## 👨💻 Contacto |
| 96 | |
| 97 | **Universidad Tecmilenio** - Proyecto MAPS Connect |
| 98 | [GitHub Repository](https://github.com/danielsilva7577-bit/maps-conect) |
| 99 | |
| 100 | --- |
| 101 | |
| 102 | **v1.0.0** | Agosto 2024 | En Desarrollo |