{"id":23260407,"url":"https://github.com/paulmuenzner/coolinggridmanager","last_synced_at":"2026-04-30T10:05:10.241Z","repository":{"id":236107631,"uuid":"776565618","full_name":"paulmuenzner/CoolingGridManager","owner":"paulmuenzner","description":"C# Cooling Grid Manager is a software solution designed to efficiently manage and optimize cooling grid systems.","archived":false,"fork":false,"pushed_at":"2024-05-18T14:12:25.000Z","size":534,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-19T10:55:14.712Z","etag":null,"topics":["asp-net-core","cooling-pipes","cronjob","crontab","csharp","csharp-app","energy-efficiency","energy-management","energy-management-system","postgresql","swagger"],"latest_commit_sha":null,"homepage":"https://www.paulmuenzner.com","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paulmuenzner.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2024-03-23T21:21:38.000Z","updated_at":"2024-05-18T14:12:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"1c503861-096d-41dc-ad9d-6666ca35a980","html_url":"https://github.com/paulmuenzner/CoolingGridManager","commit_stats":null,"previous_names":["paulmuenzner/coolinggridmanager"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/paulmuenzner/CoolingGridManager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulmuenzner%2FCoolingGridManager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulmuenzner%2FCoolingGridManager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulmuenzner%2FCoolingGridManager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulmuenzner%2FCoolingGridManager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paulmuenzner","download_url":"https://codeload.github.com/paulmuenzner/CoolingGridManager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulmuenzner%2FCoolingGridManager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32460802,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T22:27:22.272Z","status":"online","status_checked_at":"2026-04-30T02:00:05.929Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["asp-net-core","cooling-pipes","cronjob","crontab","csharp","csharp-app","energy-efficiency","energy-management","energy-management-system","postgresql","swagger"],"created_at":"2024-12-19T13:16:49.041Z","updated_at":"2026-04-30T10:05:10.226Z","avatar_url":"https://github.com/paulmuenzner.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\n\n\u003c!-- PROJECT SHIELDS --\u003e\n[![Issues][issues-shield]][issues-url]\n[![GNU License][license-shield]][license-url]\n![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/paulmuenzner/CoolingGridManager)\n![GitHub top language](https://img.shields.io/github/languages/top/paulmuenzner/CoolingGridManager)\n[![paulmuenzner github][github-shield]][github-url] \n[![Contributors][contributors-shield]][contributors-url]\n\n\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n\n  \u003ch3 align=\"center\"\u003eC# Cooling Grid Manager\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    Billing - Ticket System - Consumption - Efficiency\n    \u003cbr /\u003e\n    \u003ca href=\"#about-the-project\"\u003e\u003cstrong\u003eEXPLORE DOCS\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"#about-the-project\"\u003ePlenty of features\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/paulmuenzner/CoolingGridManager/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/paulmuenzner/CoolingGridManager/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#roadmap\"\u003eRoadmap\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contact\"\u003eContact\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About The Project\n\nThis Cooling Grid Manager is a software solution designed to efficiently manage and optimize cooling grid systems. This project leverages the power of C# programming language and .NET technologies to deliver a robust and user-friendly application tailored for the needs of cooling grid operators and managers. See it as a starting point and develop and extend it as per your needs.\n\n\n### Features\n-   ***Ticket Management:*** Streamline ticket creation, tracking, and resolution processes for maintenance, repairs, billing, and other operational tasks.\n-   ***Integration:*** Seamlessly integrate with existing data sources, IoT devices, and monitoring systems to centralize data management and enhance operational efficiency.\n-   ***Parameter Logging:*** Track and log grid parameters for each cooling grid system, facilitating loss analysis, root cause identification, and remedial action implementation.\n-   ***Billing:*** Efficiently manage billing processes for cooling grid services, including invoicing, payment tracking, and revenue management.\n-   ***Consumer Management:*** Centralize consumer data and interactions, enabling effective communication, service provisioning, and account management.\n-   ***Consumption Tracking:*** Monitor and analyze cooling grid consumption patterns to optimize resource allocation, identify inefficiencies, and implement cost-saving measures.\n\n\n\n### Technologies Used\n\n-   ***C#:*** The primary programming language used for developing the Cooling Grid Manager, providing a powerful and versatile framework for application development.\n-   ***ASP.NET Core:*** Utilized for building scalable and high-performance web applications, enabling cross-platform compatibility and modern web development practices.\n-   ***Entity Framework Core:*** Facilitates object-relational mapping (ORM) for database interaction, simplifying data access and management.\n-   ***FluentValidation:*** Integrated for comprehensive validation of input data, ensuring data integrity and application reliability.\n-   ***Serilog:*** Employed for structured logging, enabling efficient monitoring and troubleshooting of application behavior and errors.\n-   ***Cron Jobs:*** Implemented for automating tasks such as creating bills and calculating grid efficiency and energy transfer at the start of each month, enhancing efficiency and reducing manual intervention.\n-   ***Swagger:*** Integrated Swagger for API documentation, offering a user-friendly interface to explore and interact with API endpoints, facilitating development and collaboration.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- USAGE --\u003e\n## Usage\n\n### Run program\n\nRun program by: `dotnet run` \nBuild program by: `dotnet build` \n\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n### Endpoints \n\nThis server exposes various endpoints to facilitate authentication, file management, and plant-related operations.\nPlease review implemented swagger information for more details at: http://localhost:5286/index.html\n\n#### Tickets\n\nThe files API '/tickets' provides functionality for creating and updating (eg. status \"solved\") support tickets.\nCurrently available options for status are 'open', 'onhold' and 'solved'.\nFor the purpose of Incident Management, support tickets can be submitted and managed to keep an eye on and solve adverse events.\n\n\n#### Consumption \n\nAPI '/consumptions' offers endpoints for managing consumption data of consumers.\n\n\n#### Billing \n\nAPI '/billing' offers endpoints for managing consumer bills.\n\n\n#### Consumer \n\nAPI '/consumers' offers endpoints for managing consumers, for example creation of a new consumer or retrieving consumer details connected to a grid section of a grid.\n\n\n#### Grids \n\nAPI '/grids' offers endpoints for managing cooling grid systems, for example creation of a new grid.\n\n\n#### Grid Sections \n\nSubdivide each grid into sections with API '/gridsections' for better overview and management.\n\n\n#### Grid Parameters \n\nAPI '/gridparameters' offers endpoints for managing cooling grid systems. \nFor example, add new grid parameter log, such as mass flow rate (in kg/s), specific heat capacity of the heating fluid (in J/kg⋅K) as well as temperature inlet and outlet (K) which is needed to calculate the temperature difference ΔT = T_in - T_out. The following formula can be used to calculate the energy flow (cooling energy transfer rate) through the pipe: Energy Flow (Q) = Mass Flow Rate (m) * Specific Heat Capacity (Cp) * Temperature Difference (ΔT). Determine the appropriate frequency for data collection based on your monitoring needs. A higher frequency provides more detailed information but requires more storage and processing resources.\n\n\n#### Grid Energy Transfer \n\nAPI '/GridEnergyTransfer' offers endpoints for managing the transfered energy per month. Based on on the logged parameters of the grid, the entire energy transfer in kWh is calculated for each month based on E_month = (m_dot) * (cp) * (T_in - T_out) * (t) / (3600 * 1000). T_in represents the average flow temperature into the grid; T_out the return flow temperature. t reflects the time in seconds. The difference between energy transfer of the grid and total consumer consumption reflects grid losses.\n\n\n\n\u003c!-- ROADMAP --\u003e\n## Roadmap\n\n-   ✅ Cron job implementation calculating and storing grid energy transfer\n-   ✅ Cron job implementation calculating and storing grid efficiency\n-   ⬜️ Implementing Authentication and Authorization \n-   ⬜️ Providing statistical evaluation\n-   ⬜️ Extend testing\n-   ⬜️ Add email notifications\n\n\nSee the [open issues](https://github.com/paulmuenzner/CoolingGridManager/issues) to report bugs or request fatures.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- CONTRIBUTING --\u003e\n## Contributing\n\nContributions to the Cooling Grid Manager project are welcome! Whether you're interested in adding new features, fixing bugs, or improving documentation, your contributions are highly valued. To get started, fork the repository, make your changes, and submit a pull request. \n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for more info.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under the GNU General Public License v2.0. See [LICENSE](LICENSE.txt) for more information.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- CONTACT --\u003e\n## Contact\n\nPaul Münzner: [https://paulmuenzner.com](https://paulmuenzner.com) \n\nProject Link: [https://github.com/paulmuenzner/CoolingGridManager](https://github.com/paulmuenzner/CoolingGridManager)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n[golang-shield]: https://img.shields.io/badge/golang-black.svg?logo=go\u0026logoColor=ffffff\u0026colorB=00ADD8\n[golang-url]: https://go.dev/\n[aws-shield]: https://img.shields.io/badge/aws_s3-black.svg?logo=amazons3\u0026logoColor=ffffff\u0026colorB=569A31\n[aws-url]: https://aws.github.io/aws-sdk-go-v2/docs/\n[mongodb-shield]: https://img.shields.io/badge/mongodb-black.svg?logo=mongodb\u0026logoColor=ffffff\u0026colorB=47A248\n[mongodb-url]: https://go.dev/\n[github-shield]: https://img.shields.io/badge/paulmuenzner-black.svg?logo=github\u0026logoColor=ffffff\u0026colorB=000000\n[github-url]: https://github.com/paulmuenzner?tab=repositories\n[contributors-shield]: https://img.shields.io/github/contributors/paulmuenzner/CoolingGridManager.svg\n[contributors-url]: https://github.com/paulmuenzner/CoolingGridManager/graphs/contributors\n[issues-shield]: https://img.shields.io/github/issues/paulmuenzner/CoolingGridManager.svg\n[issues-url]: https://github.com/paulmuenzner/CoolingGridManager/issues\n[license-shield]: https://img.shields.io/badge/license-GPL_2.0-orange.svg?colorB=FF5733\n[license-url]: https://github.com/paulmuenzner/CoolingGridManager/blob/master/LICENSE.txt\n\u003c!-- [website-shield]: https://img.shields.io/badge/www-paulmuenzner.com-blue\n[website-url]: https://paulmuenzner.com --\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulmuenzner%2Fcoolinggridmanager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaulmuenzner%2Fcoolinggridmanager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulmuenzner%2Fcoolinggridmanager/lists"}