# Personal Blog

Legacy full-stack personal website and admin playground.

This repository started primarily as a Go learning project. The goal was to get
comfortable with Go in a real application setup and to explore service
boundaries, Docker-based development, PostgreSQL, gRPC, protobuf code
generation, and admin CRUD flows.

Because of that history, the architecture is more complex than the actual
product needs. Some parts were intentionally over-engineered at the beginning to
learn how those patterns feel in practice. The current direction is to simplify
the codebase, dissolve unnecessary addon boundaries, and build a cleaner
successor version with Rust and a completely new interface.

## Current Architecture

- **frontend-shell** — Next.js application and UI shell.
- **backend-core** — Go backend for public and admin-facing routes.
- **services/auth-service** — standalone Go auth service, kept separate because
  it is still useful as an isolated service/gRPC experiment.
- **services/lib** — legacy shared Go helpers that are being folded back into
  the concrete services where they belong.
- **frontend-shell/addons** — legacy frontend addon modules that are being
  dissolved into the shell and replaced with local components and ShadCN-based
  primitives.

## Why It Looks Like This

The project currently sits between two phases:

1. The original experiment: split services, addon-style frontend modules, and
   generic CRUD helpers.
2. The cleanup phase: fewer boundaries, clearer ownership, simpler routing, and
   a more direct UI composition model.

The code is therefore useful as a snapshot of that transition, but it should not
be treated as the target architecture for future projects.

## Dev Setup

Copy and fill the env file:

```bash
cp personal-blog.env.example personal-blog.env
```

Start all services:

```bash
make dev
```

Common commands:

```bash
make dev ARGS="up --build"     # rebuild and start
make dev ARGS="up -d"          # detached
make dev ARGS="down"           # stop
make prod ARGS="up --build"    # production
```