A comprehensive web platform designed for the Nizhny Tagil State Social Pedagogical Institute (NTSPI). This system serves as a full-featured replacement for the legacy website, providing tools for content management, educational program administration, admission campaigns, and institutional structure management.

🚀 Tech Stack

Frontend

Framework: Vue.js 3 (Composition API)
Adapter: Inertia.js (Monolith structure with SPA feel)
Styling: Tailwind CSS
Build Tool: Vite

Backend

Core: PHP 8.2 / Laravel
Admin Panel: Filament PHP (CMS & Resource Management)
Database: MySQL 8.0
Caching & Queues: Redis
Server: Nginx + PHP-FPM

Infrastructure

Containerization: Docker & Docker Compose
SSL: Certbot (Let's Encrypt)

🏗 Architecture

The backend follows the Porto Architecture Pattern, organizing code into logical modular units to ensure scalability and maintainability.

Ship Layer: Low-level code, parent classes, and configuration.
Containers Layer: Encapsulates business logic into modular containers (e.g., AdditionalEducation, Article, Event, User, Schedule, etc.).
Request Lifecycle: Route -> Controller -> Action -> Task -> UI.

✨ Key Features

Content Management (CMS): Advanced management of News, Articles, and Events with media galleries and status workflows (Draft, Published, Archived).
Institute Structure: Hierarchical management of Faculties, Departments (Kafedras), Divisions, and Staff profiles.
Educational Programs: Catalog of study programs, admission plans, and entrance exam requirements.
Admissions Management: Tools to manage "Admission Campaigns" (Priemnaya Kampaniya), enabling dynamic updates to student intake numbers and rules.
Role-Based Access Control (RBAC): Powered by Filament Shield. Granular permissions allowing different departments (Deans, Press Service, HR) to manage their specific sections independently.
Dynamic Routing: Custom pages and navigation structures managed directly via the Database.
Cross-Model Search: Unified global search across News, Pages, Events, and Programs using standard Eloquent models.

🛠 Installation & Local Development

The project includes a Docker environment for easy deployment.

1. Clone the Repository

git clone https://github.com/F4ilji/ntspi-app.git
cd ntspi-app

2. Configure Environment

Create the environment file from the example.

cp example.env .env

3. Create Directories & Set Permissions

Ensure Laravel storage directories exist and have write permissions.

mkdir -p storage/{app,logs,framework/{cache,sessions,views}}
sudo chown -R www-data:www-data storage
sudo chmod -R 775 storage

4. Start Docker Containers

Launch Nginx, MySQL, Redis, and the App container.

docker compose up --build -d

5. Install Dependencies

Enter the PHP container to run setup commands:

docker exec -it ntspi-php bash

Inside the container, run:

# Backend dependencies
composer install

# Database migrations
php artisan migrate

# Frontend dependencies
npm i

# Build assets
npm run build

6. Initialize System Data

Set up user roles and seed the database with initial data.

# Initialize permissions/roles (Critical for Filament Shield)
php artisan roles:init-roles

# Seed dummy data (Optional)
php artisan db:seed

📂 Project Structure Overview

_docker/: Docker configuration files (Nginx, PHP, MySQL).
app/Containers/: Business logic modules (Porto pattern).
resources/js/: Vue.js components, Pages, and shared UI assets.
routes/: Web and API routes (including dynamic DB-based routing logic).