afloresc/redis-clone

Purpose and Entry Points

GoCache is a Go 1.23+ Redis-compatible in-memory data server. It accepts RESP2 commands over TCP (default port 6380), supports Redis clients, and optionally persists or replicates data. Process startup is main.go; server lifecycle and per-connection handling are centered in internal/core/app.go.

Network Protocol and Dispatch

TCP connections are handled concurrently, decoded from RESP, and routed to command implementations. The router maps the Redis command surface to handlers; command responses are encoded back as RESP.

• internal/core/app.go

• internal/core/router.go

• internal/utils/resp.go

Command Execution Layer

The command package is the application-facing API over the store and cross-cutting services. CommandImpl/the command interface provide shared command context, while command-family files implement strings, collections, GEO, bitmaps, HyperLogLog, transactions, and pub/sub semantics.

• internal/command/command.go

• internal/command/string.go

• internal/command/zset.go

In-Memory Data and Expiration

The store is the authoritative mutable state, holding Redis-compatible typed values and protecting operations with sync.RWMutex. TTL management runs as a background expiry-cleanup concern and commands must observe expired-key semantics. This is the key concurrency boundary for normal command execution.

• internal/store/store.go

• internal/store/ttl.go

Transaction and Messaging State

Transactions queue commands for MULTI and execute/discard them under transaction rules, including WATCH state. Pub/sub maintains channel and pattern subscriptions and pushes asynchronous messages to subscribed clients, which differs from ordinary request/response command flow.

• internal/transaction/transaction.go

• internal/pubsub/pubsub.go

• internal/command/transaction.go

Durability, Capacity, and Replication

Persistence provides two independent durability paths: binary RDB snapshot save/load and append-only command logging with rewrite/fsync behavior. Eviction applies configured LRU/LFU/random/TTL policies when writes exceed memory limits. Replication manages master/slave support and is a boundary for propagating state beyond local memory.

• internal/persistence/rdb.go

• internal/persistence/aof.go

• internal/eviction/eviction.go

• internal/repl/repl.go

Configuration and Access Control

JSON-backed configuration controls network settings, databases, persistence, eviction, replication, and ACL enablement; runtime Redis CONFIG commands expose mutable settings. ACL/authentication establishes connection authorization before protected command access.

• internal/config/config.go

• internal/acl/acl.go

• internal/command/string.go

Deployment Runtime

The service is packaged as a standalone Go binary and can run in Docker/Compose. External integration is primarily TCP Redis clients (redis-cli and compatible libraries); persistence files are local runtime storage rather than a separate database service.

• Dockerfile

• docker-compose.yml

• main.go