Class Path is a Laravel-based web application designed to manage schools, class groups and subjects. This project simplifies school schedule administration by allowing an admin user to manage it.
Whether you're a developer exploring Laravel or an educational institution seeking streamlined management solutions, Class Path is here to provide a clear, scalable, and reliable foundation.
- Users can Log in and Sign up in the system.
- Each user is tied to a specific school via the
school_id
attribute.
- Schools are the core entities in Class Path, connecting users for easy tracking and management.
- Each user is assigned to one school, ensuring organized data relations.
- Built with Laravel, Class Path leverages Eloquent ORM for intuitive database management.
- Uses migrations, seeders, and models to ensure robust and scalable development.
- PHP >= 8.0
- Composer
- Laravel >= 10.x
- Database (e.g., MySQL, PostgreSQL, SQLite)
-
Clone the repository:
git clone https://github.com/freddysae0/school-calendar-tool.git cd class-path
-
Install dependencies:
composer install
-
Set up environment variables:
- Copy
.env.example
to.env
:cp .env.example .env
- Configure your database and other settings in the
.env
file.
- Copy
-
Generate the application key:
php artisan key:generate
-
Run migrations and seed the database (if needed):
php artisan migrate --seed
-
Start the development server:
php artisan serve
Visit
http://127.0.0.1:8000
to access Class Path.
Key directories in the Class Path project:
app/Models
: Contains theUser
,School
and other models with their relationships.database/migrations
: Houses database migration files for managing tables.routes/web.php
: Defines the application's web routes.resources/views
: Contains the front-end templates for the application.
- User-School Association: Each user has a
school_id
, representing a one-to-many relationship. - Validation: Requests are validated to ensure data integrity.
- Scalability: The architecture is designed to accommodate additional features like roles, permissions, and school data analytics.
- School Dashboard: Insights and analytics for schools.
Contributions are welcome! Feel free to:
- Submit pull requests.
- Open issues for bugs or feature suggestions.
- Fork the repository.
- Create a feature branch:
git checkout -b feature-name
- Commit your changes and push them:
git push origin feature-name
- Submit a pull request.
Class Path is open-source and licensed under the MIT License.
Have questions or feedback? Contact us at [email protected] or visit our GitHub page.
Start building your educational management system with Class Path today! 🎓