Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/keving5726/megacreative/llms.txt

Use this file to discover all available pages before exploring further.

Mega Creative follows the standard Laravel 6 directory structure. This page maps the key directories and files you will work with when extending or maintaining the application. Whether you are adding a new model, modifying a view, or adjusting route definitions, knowing where things live will save you significant time.

Top-Level Directories

DirectoryPurpose
app/PHP application code — models, controllers, middleware, and service providers
bootstrap/Framework bootstrap file and the compiled class and service-provider cache
config/All configuration files: app.php, database.php, auth.php, mail.php, and more
database/Migrations, model factories, and database seeders
public/The web root served by your HTTP server; contains compiled CSS/JS assets, favicon.ico, and index.php
resources/Blade view templates, raw SASS source files, and JavaScript source
routes/All route definition files: web.php, api.php, console.php, and channels.php
storage/Framework-generated files: logs, compiled Blade templates, file-based sessions, and cache. Must be writable by the web server
tests/PHPUnit feature and unit test files
The storage/ and bootstrap/cache/ directories must be writable by your web server process. Run chmod -R 775 storage bootstrap/cache if you encounter permission errors during setup.

Key Files

routes/web.php

Registers the home route and the two resource route groups for estudiantes and carreras. Every HTTP entry point for the application is defined here.

app/Http/Controllers/EstudianteController.php

Implements all seven resourceful CRUD actions for student records. Handles validation, model persistence, and view rendering for the /estudiantes URL space.

app/Http/Controllers/CarreraController.php

Implements all seven resourceful CRUD actions for academic programs (carreras). Handles validation, model persistence, and view rendering for the /carreras URL space.

resources/views/layouts/app.blade.php

The single master Blade layout that every page extends. Pulls in the head, header, and footer partials and defines the @yield('title') and @yield('content') slots.

database/seeds/DatabaseSeeder.php

The root seeder that orchestrates all other seeders. Run via php artisan db:seed to populate lookup tables (sexos, statuses, paises, estados, ciudades) with reference data.

.env

Local environment configuration — database credentials, app URL, mail driver, and more. Never commit this file. Copy .env.example to get started.

webpack.mix.js

Laravel Mix configuration that compiles resources/sass/app.scsspublic/css/app.css and bundles resources/js/app.jspublic/js/app.js.

composer.json

PHP dependency manifest. Requires PHP ^7.2, laravel/framework ^6.0, laravel/tinker ^1.0, and the fideloper/proxy package.

Application Models

All seven Eloquent models live directly inside app/ and belong to the App\ namespace. The Estudiante model is the central entity — all other models either describe a student attribute or serve as a lookup table.
ModelFileRole
Estudianteapp/Estudiante.phpCentral student entity; holds relationships to all other models
Carreraapp/Carrera.phpAcademic program (degree/major); has a status
Sexoapp/Sexo.phpGender lookup table
Statusapp/Status.phpActive/inactive status; used by both Estudiante and Carrera
Paisapp/Pais.phpCountry lookup table
Estadoapp/Estado.phpState/province lookup table
Ciudadapp/Ciudad.phpCity lookup table

Artisan Commands

Use these Artisan and npm commands during day-to-day development.

Database

CommandDescription
php artisan migrateRun all pending database migrations
php artisan db:seedExecute the DatabaseSeeder to populate reference data
php artisan migrate:fresh --seedDrop all tables, re-run migrations, then seed — useful for a clean reset

Development Server

CommandDescription
php artisan serveStart the built-in PHP development server at http://127.0.0.1:8000
php artisan tinkerLaunch a REPL pre-loaded with the application context for interactive testing

Asset Compilation

CommandDescription
npm run devCompile SASS and JavaScript once (unminified, with source maps)
npm run watchCompile assets and watch for file changes, recompiling automatically
npm run prodCompile and minify assets for production deployment
Run php artisan migrate:fresh --seed whenever you pull in schema changes from a team member. It guarantees your local database matches the latest migration history and is fully seeded.

Build docs developers (and LLMs) love