Admin Loading Issues Fix Pt.2

.env.example

@@ -113,3 +113,17 @@ YOUTUBE_API_KEY=""
 ###> jwk base url ###
 JWK_BASE_URL="https://canvas.instructure.com/"
 ###> jwk base url ###
+
+############# Admin Panel Data Retrieval Params:
+
+###> admin panel retrieval task lms url ###
+ADMIN_RETRIEVAL_LMS_DOMAIN="domain"
+###> admin panel retrieval task lms url ###
+
+###> admin panel retrieval task lms token ###
+ADMIN_RETRIEVAL_API_TOKEN="token"
+###> admin panel retrieval task lms token ###
+
+###> admin panel retrieval task institution id ###
+ADMIN_PANEL_INSTITUTION_ID=1
+###> admin panel retrieval task institution id ###

.gitignore

@@ -9,6 +9,10 @@
 !/assets/js/Components/Icons/
 ###< symfony/framework-bundle ###
 
+###> php linter cache ###
+.php-cs-fixer.*
+###> php linter cache ###
+
 ###> symfony/phpunit-bridge ###
 .phpunit
 .phpunit.result.cache

Makefile

@@ -4,35 +4,107 @@ ifneq (,$(wildcard ./.ins.env))
     export
 endif
 
-# spin up the containers
-start:
-	docker compose -f docker-compose.nginx.yml up
+# ──────────────────────────────────────────────
+# Variables
+# ──────────────────────────────────────────────
 
+COMPOSE := docker compose -f docker-compose.nginx.yml
 
-create-migrations:
-	make clean-cache
-	docker compose -f docker-compose.nginx.yml run php php bin/console doctrine:migrations:diff
+# ──────────────────────────────────────────────
+# Container Management
+# ──────────────────────────────────────────────
 
-# set up the database
-migrate:
-	docker compose -f docker-compose.nginx.yml run php php bin/console doctrine:migrations:migrate
+## Spin up the containers
+start:
+	$(COMPOSE) up
 
-# Down the containers
+## Bring down the containers
 down:
-	docker compose -f docker-compose.nginx.yml down
+	$(COMPOSE) down
 
-# rebuild the containers from the ground up
+## Rebuild the containers from the ground up
 build:
-	docker compose -f docker-compose.nginx.yml up --build
+	$(COMPOSE) up --build
+
+# ──────────────────────────────────────────────
+# Database / Migrations
+# ──────────────────────────────────────────────
+
+## Generate a migration by diffing the current schema
+create-migrations: clean-cache
+	$(COMPOSE) run --rm php php bin/console doctrine:migrations:diff
 
-# clear the Symfony cache
+## Validate the mapping files against the schema
+validate: clean-cache
+	$(COMPOSE) run --rm php php bin/console doctrine:schema:validate
+
+## Dump the SQL needed to update the schema
+dump-sql: clean-cache
+	$(COMPOSE) run --rm php php bin/console doctrine:schema:update --dump-sql
+
+## Run migrations
+## usage: `make migrate` to run all pending, or `make migrate VERSION=20260311150018` for a single migration
+migrate:
+ifdef VERSION
+	$(COMPOSE) run --rm php php bin/console doctrine:migrations:execute --up 'DoctrineMigrations\Version$(VERSION)'
+else
+	$(COMPOSE) run --rm php php bin/console doctrine:migrations:migrate
+endif
+
+# Show migrations 
+# usage: `make migration-list` to show all migrations
+migration-list:
+	$(COMPOSE) run --rm php php bin/console doctrine:migrations:list
+
+## Run all pending migrations up to and including a specific version
+## usage: `make migrate-to VERSION=20260311150018`
+migrate-to:
+	$(COMPOSE) run --rm php php bin/console doctrine:migrations:migrate 'DoctrineMigrations\Version$(VERSION)'
+
+## Revert the changes of a single migration
+## usage: `make migrate-down VERSION=20260311150018`
+migrate-down:
+	$(COMPOSE) run --rm php php bin/console doctrine:migrations:execute 'DoctrineMigrations\Version$(VERSION)' --down
+
+# ──────────────────────────────────────────────
+# Utilities
+# ──────────────────────────────────────────────
+
+## Clear the Symfony cache
 clean-cache:
