Sistema Notas Colegio San

---

📋 Descripción

Sistema Notas Colegio San es una plataforma web desarrollada en Laravel que automatiza la gestión académica y administrativa de un colegio. Permite el registro de estudiantes, manejo de notas, generación de reportes, control de matrícula y pensión, gestión de documentos y mucho más.

Toda la documentación detallada, incluyendo diagramas, flujos y especificaciones de cada módulo, está disponible en DeepWiki:

👉 Documentación completa en DeepWiki

---

📑 Table of Contents

1. Características Principales
2. Requisitos
3. Instalación
4. Configuración
5. Uso
6. Estructura del Proyecto
7. Tecnologías
8. Contribuciones
9. Licencia

---

🚀 Características Principales

• Gestión de usuarios y control de acceso por roles (Admin, Profesor, Padre de familia).
• Registro y edición de datos de estudiantes.
• Sistema de calificaciones por periodos académicos.
• Generación de certificados y reportes en PDF.
• Gestión de documentos adjuntos (registros civiles, boletas, fotos, etc.).
• Automatización de tareas con Laravel Scheduler.
• Panel administrativo con métricas y dashboards.
• Integración con correo para notificaciones.

---

🛠 Requisitos

• PHP >= 8.1
• Composer
• MySQL o PostgreSQL
• Node.js y npm (para assets)
• Extensiones de PHP: OpenSSL, PDO, Mbstring, Tokenizer, XML, Ctype, JSON

---

💡 Instalación

1. Clona el repositorio:

   git clone https://github.com/brayan3210/Sistema-Notas-Colegiooo.git
   cd Sistema-Notas-Colegiooo

2. Instala dependencias de PHP:

   composer install

3. Instala dependencias de frontend:

   npm install
   npm run dev

4. Copia el archivo de entorno y genera la clave de aplicación:

   cp .env.example .env
   php artisan key:generate

5. Configura variables de entorno en .env (base de datos, correo, almacenamiento).

6. Ejecuta migraciones y seeders:

   php artisan migrate --seed

7. Inicia el servidor local:

   php artisan serve

---

⚙️ Configuración

Revisa la documentación en DeepWiki para configurar roles, permisos, rutas de almacenamiento y comandos programados:

• Configuración Básica
• Middleware de Acceso
• Scheduler y Jobs

---

🎓 Uso

• Admin: Gestiona usuarios, revisa reportes y configura el sistema.
• Profesor: Registra y edita notas, genera certificados de sus estudiantes.
• Padre de familia: Consulta calificaciones y documentos de sus hijos.

Para flujos de uso detallados, consulta:

• Proceso de Matrícula
• Gestión de Notas

---

📂 Estructura del Proyecto

app/
├── Http/
│   ├── Controllers/
│   └── Middleware/
├── Models/
└── Console/

resources/
├── views/
└── sass/

routes/
├── web.php
└── api.php

database/
├── migrations/
└── seeders/

---

🛠 Tecnologías

• Framework: Laravel
• Lenguaje: PHP 8.x
• Base de datos: MySQL/PostgreSQL
• Frontend: Blade, Tailwind CSS, Alpine.js
• Testing: PHPUnit
• CI/CD: GitHub Actions

---

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Por favor, revisa las pautas en DeepWiki:

👉 Guía de Contribución

---

📄 Licencia

Este proyecto está bajo la licencia MIT. Consulta LICENSE para más detalles.