{"id":50798780,"url":"https://github.com/thesmallpixel/iol-echat","last_synced_at":"2026-06-18T23:00:58.080Z","repository":{"id":364280076,"uuid":"1267120682","full_name":"TheSmallPixel/IOL-ECHAT","owner":"TheSmallPixel","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-12T11:08:52.000Z","size":5414,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-12T17:29:47.360Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheSmallPixel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-12T08:36:21.000Z","updated_at":"2026-06-12T11:17:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/TheSmallPixel/IOL-ECHAT","commit_stats":null,"previous_names":["thesmallpixel/iol-echat"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TheSmallPixel/IOL-ECHAT","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheSmallPixel%2FIOL-ECHAT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheSmallPixel%2FIOL-ECHAT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheSmallPixel%2FIOL-ECHAT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheSmallPixel%2FIOL-ECHAT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheSmallPixel","download_url":"https://codeload.github.com/TheSmallPixel/IOL-ECHAT/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheSmallPixel%2FIOL-ECHAT/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34294415,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"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":[],"created_at":"2026-06-12T17:05:51.026Z","updated_at":"2026-06-14T19:00:52.235Z","avatar_url":"https://github.com/TheSmallPixel.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ECHAT: Enterprise E2EE Chat System\n\n\u003e **[Read the documentation](https://TheSmallPixel.github.io/IOL-ECHAT/)**\n\n\u003e **University project** built for academic purposes as a thesis project. It is a learning-oriented reference implementation, not a production-hardened product.\n\nEnterprise messaging system with end-to-end encryption (E2EE). The server cannot read message contents: all encryption and decryption happen on the client, and the server only stores ciphertext, wrapped keys, signatures, and metadata.\n\n## Prerequisites\n\n- [.NET 11 SDK](https://dotnet.microsoft.com/download/dotnet/11.0)\n- [MySQL](https://dev.mysql.com/downloads/)\n\n## Setup\n\n```bash\n# 1. Clone the repository\ngit clone https://github.com/TheSmallPixel/IOL-ECHAT.git\ncd ECHAT\n\n# 2. Restore NuGet packages\ndotnet restore ECHAT.slnx\n\n# 3. Build the solution\ndotnet build ECHAT.slnx\n\n# 4. Install EF Core tools (once, globally)\ndotnet tool install --global dotnet-ef\n\n# 5. Create/update the MySQL database (apply pending migrations)\ndotnet ef database update --project src/ECHAT.Server.App/ECHAT.Server.App.csproj\n\n# (Only when you change the model) generate a new migration\ndotnet ef migrations add AddSomethingNew --project src/ECHAT.Server.App/ECHAT.Server.App.csproj --output-dir Data/Migrations\n\n# Secrets: use .NET user-secrets in development (dev only)\n# JWT secret: dotnet user-secrets set \"Authentication:Jwt:Secret\" \"your-dev-secret\" --project src/ECHAT.Server.App\n# Google ClientSecret: dotnet user-secrets set \"Authentication:Google:ClientSecret\" \"your-google-secret\" --project src/ECHAT.Server.App\n# In production, use environment variables (Authentication__Jwt__Secret, Authentication__Google__ClientSecret, etc.)\n```\n\n## Running\n\n```bash\n# Start the server (API + Blazor WASM client)\ndotnet run --project src/ECHAT.Server.App\n```\n\n## Tests\n\n```bash\n# Run all tests\ndotnet test ECHAT.slnx\n```\n\n## Coverage\n\n```bash\ndotnet tool install -g dotnet-reportgenerator-globaltool\ndotnet test --settings coverage.runsettings --collect:\"XPlat Code Coverage\" --results-directory ./coverage\nreportgenerator -reports:coverage/**/coverage.cobertura.xml -targetdir:coverage/report -reporttypes:\"Html;TextSummary\"\n```\n\n## Solution structure\n\n```\nECHAT/\n├── src/\n│   ├── ECHAT.Models/           # DTOs, enums, interfaces (zero dependencies)\n│   ├── ECHAT.Client.Core/      # Client logic (crypto, chain, outbox)\n│   ├── ECHAT.Server.Core/      # Server logic (pipeline, sequences, saga)\n│   ├── ECHAT.Client.App/       # Blazor WASM PWA\n│   └── ECHAT.Server.App/       # ASP.NET Core API + EF Core + MySQL + SignalR\n│\n└── tests/\n    ├── ECHAT.Client.Core.Tests/\n    ├── ECHAT.Server.Core.Tests/\n    ├── ECHAT.Integration.Tests/\n    └── js/                      # Node tests for the WebCrypto crypto (echat-crypto.mjs)\n```\n\n## Documentation\n\nThe full architecture documentation is available as a Docusaurus site, published to GitHub Pages:\n\n**https://TheSmallPixel.github.io/IOL-ECHAT/**\n\nTo run or build it locally:\n\n```bash\ncd docs-site\nnpm install\nnpm start        # local dev server\nnpm run build    # production build\nnpm run serve    # serve the production build\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthesmallpixel%2Fiol-echat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthesmallpixel%2Fiol-echat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthesmallpixel%2Fiol-echat/lists"}