-	docker compose -f docker-compose.nginx.yml run php bin/console cache:clear
+	$(COMPOSE) run --rm php bin/console cache:clear
+	rm -rf ./var/cache/prod/
+
+.PHONY: admin-panel-retrieve-data
+
+VALID_TABLES := accounts terms courses
+
+admin-panel-retrieve-data: clean-cache
+	@if [ -n "$(TABLES)" ] && [ -z "$(filter $(TABLES),$(VALID_TABLES))" ]; then \
+		echo "Error: Invalid table(s): '$(TABLES)'"; \
+		echo "Usage: make admin-panel-retrieve-data TABLES=\"accounts terms courses\""; \
+		echo "Valid tables: $(VALID_TABLES)"; \
+		exit 1; \
+	fi
+	$(COMPOSE) run --rm php php bin/console app:admin-panel-retrieval $(foreach table,$(TABLES),--tables=$(table))
+# ──────────────────────────────────────────────
+# Institution Seeding
+# ──────────────────────────────────────────────
 
-# fill your institutions table data with the variables in your ins.env file. Use this command if you are using mysql.
+## Insert institution row (MySQL)
+## Reads variables from .ins.env
 ins-mysql:
-	docker exec -it udoit3-db mysql -u root -proot udoit3 -e "INSERT INTO institution (title, lms_domain, lms_id, lms_account_id, created, status, vanity_url, metadata, api_client_id, api_client_secret) VALUES ('$(TITLE)', '$(LMS_DOMAIN)', '$(LMS_ID)', '$(LMS_ACCOUNT_ID)', '$(CREATED)', '$(STATUS)', '$(VANITY_URL)', '$(METADATA)', '$(API_CLIENT_ID)', '$(API_CLIENT_SECRET)');"
+	docker exec -it udoit3-db mysql -u root -proot udoit3 \
+		-e "INSERT INTO institution \
+			(title, lms_domain, lms_id, lms_account_id, created, status, vanity_url, metadata, api_client_id, api_client_secret) \
+			VALUES \
+			('$(TITLE)', '$(LMS_DOMAIN)', '$(LMS_ID)', '$(LMS_ACCOUNT_ID)', '$(CREATED)', '$(STATUS)', '$(VANITY_URL)', '$(METADATA)', '$(API_CLIENT_ID)', '$(API_CLIENT_SECRET)');"
 
-# fill your institutions table data with the variables in your institutions.env file. Use this command if you are using postgresql.
+## Insert institution row (PostgreSQL)
+## Reads variables from .ins.env
 ins-psql:
-	docker exec -it -e PGPASSWORD=root udoit3-db psql -U root -d udoit3 -w -c "INSERT INTO institution (title, lms_domain, lms_id, lms_account_id, created, status, vanity_url, metadata, api_client_id, api_client_secret) VALUES ('$(TITLE)', '$(LMS_DOMAIN)', '$(LMS_ID)', '$(LMS_ACCOUNT_ID)', '$(CREATED)', '$(STATUS)', '$(VANITY_URL)', '$(API_CLIENT_ID)', '$(API_CLIENT_SECRET)');"
+	docker exec -it -e PGPASSWORD=root udoit3-db psql -U root -d udoit3 -w \
+		-c "INSERT INTO institution \
+			(title, lms_domain, lms_id, lms_account_id, created, status, vanity_url, metadata, api_client_id, api_client_secret) \
+			VALUES \
+			('$(TITLE)', '$(LMS_DOMAIN)', '$(LMS_ID)', '$(LMS_ACCOUNT_ID)', '$(CREATED)', '$(STATUS)', '$(VANITY_URL)', '$(API_CLIENT_ID)', '$(API_CLIENT_SECRET)');"