{"id":25911377,"url":"https://github.com/copyleftdev/rc-tax-services","last_synced_at":"2026-04-21T03:32:46.299Z","repository":{"id":274381764,"uuid":"922722335","full_name":"copyleftdev/rc-tax-services","owner":"copyleftdev","description":"A minimal, high-performance property tax service and load test—built in just a couple nights as a middle finger to bloated “enterprise” solutions that have overcharged government agencies for decades.","archived":false,"fork":false,"pushed_at":"2025-01-26T23:48:52.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-10T05:40:23.351Z","etag":null,"topics":["hackathon-project","kiss-principle","performance","refactoring"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/copyleftdev.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":"2025-01-26T23:18:55.000Z","updated_at":"2025-01-26T23:50:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"30cf2ae1-bbfc-48c1-a6a7-f17dc16824a8","html_url":"https://github.com/copyleftdev/rc-tax-services","commit_stats":null,"previous_names":["copyleftdev/rc-tax-services"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/copyleftdev/rc-tax-services","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/copyleftdev%2Frc-tax-services","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/copyleftdev%2Frc-tax-services/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/copyleftdev%2Frc-tax-services/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/copyleftdev%2Frc-tax-services/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/copyleftdev","download_url":"https://codeload.github.com/copyleftdev/rc-tax-services/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/copyleftdev%2Frc-tax-services/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32075240,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-21T02:38:07.213Z","status":"ssl_error","status_checked_at":"2026-04-21T02:38:06.559Z","response_time":128,"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":["hackathon-project","kiss-principle","performance","refactoring"],"created_at":"2025-03-03T09:17:22.121Z","updated_at":"2026-04-21T03:32:46.294Z","avatar_url":"https://github.com/copyleftdev.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RC Tax Services\n\n**A minimal, high-performance property tax service and load test—built in just a couple nights as a middle finger to bloated “enterprise” solutions that have overcharged government agencies for decades.**\n\n## Overview\n\nMany government offices get saddled with overpriced, needlessly complex systems. Our goal: **prove** you can build a **lean, maintainable** microservice for property taxes (or similar use cases) in a matter of days—not months—while achieving **millisecond** response times under massive load.\n\nThis repository showcases:\n- A **Compute** service (handling property records + DB inserts)\n- An **Ingest** service (optional WebSocket-based pipeline)\n- A **Loadtest** service (Rust-based)  \n- An **alternative K6** script for advanced scenario-based testing\n\nAll coded swiftly to highlight that huge vendor solutions often **overpromise** and **underdeliver**, while simpler approaches can get the job done faster, cheaper, and more efficiently.\n\n---\n\n## Bloat vs. Lean (Mermaid Diagram)\n\nBelow is a **Mermaid** diagram comparing a typical **over-bloated** enterprise approach vs. **RC Tax Services**’ lean design:\n\n```mermaid\nflowchart LR\n\n  subgraph \"Typical Over-Bloated Stack\"\n    direction TB\n    A[\"Legacy Vendor\\nPortal UI\"] --\u003e B[\"Massive\\nService Bus\"]\n    B --\u003e C[\"Overly Complex\\nWorkflow Engine\"]\n    C --\u003e D[\"Large Java EE\\nMonolith or Dozens of JARs\"]\n    D --\u003e E[\"Heavy ESB /\\nIntegration Layer\"]\n    E --\u003e F[\"Complicated DB\\n(Expensive Licenses)\"]\n    F --\u003e G[\"Minimal Real Value\\nBut Big Price Tag\"]\n  end\n\n  subgraph \"RC Tax Services\"\n    direction TB\n    X[\"Simple Web UI\\n(Optional)\"] --\u003e Y[\"Lean Rust Service(s)\"]\n    Y --\u003e Z[\"Postgres DB\\n(Free \u0026 Straightforward)\"]\n    Z --\u003e L[\"Real Value in Days,\\nMillisecond Latencies\"]\n  end\n\n  A --- X\n```\n\n**What It Shows**:\n- **Over-Bloated**: A typical high-level architecture from big vendors, with a labyrinth of bus layers, huge licensable components, and multiple frameworks—leading to complex, slow, and overpriced solutions.  \n- **RC Tax Services**: A minimal approach—a Rust microservice or two, straightforward Postgres DB, optional Web UI or ingestion. Built in **days**, sub-10ms latencies under thousands of RPS.\n\n---\n\n## Why This Approach\n\n1. **Frustration with Bloat**  \n   Big corps keep delivering monstrous solutions to gov agencies at sky-high prices—often with slow UIs, countless layers, and minimal real optimization.  \n2. **Show, Don’t Tell**  \n   In a couple nights, we coded these services from scratch, achieving sub-10ms latencies and thousands of requests per second, on minimal hardware.  \n3. **Simplicity**  \n   Rust microservices + straightforward DB schema—no endless vendor “integration.”  \n4. **Scalability**  \n   Our K6 scripts ramp up to hundreds of Virtual Users and attempt 1,000+ RPS. The system soaks it easily with near-zero errors.\n\n---\n\n## Usage (Local)\n\n1. **Clone** the repo:\n   ```bash\n   git clone https://github.com/copyleftdev/rc-tax-services.git\n   cd rc-tax-services\n   ```\n\n2. **Run** via Docker Compose:\n   ```bash\n   docker compose build\n   docker compose up\n   ```\n   - **db** container: Postgres on port 5432  \n   - **compute** container: Microservice on port 8080  \n   - **ingest** container: WebSocket-based ingress on port 3000  \n   - **loadtest** container: A quick, integrated Rust-based load test.\n\n3. **Check** logs. You’ll see `compute` and `ingest` spin up, plus load test results if enabled.\n\n### K6 Testing\n\n- Install [k6](https://k6.io/docs/getting-started/installation/).  \n- Then run:\n  ```bash\n  cd loadtest/\n  BASE_URL=http://localhost:8080 k6 run k6_test.js\n  ```\n  - or if you want to push extreme concurrency:\n  ```bash\n  BASE_URL=http://localhost:8080 k6 run extremeLoadTest.js\n  ```\n- Observe latencies, RPS, error rates in console output.\n\n---\n\n## Recent Extreme Load Test Results\n\n**Example**: We ramped to 500 Virtual Users, then hammered 1,000 RPS:\n\n```\n=== LOADTEST RESULTS ===\nTotal Requests: 874,420\nRPS: ~2,428\nAvg Latency: ~2.71ms (p95 ~6.96ms)\nErrors: 0%\n```\n\nNo errors, sub-7ms 95th percentile—even at thousands of requests per second—**no meltdown** or big overhead.\n\n---\n\n## Key Takeaways\n\n1. **Lean \u003e Bloated**: A simpler microservice can handle high concurrency with minimal overhead.  \n2. **Fast Delivery**: Built in two nights—contrasting months-long vendor solutions.  \n3. **Cost**: Lower dev hours, minimal hardware, zero licensing nightmares.  \n4. **Performance**: Sub-10ms latencies for 95% of requests, scaling to thousands RPS.\n\n---\n\n## Disclaimer\n\n- **Prototype**: Not fully production-grade (no advanced auth, multi-region DB, etc.).  \n- **Scaling**: For truly massive traffic, add caching, replication, or advanced logic.  \n- **Real Data**: Adjust field definitions for real government/agency needs.\n\n---\n\n## Conclusion\n\n**rc-tax-services** is a **middle finger** to the idea that only huge, overpriced software can serve government agencies effectively. **Yes**, you can do better: simpler architecture, Rust or similarly efficient languages, direct Postgres usage, and thorough load testing for blazing-fast solutions on modest hardware—**in just days**.\n\nStop overpaying for bloated solutions. **Build something lean**, test thoroughly, and spare your government agency from endless money pits.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcopyleftdev%2Frc-tax-services","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcopyleftdev%2Frc-tax-services","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcopyleftdev%2Frc-tax-services/lists"}