create-fullstack-boilerplate 1.0.0

package/template/Backend/package.json

@@ -0,0 +1,32 @@
+{
+    "name": "report_consolidation_backend",
+    "version": "1.0.0",
+    "description": "Backend For Reort Consolidation Platform for PMD",
+    "main": "server.js",
+    "scripts": {
+        "start": "node server.js",
+        "dev": "nodemon server.js"
+    },
+    "dependencies": {
+        "axios": "^1.12.2",
+        "axios-cookiejar-support": "^6.0.4",
+        "bcryptjs": "^2.4.3",
+        "cheerio": "^1.1.2",
+        "colors": "^1.4.0",
+        "cors": "^2.8.5",
+        "crypto-js": "^4.2.0",
+        "dotenv": "^16.3.1",
+        "express": "^4.18.2",
+        "form-data": "^4.0.4",
+        "jsonwebtoken": "^9.0.2",
+        "mysql2": "^3.15.2",
+        "node-fetch": "^3.3.2",
+        "sequelize": "^6.37.7",
+        "sequelize-cli": "^6.6.3",
+        "tough-cookie": "^6.0.0",
+        "xml2js": "^0.6.2"
+    },
+    "devDependencies": {
+        "nodemon": "^3.0.1"
+    }
+}

package/template/Backend/routes/authRoutes.js

@@ -0,0 +1,15 @@
+const express = require('express');
+const router = express.Router();
+const authService = require('../services/authService');
+const { authenticateToken } = require('../middleware/authMiddleware')
+
+// Login
+router.post('/login', authService.login);
+
+// Get current user
+router.get('/me', authenticateToken, authService.getCurrentUser);
+
+// Logout
+router.post('/logout', authenticateToken, authService.logout);
+
+module.exports = router;

package/template/Backend/routes/dashboardRoutes.js

@@ -0,0 +1,13 @@
+const express = require('express');
+const router = express.Router();
+const dashboardService = require('../services/dashboardService');
+
+// Main route to get all network information
+router.get('/getDashboardHealth', dashboardService.getDashboardRoutesHealth);
+
+// Get only user details
+router.post('/getDashboardInformation', dashboardService.getDashInfo);
+
+// Implement Your Own Endpoints Here
+
+module.exports = router;

package/template/Backend/routes/index.js

@@ -0,0 +1,15 @@
+const express = require('express');
+const router = express.Router();
+
+const { authenticateToken } = require('../middleware/authMiddleware')
+
+const authRoutes = require('./authRoutes');
+const dashboardRoutes = require('./dashboardRoutes');
+const settingsRoutes = require('./settingsRoutes');
+
+// Mount feature routers
+router.use('/auth', authRoutes);
+router.use('/dashboard', authenticateToken, dashboardRoutes);
+router.use('/settings', authenticateToken, settingsRoutes);
+
+module.exports = router;

package/template/Backend/routes/settingsRoutes.js

@@ -0,0 +1,9 @@
+const express = require('express');
+const router = express.Router();
+const settingsService = require('../services/settingsService');
+const {authenticateToken} = require('../middleware/authMiddleware')
+
+router.get('/getSettingsHealth', authenticateToken, settingsService.getSettingsRoutesHealth);
+router.post('/saveProfileDetails',authenticateToken, settingsService.getSettingsInfo);
+
+module.exports = router;

package/template/Backend/server.js

