Skip to content

gns-x/Academix

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AcademiX - The Future of School Management

Dance of the Numbers

Welcome to AcademiX! Where school management transforms from mundane to magical, utilizing the latest technologies to dance at your fingertips and light up the educational universe. We invite you on this whimsical journey where managing education is not just smart—it's enchanting! ✨


Build StatusLicenseContributorsTech Stack


🚀 Why Choose AcademiX?

Imagine a world where school administration is a symphony of efficiency, communication flows seamlessly, and educational institutions rise to their highest potential. That's not just our dream—it's AcademiX reality! 🎶

  • ✨ Centralized Data: The North Star guiding all operational processes.
  • 📈 Automation: Think of it as your invisible assistant handling tiresome tasks like billing, so you can focus on creating stars.
  • 📢 Improved Communication: Your magic wand for connecting everyone.
  • 📏 Scalability: Grow and evolve with us, soaring on modern frameworks.
  • 🖥️ Modern User Experience: It’s like piloting a sleek spaceship to galaxy education.

Communication Connect


🌟 Key Features That Light Up!

AcademiX isn't just software, it's a constellation of modules designed to sparkle throughout school administration. 🌌

🎓 Student Lifecycle Management

Unravel the mysteries of each student from enrollment to graduation. 🌠

  • 📜 Comprehensive Profiles
  • 📝 Academic Tracking
  • 📅 Attendance Monitoring
  • 🏅 Service Enrollment
  • 🚦 Behavioral Incidents Tracking

Academic Evolution


💰 Financial Operations & Billing

Turn the number-crunching into a rhythmic dance. 💸

  • 💵 Automated Fee Management
  • 💳 Flexible Payment Processing
  • 🧾 Invoice & Receipt Generation
  • 📆 Payment Plans & Reminders
  • 📊 Financial Reporting

Cash Flow Magic


📚 Service & Activity Management

Channel energy into extracurricular activities and services. 🎨

  • 🛠️ Customizable Service Offerings
  • 🔄 Enrollment & Capacity Tracking
  • 🔗 Automated Billing Integration
  • 📈 Usage Analytics

Service Symphony


👨‍👩‍👧 Family & Guardian Engagement

Weave strong familial bonds and enable comprehensive engagement. 🧑‍🤝‍🧑

  • 🌳 Family Tree Visualization
  • 🧑‍💻 Guardian Portals
  • 🚨 Emergency Contacts
  • 📧 Communication Hub

Family Tree Growth


👩‍🏫 Teacher & Staff Empowerment

Equip educators with the tools to thrive and spread educational brilliance. 🏆

  • 📔 Detailed Profiles
  • 📖 Class & Course Assignment
  • 📊 Performance & Evaluation
  • 📅 Schedule Management
  • 📝 Exam & Grading Tools

Teacher Empowerment

📦 Getting Started

Embarking on your AcademiX journey is as simple as 1-2-3! 🛸

Prerequisites

Ensure you have:

  • 🛠️ Node.js v18+
  • 📚 npm or yarn
  • 🗄️ PostgreSQL server

Backend Setup

cd backend
npm install # or yarn install
cp .env.example .env
npm run prisma:generate # or yarn prisma:generate
npm run prisma:migrate dev # or yarn prisma:migrate dev
npm run start:dev # or yarn start:dev

Frontend Setup

cd frontend
npm install # or yarn install
cp .env.example .env
npm run dev # or yarn dev

🔧 Elegant Configuration

Deep dive into .env files and unlock AcademiX's full potential. 🚪

Backend (backend/.env)

NODE_ENV=development # Change to production when ready
PORT=3000
DATABASE_URL=<YOUR-POSTGRES-STRING>
JWT_SECRET=<YOUR-SECRET>

Frontend (frontend/.env)

NODE_ENV=development # Change to production when ready
VITE_API_URL="http://localhost:3000/api"
VITE_SUPABASE_URL=<YOUR-SUPABASE-URL>
VITE_SUPABASE_ANON_KEY=<YOUR-SUPABASE-ANON-KEY>

📊 Database Schema Overview

Unveil the intricate design at the heart of AcademiX! 🧬

  • Students, Teachers, Guardians
  • Courses, Classes
  • Services, Fees
  • Users & Roles

(A link to an interactive schema diagram appears here for mystical insight.)


🔐 Security Measures

Guard the treasures within AcademiX with robust security spells:

  • 🔒 JWT Authentication
  • 📜 RBAC
  • 🔩 Password Hashing
  • 🔍 Input Validation
  • 🌐 CORS Protection
  • ⏲️ Rate Limiting

🚀 Deployment

Onward to scaling new heights with swift deployment techniques. 🌐

Backend Deployment

  1. Build production server:
    cd backend
    npm run build # or yarn build
  2. Configure .env for production.
  3. Start server with PM2 or cloud deployment:
    npm run start:prod # or yarn start:prod

Frontend Deployment

  1. Build production frontend:
    cd frontend
    npm run build # or yarn build
  2. Deploy dist folder using Netlify, Vercel, etc.

🤝 Contributing

Join the grand collaboration quest to expand AcademiX’s universe! 🧙‍♂️

  1. Fork the project
  2. Clone on your machine
  3. Branch for your feature/fix
  4. Commit your creations
  5. Push and Open Pull Request

Check our CONTRIBUTING.md for more details.


👥 Authors


🙏 Acknowledgments

To all open-source champions who laid the foundation, AcademiX rises high with your support and inspiration. 🚀

Welcome aboard AcademiX—where management meets magic and education dreams soar! 🌠

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages