Skip to content

Latest commit

 

History

History
146 lines (96 loc) · 5.44 KB

README.md

File metadata and controls

146 lines (96 loc) · 5.44 KB

SOFA King 👑

SOFA King is a comprehensive, streamlined solution for managing SOFA (Status of Forces Agreement) permits within military installations. Built with ease-of-use in mind, the system handles everything from permit generation to digital signatures, using the powerful FARGO HDP5000 card printer and Microsoft Excel for database management.

"From spark to success – SOFA King is here to make your process smoother." – StrackVibes

Product Example Product Example

🚀 Features

  • Automated Permit Creation: No more manual entries! SOFA King interacts with an Excel database, generating unique permit numbers and filling out forms with the click of a button.
  • Digital Signature Integration: Collect 'wet' signatures via the GUI and print them directly onto the permit card.
  • Second Permit Support: Manage customers with multiple permits, including motorcycle permits with MSF and CAT/PAX information.
  • User-Friendly Interface: A sleek, simple GUI for quick and intuitive user input.
  • DoD ID Integration: Seamlessly pull data with a DoD ID search to auto-populate form fields.
  • Real-Time Permit Management: Easily track, issue, and print permits on-demand, saving valuable time and reducing errors.

🎯 Purpose

Designed to reduce the hassle of managing SOFA permits at the Visitor Center, SOFA King takes a traditionally paper-heavy process and digitizes it. The goal is to improve operational efficiency, enhance security, and simplify the customer experience.

🛠️ Built With

  • Language: C#
  • Framework: Windows Forms
  • Database: Microsoft Excel
  • Hardware: FARGO HDP5000 Printer
  • Other Tools: .NET 8

⚡ Getting Started

Installation

SOFA King has already been published as an executable and is ready to use.

  1. Access the shared drive: SOFA King is located in the shared drive accessible by all Visitor Center staff.
  2. Run the executable: Simply double-click the .exe file to launch the application.
  3. Printer Setup: Ensure your FARGO HDP5000 card printer is connected and configured to print permits.
  4. .NET Requirement: Make sure you have .NET 8 installed for the application to run smoothly.

That's it! No need to open the project in Visual Studio – the application is fully executable.

🤖 Automation and Database Integration

SOFA King is designed to automate much of the paperwork process. After inputting customer information and collecting the necessary signatures, the system:

  • Generates unique permit numbers.
  • Pulls previous permit info from the Excel database for customers needing second permits.
  • Prints permit cards directly with the FARGO HDP5000.

Roadmap

  • Publish SOFA King as an executable
  • Implement digital signature integration
  • Add feature to take customer photo for SOFA permits
  • Add language toggle button (English/Japanese)
  • Multi-language support
    • Japanese

See the open issues for a full list of proposed features (and known issues).

(back to top)

🧪 Current Status: Durability Testing

Shogun Spark is currently conducting durability tests to compare the existing paper SOFA permits against the plastic cards that SOFA King seeks to implement across PACAF. The results will determine the viability of moving from paper to plastic permit solutions.

🏅 Recognition

SOFA King is not just a tool – it’s a solution that’s being recognized for transforming visitor permit management:

  • Currently in durability testing with Shogun Spark to assess implementation.
  • Planned expansion across PACAF after successful testing and approval.

📜 License

This project is licensed under the MIT License – see the LICENSE.md file for details.

👨‍💻 Contributing

Contributions are welcome! Whether it’s bug fixes, new features, or improvements, feel free to submit a pull request. For major changes, please open an issue first to discuss what you would like to modify.

  1. Fork the repo
  2. Create your feature branch: git checkout -b feature/AmazingFeature
  3. Commit your changes: git commit -m 'Add some AmazingFeature'
  4. Push to the branch: git push origin feature/AmazingFeature
  5. Open a pull request

👏 Acknowledgments

Special thanks to YokoWerx and Shogun Spark, the innovators fueling creativity and growth across PACAF. Your contributions make it possible to drive innovation forward.

📫 Contact

For questions, feedback, or contributions, reach out to:

Stay updated with all the latest innovations! 🚀

(back to top)