@@ -0,0 +1,70 @@
+require('colors');
+require('dotenv').config();
+const express = require('express');
+const cors = require('cors');
+const databases = require('./Models'); // all DBs exported from Models/index.js
+const { initializeDatabaseConnection } = require('./DB/DBInit');
+
+const mainRouter = require('./routes/index');
+
+const app = express();
+const PORT = process.env.PORT || 3000;
+
+// Middleware
+app.use(cors({
+    origin: process.env.CLIENT_URL,
+    credentials: true
+}));
+app.use(express.json());
+
+// Health check
+app.get('/api/health', (req, res) => {
+    res.json({ status: 'ok', message: 'Server is running' });
+});
+
+// Use all routers
+app.use('/api', mainRouter);
+
+// Error handling middleware
+app.use((err, req, res, next) => {
+    console.error(err.stack);
+    res.status(500).json({ message: 'Something went wrong!' });
+});
+
+const startServer = async () => {
+    console.log("\n[+] ========== Starting Server & Initializing DBs ========== \n");
+
+    // Initialize all databases exported from Models
+    const dbKeys = Object.keys(databases || {});
+    for (const key of dbKeys) {
+        try {
+            const db = databases[key];
+            if (!db || !db.sequelize) {
+                console.log(`[!] - Skipping ${key}: no sequelize instance found.`.yellow);
+                continue;
+            }
+
+            console.log(`[~] Initializing ${key}...`.cyan);
+            await initializeDatabaseConnection(db.sequelize, key);
+            console.log(`[✅] ${key} initialized successfully.`.green);
+        } catch (err) {
+            // initializeDatabaseConnection may throw after its retries — log and continue
+            console.error(`[❌] Failed to initialize ${key}:`.red, err.message || err);
+            console.error(err);
+        }
+    }
+
+    // Start server regardless of DB init status
+    app.listen(PORT, () => {
+        console.log(`\n🚀 Server is running on port ${PORT}`.bold);
+        console.log("\n[+] ========== Server started (DB initialization attempted) ========== \n");
+    });
+};
+
+startServer().catch(err => {
+    console.error("[!] Unhandled error in startServer:".red, err);
+    // Still attempt to start the server in case DB init threw unexpectedly
+    app.listen(PORT, () => {
+        console.log(`\n🚀 Server is running on port ${PORT} (after uncaught init error)`.bold);
+    });
+});

package/template/Backend/services/authService.js

@@ -0,0 +1,68 @@
+const bcrypt = require('bcryptjs');
+const jwt = require('jsonwebtoken');
+const { decrypt } = require('./cryptoService')
+
+const JWT_SECRET = process.env.JWT_SECRET;
+
+// Mock user database
+const users = [
+    {
+        id: '1',
+        email: 'admin@npmjs.com',
+        password: '$2a$10$yFJXKioLIdFeUhsbat75..AEiEmyQhwM5Enj/9P3AXY5ReVC.lu1C'
+        // email: 'dev@pmdpk.com',
+        // password: '$2a$10$q62ZJw20xdKWvqtV7pFpbevPBysE9TvrLJX2WocDH.Clpk.43X.Ue', // 'pmd@786'
+    },
+    {
+        id: '2',
+        email: 'networks@pmdpk.com',
+        password: '$2a$10$kObr3k/8AeIOEwdcM79K0utCi0WKMBoqx4ewuFkb9UKznoAZ1dHi6', // 'pmd@123'
+    }
+];
+
+exports.login = async (req, res) => {
+    try {
+        const { email, password } = req.body;
+
+        if (!email || !password) {
+            return res.status(400).json({ message: 'Email and password are required' });
+        }
+
+        const user = users.find(u => u.email.toLowerCase() === email.toLowerCase());
+        if (!user) {
+            return res.status(401).json({ message: 'Invalid email or password' });
+        }
+
+        const isValidPassword = await bcrypt.compare(decrypt(password), user.password);
+        if (!isValidPassword) {
+            return res.status(401).json({ message: 'Invalid email or password' });
+        }
+
+        const token = jwt.sign(
+            { id: user.id, email: user.email },
+            JWT_SECRET,
+            { expiresIn: '24h' }
+        );
+
+        res.json({
+            message: 'Login successful',
+            token,
+            user: { id: user.id, email: user.email }
+        });
+    } catch (error) {
+        console.error('Login error:', error);
+        res.status(500).json({ message: 'Internal server error' });
+    }
+};
+
+exports.getCurrentUser = (req, res) => {
+    const user = users.find(u => u.id === req.user.id);
+    if (!user) {
+        return res.status(404).json({ message: 'User not found' });
+    }
+    res.json({ user: { id: user.id, email: user.email } });
+};
+
+exports.logout = (req, res) => {
+    res.json({ message: 'Logout successful' });
+};

