hyunwook-tech

# hyunwook-tech

AI Summary

Purpose:

• Repo-specific memory for hyunwook.tech, the personal portfolio, wiki, docs,

and backend API monorepo.

Key points:

• Local path is /Users/james-home/project/hyunwook.tech on home_mac.
• The README describes it as a personal portfolio + wiki + document system

monorepo.

• Main surfaces are Next.js apps for tech blog, portfolio, wiki, and docs, plus

a Go portfolio-api and Docker Compose infrastructure.

• Verification commands include root npm run lint, root npm run smoke, and

app-level npm run build commands. Some commands require local services.

Relevant when:

• Updating the personal portfolio/wiki/docs platform.
• Generating portfolio or onboarding material about the personal platform.

Do not read full document unless:

• You need app ports, package commands, or service layout.

Linked documents:

• ai/workspace/repos.md
• ai/wiki/projects/personal-portfolio-platform.md
• ai/worklog/index.md

Repo Info

• Repo ID: hyunwook-tech
• Main branch: main
• Local path: /Users/james-home/project/hyunwook.tech on home_mac
• Remote: [email protected]:hw-me/hyunwook.tech.git
• Latest observed commit: 74c7060 2026-06-12 chore: rename resume portfolio public URL
• Public resume-style portfolio primary URL: https://resume.hshouse.xyz/
• Backward-compatible alias: https://portfolio.hshouse.xyz/
• Technical portfolio detail site: https://portfolio-equ.pages.dev/

Common Commands

npm run lint
npm run smoke
npm --workspace=apps/hw-web run dev
npm --workspace=apps/hw-portfolio run dev
npm --workspace=apps/hw-docs run dev
npm --workspace=apps/hw-wiki run dev
npm --workspace=apps/portfolio-api run build
docker compose up -d

Architecture Notes

• apps/hw-web: Tech blog app (next dev, port 3000 in README).
• apps/hw-portfolio: portfolio app (next dev, port 3001).
• apps/hw-wiki: wiki app (next dev, port 3002).
• apps/hw-docs: docs app (next dev, port 3003), with Tiptap-related

editor dependencies.

• apps/portfolio-api: Go backend API with PostgreSQL, Redis, MongoDB, JWT,

and YAML dependencies.

• apps/shared: shared auth/wiki/portfolio exports for the Next.js apps.
• infrastructure: DB, Redis, MongoDB, and Nginx configuration.
• The root scripts/smoke-test.sh checks host-based routing and optional

login-cookie behavior through the gateway.

Known Pitfalls

• Some smoke checks require local DNS/Host-header behavior and running gateway

services.

• README includes local port assumptions; public deployment state is

Needs confirmation.

• Role, production uptime, user count, traffic, and portfolio conversion metrics

are Needs confirmation.

• Do not copy .env or private configuration into the wiki.

Current Work

• Personal project portfolio/onboarding material is being generated from this

repo as one of three ~/hw/project repositories.

Decisions

• Frame this project as the personal portfolio/wiki/docs platform, not as the

same static human/portfolio output in llm-wiki.

• Use Needs confirmation for unverified deployment status and metrics.

Open Questions

• Public URL and production deployment status: resume.hshouse.xyz and portfolio.hshouse.xyz both route to apps/hw-portfolio on tech-portfolio-web; verified 2026-06-12.
• Whether apps/hw-docs is currently used as the primary docs UI: Needs confirmation.
• Whether apps/hw-wiki is still active or superseded by llm-wiki: Needs confirmation.

Portfolio / resume writing rules

• Before changing production resume-style portfolio content, back up source and MongoDB data.
• Resume-style portfolio content is DB-backed by MongoDB tech_db.resumes; do not assume source-file edits alone update production content.
• Use https://github.com/epoko77-ai/im-not-ai and humanizer-style anti-AI review before publishing Korean resume/portfolio copy.
• Preserve verified facts and mark unverified metrics, dates, roles, and deployment claims as Needs confirmation.