{"id":28227833,"url":"https://github.com/lates-codrin/library-management","last_synced_at":"2026-01-28T12:03:41.886Z","repository":{"id":292194004,"uuid":"980112965","full_name":"lates-codrin/Library-Management","owner":"lates-codrin","description":"An administrative tool built for the sole purpose of managing a library.","archived":false,"fork":false,"pushed_at":"2025-05-10T19:31:26.000Z","size":17321,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-13T10:49:27.591Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lates-codrin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-08T15:25:54.000Z","updated_at":"2025-05-10T19:31:30.000Z","dependencies_parsed_at":"2025-06-13T10:35:20.044Z","dependency_job_id":"dd4e824a-145b-4c7b-b6b0-b917fb67c1a1","html_url":"https://github.com/lates-codrin/Library-Management","commit_stats":null,"previous_names":["lates-codrin/library-management"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/lates-codrin/Library-Management","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lates-codrin%2FLibrary-Management","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lates-codrin%2FLibrary-Management/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lates-codrin%2FLibrary-Management/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lates-codrin%2FLibrary-Management/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lates-codrin","download_url":"https://codeload.github.com/lates-codrin/Library-Management/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lates-codrin%2FLibrary-Management/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28845103,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T10:53:21.605Z","status":"ssl_error","status_checked_at":"2026-01-28T10:53:20.789Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-18T13:16:32.692Z","updated_at":"2026-01-28T12:03:41.870Z","avatar_url":"https://github.com/lates-codrin.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://i.imgur.com/w9A0rh2.png\" alt=\"Library Management System Mockup Image\" style=\"max-width: 100%; height: auto;\" /\u003e\n\u003c/p\u003e\n\n\n### [!] Notice\n- You may not commit to this project. If you find something bothering you, please open an issue first! 👍\n- You may run unit tests (made with xUnit) by using the built-in Visual Studio tests explorer.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/lates-codrin/Library-Management/releases/download/v0.0.1-beta/Setup.pdf\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/📄%20Download-Documentation%20PDF-green?style=for-the-badge\" alt=\"Download Documentation PDF\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/lates-codrin/Library-Management/releases/download/v0.0.1-beta/x64.zip\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/📦%20Download-Release-orange?style=for-the-badge\" alt=\"Download Release\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\n\nA desktop-based Library Management System built in C# with a multi-layered architecture. This project is developed as part of the Internship 2025 and aims to provide a user-friendly way for library admins to manage book inventories, issue and return books, and receive book recommendations using AI.\n\n---\n\n\n# 🚀 How to Run the Project\n\n## Prerequisites\n1. Install Visual Studio 2017, Visual Studio 2019 **or** [Visual Studio 2022](https://visualstudio.microsoft.com/downloads/) or newer. \n2. Install [.NET SDK 8.0](https://dotnet.microsoft.com/en-us/download/visual-studio-sdks) or higher (or when installing Visual Studio, choose \".NET Desktop Development\") \u003cbr\u003e\n   If you don't have the SDK installed, Visual Studio will automatically prompt you to install \".NET Desktop Development\". Click Install.\n3. Install [GIT CLI](https://git-scm.com/downloads) or GitHub Desktop\n\n---\n## 🔷 Method 1: Using Visual Studio (Recommended)\n1. Clone the Repository\n2. Open a terminal or Git Bash and run:\n\n```bash\ngit clone https://github.com/lates-codrin/Library-Management.git\n```\n\n3. Open the Solution File (*Library_Management_System.sln*)\n\n4. Restore Dependencies \u0026 Build\nVisual Studio will automatically restore NuGet packages. Then build the project using:\nBuild \u003e Build Solution or Ctrl + Shift + B\n\n5. Run the Application\nClick the green Start button or press F5.\n\n---\n\n## 🔹 **Method 2: Download the source code**\n1. Download the project from GitHub:\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://i.imgur.com/SdtVaA3.png\" alt=\"Download Image\" style=\"max-width: 100%; height: auto;\" /\u003e\n\u003c/p\u003e\n\n\n2. Open the .zip \u003e first folder \u003e .sln solution\n3. Build \u0026 run using the built-in Visual Studio tools\n\n---\n\n## 🔹 **Method 3: Download the release**\n\n1. Download the release (x64.zip) [here](https://github.com/lates-codrin/Library-Management/releases/tag/v0.0.1-beta) or via the **Download Release** buton above.\n2. Open the .zip \u003e folder \u003e .exe\n3. The application should start as usual\n\n---\n\n# 🤖 Custom Feauture - AI-GPT Book Reccomender\nThis unique feature allows the administrator to input:\n\n* A book title\n* Its category\n* A brief synopsis\n\n💡 The system then uses the OpenAI GPT model to suggest a relevant and potentially interesting book. This serves as a smart assistant to help users discover new reads aligned with their interests or library offerings.\n\n## 🔶 How to Run the Feature:\n**To enjoy the AI-powered book recommendation feature, you'll need an OpenAI API key. You have two simple options:**\n\n### 🔹 **Option 1**: Use the Built-in Key (Default, Free)\nNo action required — a preloaded OpenAI key with a $5 credit limit (already covered) is integrated directly into the application. Just launch and enjoy! \u003cbr\u003e\n\nKeep in mind that such variables (API keys, auth tokens) I usually store in an env file. \nHowever, I have no other way to share this token with you so it's built-in. \u003cbr\u003e\n\n### 🔹 **Option 2**: Use Your Own Key\nPrefer using your personal OpenAI account? Follow these steps:\n\n1. Sign in to the OpenAI platform: https://platform.openai.com/api-keys\n2. Generate an API key from your account dashboard.\n3. Purchase $5 in credits to enable usage.\n4. Copy your key and store it securely.\n5. Open the app, navigate to the settings, paste your key, click Save, then restart the application.\n\n---\n\n# Documentation Website (DocFX)\n\n## Prerequisites\n\nFamiliarity with the command line\nInstall .NET SDK 8.0 or higher\nInstall Node.js v20 or higher (Optional: It's required when using Create PDF Files)\n\nMake sure you have .NET SDK installed, then open a terminal and enter the following command to install the latest docfx:\n```bash\ndotnet tool update -g docfx\n```\n\n1. Open a terminal\n2. Run \n```bash\ndocfx --serve\n```\n3. Restart PC\n4. Open the link provided in the console by docfx\n\n\n\n\n## 🛠️ Technologies Used\n\n- **.NET (C# WPF)**\n- **MVVM Pattern** (via [CommunityToolkit.Mvvm](https://learn.microsoft.com/en-us/dotnet/communitytoolkit/mvvm/overview))\n- **Local JSON Storage**\n- **OpenAI GPT API Integration** (for book recommendations)\n- **WPF UI** (via [WPF-UI](https://wpfui.lepo.co/))\n  \n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://i.imgur.com/oLldy3v.png\" alt=\"Schema\" style=\"max-width: 100%; height: auto;\" /\u003e\n\u003c/p\u003e\n\n---\n\n\n\n# 📄 **Notes**\n* All data is persisted across sessions using JSON files stored locally.\n* The UI is built using WPF (and WPFUI) with a clean and modern design.\n\n\n\n# 📬 **Contact**\nFor any questions or feedback, feel free to contact:\nLates Codrin-Gabriel – latescodrin@gmail.com\n\n\n# 📝 **Credits**\n* **WPF UI Library**: See here https://wpfui.lepo.co/\n\n* Apple Design Resources: Mock images used in the design were sourced from Apple's official design resources. Mock designed with https://mockuphone.com/.\n\n* Third-Party Libraries: All third-party libraries used in this project are licensed under the MIT License.\n\n# 🏁 Final Thoughts\nThis project demonstrates basic skills in **.NET development**, **WPF UI design**, the use of external libraries like **CommunityToolkit.Mvvm**, and a solid understanding of **multi-layered architecture** for clean separation of concerns and scalability.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flates-codrin%2Flibrary-management","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flates-codrin%2Flibrary-management","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flates-codrin%2Flibrary-management/lists"}