Awlak Benjah?

"Awlak Benjah?" (Arabic for "Will You Pass?") is an innovative academic planning and grade prediction tool specifically designed for Lebanese University students. This web application addresses a common challenge faced by university students: understanding their academic standing and predicting final outcomes based on current performance. The application provides an intuitive interface where students can input their course grades, credit hours, and assessment weights to calculate various academic metrics. The core functionality includes GPA calculation based on the Lebanese University grading system, semester GPA and cumulative GPA tracking, "what-if" scenario analysis for grade predictions, required score calculations to achieve target GPAs, and comprehensive grade distribution analysis. Built with React for a dynamic and responsive frontend experience, the application offers real-time calculations as students input their data. The component-based architecture ensures modularity and reusability, with dedicated components for grade entry, GPA display, scenario planning, and analytics visualization. State management is handled efficiently through React hooks, providing smooth interactions and instant feedback. The backend is powered by Express.js, providing a lightweight yet capable API layer. While the application primarily runs client-side for instant calculations, the backend handles user authentication (optional), data persistence for returning users, analytics tracking to understand usage patterns, and serves as a foundation for future enhancements like historical grade data analysis and peer comparison features. Data persistence is managed through SQLite, chosen for its simplicity and efficiency for this use case. The database stores user profiles, historical grade data, saved scenarios, and calculation history. This allows students to track their academic progress over multiple semesters and analyze trends in their performance. Key features include support for the Lebanese University credit-hour system and grading scale; multiple calculation modes (current GPA, required grades for target GPA, semester projections); visual representations of grade distributions using charts and graphs; mobile-friendly responsive design for on-the-go access; offline capability with local storage fallback; export functionality for generating PDF reports of academic progress; and privacy-focused design with optional anonymous usage. The user interface emphasizes clarity and ease of use, with color-coded grade indicators, step-by-step wizards for complex calculations, helpful tooltips explaining academic concepts, and a clean, distraction-free design that focuses on the essential information. Developed during my late undergraduate years (January-March 2024), this project served a practical need within the Lebanese University community. It helped hundreds of students better understand their academic standing and make informed decisions about their course load and study priorities. The project has since been archived as I've moved on to more complex endeavors, but it remains a testament to creating practical solutions that address real-world problems faced by students. The development of "Awlak Benjah?" provided valuable lessons in user-centered design, working with real-world data structures, implementing complex calculations in a user-friendly interface, and the importance of thorough testing with diverse academic scenarios. It represents an early but significant step in my journey as a developer, demonstrating problem-solving skills and the ability to identify and address community needs through technology.