create-nodemin-app 1.0.16

package/templates/HRMS_Mongodb/frontend/src/pages/Positions.jsx

@@ -0,0 +1,157 @@
+import { useEffect, useState } from 'react';
+import toast from 'react-hot-toast';
+import api from '../api/axios';
+import Button from '../components/ui/Button';
+import Input from '../components/ui/Input';
+import Modal, { ModalFooter } from '../components/ui/Modal';
+import { validatePosition } from '../utils/validation';
+
+export default function Positions() {
+  const [positions, setPositions] = useState([]);
+  const [modalOpen, setModalOpen] = useState(false);
+  const [editing, setEditing] = useState(null);
+  const [form, setForm] = useState({ posName: '', requiredQualification: '' });
+  const [errors, setErrors] = useState({});
+  const [loading, setLoading] = useState(false);
+
+  const load = async () => {
+    try {
+      const { data } = await api.get('/positions');
+      setPositions(data.data);
+    } catch {
+      toast.error('Failed to load structural positions metadata');
+    }
+  };
+
+  useEffect(() => {
+    load();
+  }, []);
+
+  const openCreate = () => {
+    setEditing(null);
+    setForm({ posName: '', requiredQualification: '' });
+    setErrors({});
+    setModalOpen(true);
+  };
+
+  const openEdit = (pos) => {
+    setEditing(pos);
+    setForm({ posName: pos.posName, requiredQualification: pos.requiredQualification });
+    setErrors({});
+    setModalOpen(true);
+  };
+
+  const handleChange = (e) => {
+    const { name, value } = e.target;
+    setForm((prev) => ({ ...prev, [name]: value }));
+    setErrors((prev) => ({ ...prev, [name]: '' }));
+  };
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    const validationErrors = validatePosition(form);
+    if (Object.keys(validationErrors).length) {
+      setErrors(validationErrors);
+      return;
+    }
+    setLoading(true);
+    try {
+      if (editing) {
+        await api.put(`/positions/${editing._id}`, form);
+        toast.success('Position updated');
+      } else {
+        await api.post('/positions', form);
+        toast.success('Position created');
+      }
+      setModalOpen(false);
+      load();
+    } catch (err) {
+      toast.error(err.response?.data?.message || 'Operation failed');
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  const handleDelete = async (id) => {
+    if (!window.confirm('Delete this position?')) return;
+    try {
+      await api.delete(`/positions/${id}`);
+      toast.success('Position deleted');
+      load();
+    } catch (err) {
+      toast.error(err.response?.data?.message || 'Delete failed');
+    }
+  };
+
+  return (
+    <div>
+      <div className="mb-8 flex flex-col gap-4 sm:flex-row sm:items-center sm:justify-between">
+        <div>
+          <h1 className="text-3xl font-bold text-stone-50">Positions</h1>
+          <p className="mt-1 text-brand-300">Job titles and required qualifications</p>
+        </div>
+        <Button onClick={openCreate}>Add position</Button>
+      </div>
+
+      <div className="grid gap-4 lg:grid-cols-2">
+        {positions.map((pos) => (
+          <div key={pos._id} className="group rounded-2xl bg-card p-6 shadow-sm ring-1 ring-brand-700 hover:ring-brand-500">
+            <div className="flex items-start justify-between gap-4">
+              <div>
+                <h3 className="text-lg font-bold text-stone-50">{pos.posName}</h3>
+                <p className="mt-2 text-sm text-brand-300">
+                  <span className="font-medium text-brand-200">Qualification: </span>
+                  {pos.requiredQualification}
+                </p>
+              </div>
+              <div className="flex shrink-0 gap-2">
+                <button
+                  type="button"
+                  onClick={() => openEdit(pos)}
+                  className="rounded-lg px-2 py-1 text-sm font-medium text-brand-300 hover:bg-brand-800 hover:text-stone-100"
+                >
+                  Edit
+                </button>
+                <button
+                  type="button"
+                  onClick={() => handleDelete(pos._id)}
+                  className="rounded-lg px-2 py-1 text-sm font-medium text-red-400 hover:bg-red-900/30"
+                >
+                  Delete
+                </button>
+              </div>
+            </div>
+          </div>
+        ))}
+      </div>
+
+      {positions.length === 0 && (
+        <p className="py-12 text-center text-brand-400 rounded-2xl bg-card ring-1 ring-brand-700">No positions yet</p>
+      )}
+
+      <Modal isOpen={modalOpen} onClose={() => setModalOpen(false)} title={editing ? 'Edit position' : 'Add position'} size="lg">
+        <form onSubmit={handleSubmit}>
+          <div className="space-y-4">
+            <Input label="Position name" name="posName" value={form.posName} onChange={handleChange} error={errors.posName} />
+            <div>
+              <label className="mb-1.5 block text-sm font-medium text-brand-200">Required qualification</label>
+              <textarea
+                name="requiredQualification"
+                value={form.requiredQualification}
+                onChange={handleChange}
+                rows={3}
+                className={`w-full rounded-xl border bg-brand-900 px-4 py-2.5 text-stone-100 focus:border-brand-500 focus:outline-none focus:ring-2 focus:ring-brand-500/30 ${
+                  errors.requiredQualification ? 'border-red-500' : 'border-brand-700'
+                }`}
+              />
+              {errors.requiredQualification && (
+                <p className="mt-1 text-sm text-red-400">{errors.requiredQualification}</p>
+              )}
+            </div>
+          </div>
+          <ModalFooter onCancel={() => setModalOpen(false)} loading={loading} />
+        </form>
+      </Modal>
+    </div>
+  );
+}

package/templates/HRMS_Mongodb/frontend/src/pages/Register.jsx

@@ -0,0 +1,93 @@
+import { useState } from 'react';
+import { useNavigate, Link } from 'react-router-dom';
+import toast from 'react-hot-toast';
+import { useAuth } from '../context/AuthContext';
+
+export default function Register() {
+  const [formData, setFormData] = useState({ userName: '', email: '', password: '' });
+  const [submitting, setSubmitting] = useState(false);
+  const { register } = useAuth();
+  const navigate = useNavigate();
+
+  const handleInputChange = (e) => {
+    setFormData({ ...formData, [e.target.name]: e.target.value });
+  };
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    const { userName, email, password } = formData;
+    if (!userName || !email || !password) {
+      return toast.error('All profile initialization properties are required');
+    }
+    try {
+      setSubmitting(true);
+      await register(formData);
+      toast.success('Registration complete! Please log in.');
+      navigate('/login');
+    } catch (err) {
+      toast.error(err.response?.data?.message || 'Failed to initialize master profile configuration');
+    } finally {
+      setSubmitting(false);
+    }
+  };
+
+  return (
+    <div className="flex min-h-screen items-center justify-center bg-gradient-to-b from-brand-950 via-brand-900 to-brand-950 px-4 py-10">
+      <div className="w-full max-w-md rounded-2xl border border-brand-700/40 bg-card p-8 shadow-2xl shadow-black/30">
+        <p className="text-center text-xs font-semibold uppercase tracking-widest text-brand-400">
+          DAB Enterprise HRMS
+        </p>
+        <h1 className="mt-3 text-center text-2xl font-bold text-white">Initialize Administrator</h1>
+        <p className="mt-2 text-center text-sm text-slate-400">Configure system administrative profile node</p>
+
+        <form onSubmit={handleSubmit} className="mt-8 space-y-5">
+          <div>
+            <label className="block text-xs font-semibold uppercase tracking-wider text-slate-300">Username</label>
+            <input
+              type="text"
+              name="userName"
+              value={formData.userName}
+              onChange={handleInputChange}
+              className="mt-2 w-full rounded-lg border border-slate-800 bg-slate-900/50 px-4 py-2.5 text-white focus:border-brand-500 focus:outline-none"
+              placeholder="master_admin"
+            />
+          </div>
+          <div>
+            <label className="block text-xs font-semibold uppercase tracking-wider text-slate-300">Email Address</label>
+            <input
+              type="email"
+              name="email"
+              value={formData.email}
+              onChange={handleInputChange}
+              className="mt-2 w-full rounded-lg border border-slate-800 bg-slate-900/50 px-4 py-2.5 text-white focus:border-brand-500 focus:outline-none"
+              placeholder="admin@enterprise.com"
+            />
+          </div>
+          <div>
+            <label className="block text-xs font-semibold uppercase tracking-wider text-slate-300">Password</label>
+            <input
+              type="password"
+              name="password"
+              value={formData.password}
+              onChange={handleInputChange}
+              className="mt-2 w-full rounded-lg border border-slate-800 bg-slate-900/50 px-4 py-2.5 text-white focus:border-brand-500 focus:outline-none"
+              placeholder="••••••••"
+            />
+          </div>
+          <button
+            type="submit"
+            disabled={submitting}
+            className="w-full rounded-lg bg-brand-600 py-3 text-sm font-semibold text-white transition-colors duration-200 hover:bg-brand-500 disabled:opacity-50"
+          >
+            {submitting ? 'Configuring System...' : 'Create Account'}
+          </button>
+        </form>
+
+        <p className="mt-6 text-center text-xs text-slate-400">
+          Already registered?{' '}
+          <Link to="/login" className="font-semibold text-brand-400 hover:underline">Log In</Link>
+        </p>
+      </div>
+    </div>
+  );
+}

package/templates/HRMS_Mongodb/frontend/src/pages/ResetPassword.jsx

@@ -0,0 +1,135 @@
+import { useState } from 'react';
+import { Link } from 'react-router-dom';
+import toast from 'react-hot-toast';
+import { useAuth } from '../context/AuthContext';
+import Input from '../components/ui/Input';
+import Button from '../components/ui/Button';
+import { validateEmail } from '../utils/validation';
+
+export default function ResetPassword() {
+  const [form, setForm] = useState({
+    email: '',
+    password: '',
+    confirmPassword: '',
+  });
+  const [errors, setErrors] = useState({});
+  const [loading, setLoading] = useState(false);
+  const [result, setResult] = useState(null);
+  const { resetPassword } = useAuth();
+
+  const handleChange = (e) => {
+    const { name, value } = e.target;
+    setForm((prev) => ({ ...prev, [name]: value }));
+    setErrors((prev) => ({ ...prev, [name]: '' }));
+  };
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    const localErrors = {};
+
+    // 1. Email Format Validation
+    const emailError = validateEmail(form.email);
+    if (emailError) localErrors.email = emailError;
+
+    // 2. Password Completeness Validations
+    if (!form.password) {
+      localErrors.password = 'Password is required';
+    } else if (form.password.length < 6) {
+      localErrors.password = 'Password must be at least 6 characters';
+    }
+
+    if (form.password !== form.confirmPassword) {
+      localErrors.confirmPassword = 'Passwords do not match';
+    }
+
+    if (Object.keys(localErrors).length > 0) {
+      setErrors(localErrors);
+      return;
+    }
+
+    setErrors({});
+    setLoading(true);
+    try {
+      // Sends email along with structural configuration variables to auth endpoints
+      const responseData = await resetPassword({
+        email: form.email.trim().toLowerCase(),
+        password: form.password,
+        confirmPassword: form.confirmPassword,
+      });
+      
+      setResult(responseData || { message: 'Password has been adjusted cleanly.' });
+      toast.success('Password updated successfully');
+    } catch (err) {
+      toast.error(err.response?.data?.message || 'Failed to authorize password modification rules');
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <div className="flex min-h-screen items-center justify-center bg-gradient-to-b from-brand-950 via-brand-900 to-brand-950 px-4 py-10">
+      <div className="w-full max-w-md rounded-2xl border border-brand-700/40 bg-card p-8 shadow-2xl shadow-black/30">
+        <p className="text-center text-xs font-semibold uppercase tracking-widest text-brand-400">
+          DAB Enterprise HRMS
+        </p>
+        <h1 className="mt-3 text-center text-2xl font-bold text-white">Reset password</h1>
+        <p className="mt-2 text-center text-sm text-slate-400">Update your account credentials</p>
+
+        <div className="mt-4 mb-4">
+          <Link to="/login" className="text-sm font-medium text-brand-400 hover:text-white">
+            &larr; Back to sign in
+          </Link>
+        </div>
+
+        {result ? (
+          <div className="mt-6 rounded-lg border border-brand-700/60 bg-brand-950/50 p-4 text-sm text-slate-300">
+            <p className="font-semibold text-white">Password Change Complete</p>
+            <p className="mt-2 text-slate-400">{result.message || 'You can now sign in using your new credentials.'}</p>
+            <Link to="/login" className="mt-5 inline-block w-full">
+              <Button className="w-full">Go to sign in</Button>
+            </Link>
+          </div>
+        ) : (
+          <form onSubmit={handleSubmit} className="mt-6 space-y-4" noValidate autoComplete="off">
+            <Input
+              label="Employee email"
+              name="email"
+              type="email"
+              value={form.email}
+              onChange={handleChange}
+              error={errors.email}
+              placeholder="you@dabenterprise.rw"
+              autoComplete="off"
+            />
+
+            <Input
+              label="New Password"
+              name="password"
+              type="password"
+              value={form.password}
+              onChange={handleChange}
+              error={errors.password}
+              placeholder="••••••••"
+              autoComplete="new-password"
+            />
+
+            <Input
+              label="Confirm New Password"
+              name="confirmPassword"
+              type="password"
+              value={form.confirmPassword}
+              onChange={handleChange}
+              error={errors.confirmPassword}
+              placeholder="••••••••"
+              autoComplete="new-password"
+            />
+
+            <Button type="submit" className="w-full" disabled={loading}>
+              {loading ? 'Processing Reset...' : 'Update Password'}
+            </Button>
+          </form>
+        )}
+      </div>
+    </div>
+  );
+}

package/templates/HRMS_Mongodb/frontend/src/utils/roles.js

@@ -0,0 +1 @@
+export const isAdmin = (user) => user?.role === 'admin' || user?.userName === 'admin';

package/templates/HRMS_Mongodb/frontend/src/utils/session.js

@@ -0,0 +1,5 @@
+export function clearUserSession() {
+  localStorage.removeItem('hrms_token');
+  localStorage.removeItem('hrms_user');
+  sessionStorage.clear();
+}

package/templates/HRMS_Mongodb/frontend/src/utils/validation.js

@@ -0,0 +1,66 @@
+export const validateEmail = (email) => {
+  if (!email?.trim()) return 'Email is required';
+  if (!/^\S+@\S+\.\S+$/.test(email)) return 'Invalid email format';
+  return '';
+};
+
+export const validateRequired = (value, fieldName) => {
+  if (!value?.toString().trim()) return `${fieldName} is required`;
+  return '';
+};
+
+export const validateLogin = ({ userName, password }) => {
+  const errors = {};
+  if (!userName?.trim()) errors.userName = 'Username is required';
+  else if (userName.length < 3) errors.userName = 'Username must be at least 3 characters';
+  else if (!/^[a-zA-Z0-9_]+$/.test(userName)) errors.userName = 'Only letters, numbers, and underscores';
+  if (!password) errors.password = 'Password is required';
+  return errors;
+};
+
+export const validateRegister = (form) => {
+  const errors = {};
+  if (!form.empFirstName?.trim()) errors.empFirstName = 'First name is required';
+  if (!form.empLastName?.trim()) errors.empLastName = 'Last name is required';
+  const emailErr = validateEmail(form.empEmail);
+  if (emailErr) errors.empEmail = emailErr;
+  if (!form.empTelephone?.trim()) errors.empTelephone = 'Telephone is required';
+  if (!form.userName?.trim()) errors.userName = 'Username is required';
+  else if (form.userName.length < 3) errors.userName = 'Username must be at least 3 characters';
+  else if (!/^[a-zA-Z0-9_]+$/.test(form.userName)) errors.userName = 'Only letters, numbers, and underscores';
+  if (!form.password) errors.password = 'Password is required';
+  else if (form.password.length < 6) errors.password = 'Password must be at least 6 characters';
+  if (!form.confirmPassword) errors.confirmPassword = 'Please confirm your password';
+  else if (form.password !== form.confirmPassword) errors.confirmPassword = 'Passwords do not match';
+  return errors;
+};
+
+export const validateEmployee = (form) => {
+  const errors = {};
+  if (!form.empFirstName?.trim()) errors.empFirstName = 'First name is required';
+  if (!form.empLastName?.trim()) errors.empLastName = 'Last name is required';
+  const emailErr = validateEmail(form.empEmail);
+  if (emailErr) errors.empEmail = emailErr;
+  if (!form.empTelephone?.trim()) errors.empTelephone = 'Telephone is required';
+  if (!form.empGender) errors.empGender = 'Gender is required';
+  if (!form.empAddress?.trim()) errors.empAddress = 'Address is required';
+  if (!form.empDateOfBirth) errors.empDateOfBirth = 'Date of birth is required';
+  if (!form.empHireDate) errors.empHireDate = 'Hire date is required';
+  if (!form.empStatus) errors.empStatus = 'Status is required';
+  if (!form.department) errors.department = 'Department is required';
+  if (!form.position) errors.position = 'Position is required';
+  return errors;
+};
+
+export const validateDepartment = (form) => {
+  const errors = {};
+  if (!form.departName?.trim()) errors.departName = 'Department name is required';
+  return errors;
+};
+
+export const validatePosition = (form) => {
+  const errors = {};
+  if (!form.posName?.trim()) errors.posName = 'Position name is required';
+  if (!form.requiredQualification?.trim()) errors.requiredQualification = 'Qualification is required';
+  return errors;
+};

package/templates/HRMS_Mongodb/frontend/vite.config.js

@@ -0,0 +1,16 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import tailwindcss from '@tailwindcss/vite';
+
+export default defineConfig({
+  plugins: [react(), tailwindcss()],
+  server: {
+    port: 5173,
+    proxy: {
+      '/api': {
+        target: 'http://localhost:5000',
+        changeOrigin: true,
+      },
+    },
+  },
+});

package/templates/HRMS_Mysql/backend/db.js

@@ -0,0 +1,13 @@
+const mysql = require('mysql2');
+
+const pool = mysql.createPool({
+  host: process.env.DB_HOST || 'localhost',
+  user: process.env.DB_USER || 'root',
+  password: process.env.DB_PASSWORD || '',
+  database: process.env.DB_NAME || 'HRMS',
+  waitForConnections: true,
+  connectionLimit: 10,
+  queueLimit: 0
+});
+
+module.exports = pool.promise();