package/template/Backend/services/cryptoService.js

@@ -0,0 +1,14 @@
+const CryptoJS = require('crypto-js');
+
+const AES_KEY = process.env.PASSWORD_ENCRYPTION_KEY;
+
+if (!AES_KEY) {
+  console.warn('PASSWORD_ENCRYPTION_KEY not set in env. Decryption will fail.');
+}
+
+exports.decrypt = (encryptedString) => {
+  if (!AES_KEY) throw new Error('Server encryption key is not configured');
+  const bytes = CryptoJS.AES.decrypt(encryptedString, AES_KEY);
+  const decrypted = bytes.toString(CryptoJS.enc.Utf8);
+  return decrypted;
+};

package/template/Backend/services/dashboardService.js

@@ -0,0 +1,39 @@
+exports.getDashboardRoutesHealth = async (req, res) => {
+    const dashboardInfo = [
+        {
+            title: "Frontend Structure (React + Vite)",
+            items: [
+                "src/pages → Application Screens & Views",
+                "src/components → Reusable UI Components",
+                "src/contexts → Auth & Theme Providers",
+                "src/config → Axios Clients & Env Configurations"
+            ],
+            icon: "💻"
+        },
+        {
+            title: "Backend Structure (Node.js + Express + Sequelize)",
+            items: [
+                "routes/ → Define API Endpoints",
+                "services/ → Business Logic Layer",
+                "Models/ → Database Models & Associations",
+                "DB/ → DB Connection Settings"
+            ],
+            icon: "🛠️"
+        },
+        {
+            title: "Authentication",
+            items: [
+                "All /dashboard routes are protected by JWT.",
+                "Use Authorization: Bearer <token>"
+            ],
+            icon: "🔐"
+        },
+    ];
+
+    return res.status(200).json(dashboardInfo);
+};
+
+
+exports.getDashInfo = async (req, res) => {
+    res.status(200).send("Dashboard Information Endpoint")
+}

package/template/Backend/services/settingsService.js

@@ -0,0 +1,43 @@
+exports.getSettingsRoutesHealth = async (req, res) => {
+    const settingsInfo = [
+        {
+            title: "Purpose of Settings Module",
+            icon: "⚙️",
+            items: [
+                "This area handles user preferences & personalization.",
+                "Used to manage account, profile, and application behavior."
+            ],
+        },
+        {
+            title: "Where to Add New Settings Logic",
+            icon: "🧩",
+            items: [
+                "Backend/routes/settingsRoutes.js → Define new API endpoints.",
+                "Backend/services/settingsService.js → Add business logic functions.",
+            ],
+        },
+        {
+            title: "Frontend Integration",
+            icon: "🎨",
+            items: [
+                "Use axiosSettingsClient for all requests.",
+                "Component path: Frontend/src/pages/Settings.jsx",
+            ],
+        },
+        {
+            title: "Security",
+            icon: "🔐",
+            items: [
+                "All /settings routes are protected using JWT middleware.",
+            ],
+        },
+    ];
+
+    return res.status(200).json(settingsInfo);
+};
+
+
+
+exports.getSettingsInfo = async (req, res) => {
+    res.status(200).send("Settings Information Endpoint")
+}

package/template/Frontend/.env

@@ -0,0 +1,3 @@
+VITE_API_BASE_URL=http://localhost:5000/api
+
+VITE_PASSWORD_ENCRYPTION_KEY=A35_5YM37R1C_3NCRYP710N_K3Y_PMD