https://github.com/keiaa-75/gomis

A management information system for school guidance offices, built using Java.
https://github.com/keiaa-75/gomis

desktop-application information-system java management-system mariadb maven

Last synced: 8 months ago
JSON representation

A management information system for school guidance offices, built using Java.

• Host: GitHub
• URL: https://github.com/keiaa-75/gomis
• Owner: keiaa-75
• License: mpl-2.0
• Created: 2025-08-16T14:54:42.000Z (10 months ago)
• Default Branch: public
• Last Pushed: 2025-09-30T01:52:26.000Z (9 months ago)
• Last Synced: 2025-09-30T02:34:37.480Z (9 months ago)
• Topics: desktop-application, information-system, java, management-system, mariadb, maven
• Language: Java
• Homepage:
• Size: 331 MB
• Stars: 2
• Watchers: 0
• Forks: 0
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# GOMIS

[![Lead](https://img.shields.io/badge/Lead-@GaudenzPads-blue?logo=github&style=flat)](https://github.com/GaudenzPadz)

[![Co-Lead](https://img.shields.io/badge/Co--Lead-@khierallen-blue?logo=github&style=flat)](https://github.com/khierallen)

[![Maintainer](https://img.shields.io/badge/Maintainer-@keiaa--75-blue?logo=github&style=flat)](https://github.com/keiaa-75)

[![Java](https://img.shields.io/badge/Made%20with-Java-ED8B00.svg?style=flat&logo=openjdk)](https://www.java.com/)

GOMIS is a Guidance Office Management Information System developed to be a supportive tool for school guidance offices. 

This system was originally created for the Luis Y. Ferrer Jr. Senior High School Guidance Office to meet their specific needs. **This project is currently in a beta state and is not recommended for production environments.**

## Features

- **Student Records Management:** Easily manage and access student profiles.

- **Incident Reporting:** File a detailed report of incidents or issues.

- **Counselling Appointment:** Set and manage appointments with students using the built-in calendar.

- **Good Moral Certificate Generation:** Automatically generate and print Good Moral certificates.

## Getting Started

This is the fastest way to build and install everything you need.

- Open **PowerShell** in the main project directory. If you're using VS Code, you can press Ctrl + J to open the integrated terminal.

- Run the following command:

    ```powershell

    pwsh ./build-all.ps1

    ```

    This script will automatically build the main app, the validator, the executable (.exe) file, and the installer in a single step. You can view the detailed logs at `gomis-installer/build-all.log` for troubleshooting.

## Troubleshooting

If you run into any issues, here are a few common problems and their solutions.

- **Database error:** Re-run the installer to ensure the database is created correctly. The default root password is `YourRootPassword123!`.

- **Build failure:** Check `gomis-installer/build-all.log` for errors and verify that all files in the `resources/` directory are present.

- **Null Frame error:** Recompiling the project often solves this issue.

## Credits and Acknowledgements

GOMIS is a capstone project by students of ICT CP12 - Kotlin (Academic Year 2024–2025). 

Special thanks to:

- The Luis Y. Ferrer Jr. SHS Guidance Office for their collaboration and real-world insights.

- Sir Zander Allen Flores, our specialization teacher and mentor.

## Licenses

This project is licensed under the **Mozilla Public License 2.0 (MPL 2.0)**. Third-party libraries are distributed under their respective licenses. Any additional assets not covered by such are licensed under the **Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0)**.