feat: Initialize monorepo structure and comprehensive documentation

This commit establishes the new monorepo architecture for the KROW Workforce platform.

Key changes include:
- Reorganized project into `frontend-web`, `mobile-apps`, `firebase`, `scripts`, and `secrets` directories.
- Updated `Makefile` to support the new monorepo layout and automate Base44 export integration.
- Fixed `scripts/prepare-export.js` for ES module compatibility and global component import resolution.
- Created and updated `CONTRIBUTING.md` for developer onboarding.
- Restructured, renamed, and translated all `docs/` files for clarity and consistency.
- Implemented an interactive internal launchpad with diagram viewing capabilities.
- Configured base Firebase project files (`firebase.json`, security rules).
- Updated `README.md` to reflect the new project structure and documentation overview.
This commit is contained in:
bwnyasse
2025-11-12 12:50:55 -05:00
parent 92fd0118be
commit 554dc9f9e3
203 changed files with 1414 additions and 732 deletions

View File

@@ -11,34 +11,34 @@
# Installs all project dependencies using npm.
install:
@echo "--> Installing project dependencies..."
@npm install
@echo "--> Installing web frontend dependencies..."
@cd frontend-web && npm install
# Starts the local development server.
dev:
@echo "--> Starting development server on http://localhost:5173 ..."
@npm run dev
@echo "--> Starting web frontend development server on http://localhost:5173 ..."
@cd frontend-web && npm run dev
# Builds the application for production.
build:
@echo "--> Building application for production..."
@npm run build
@echo "--> Building web frontend for production..."
@cd frontend-web && npm run build
# Integrates a new Base44 export into the current project.
# It replaces the src directory and the index.html file.
# Prerequisite: The new export must be in a folder named '../krow-workforce-web-export-latest'.
# It replaces the src directory and the index.html file in the frontend-web directory.
# Prerequisite: The new export must be in a folder named '../krow-workforce-export-latest'.
integrate-export:
@echo "--> Integrating new Base44 export..."
@if [ ! -d "../krow-workforce-web-export-latest" ]; then \
echo "❌ Error: Export directory '../krow-workforce-web-export-latest' not found."; \
@echo "--> Integrating new Base44 export into frontend-web/..."
@if [ ! -d "../krow-workforce-export-latest" ]; then \
echo "❌ Error: Export directory '../krow-workforce-export-latest' not found."; \
exit 1; \
fi
@echo " - Removing old src directory..."
@rm -rf src
@rm -rf frontend-web/src
@echo " - Copying new src directory..."
@cp -R ../krow-workforce-web-export-latest/src ./src
@cp -R ../krow-workforce-export-latest/src ./frontend-web/src
@echo " - Copying new index.html..."
@cp ../krow-workforce-web-export-latest/index.html ./index.html
@cp ../krow-workforce-export-latest/index.html ./frontend-web/index.html
@echo "--> Integration complete. Next step: 'make prepare-export'."
# Applies all necessary patches to a fresh Base44 export to run it locally.
@@ -53,10 +53,10 @@ help:
@echo "--------------------------------------------------"
@echo " KROW Workforce - Available Makefile Commands"
@echo "--------------------------------------------------"
@echo " make install - Installs project dependencies."
@echo " make dev - Starts the local development server."
@echo " make build - Builds the application for production."
@echo " make integrate-export - Integrates a new Base44 export from '../krow-workforce-web-export-latest'."
@echo " make install - Installs web frontend dependencies."
@echo " make dev - Starts the local web frontend server."
@echo " make build - Builds the web frontend for production."
@echo " make integrate-export - Integrates a new Base44 export from '../krow-workforce-export-latest'."
@echo " make prepare-export - Prepares a fresh Base44 export for local use."
@echo " make help - Shows this help message."
@echo "--------------------------------------------------"