面向全球中文《HUNTER×HUNTER》爱好者的非官方内容与交流网站。项目以一座美式西部酒吧作为叙事化门户：用户从酒吧门进入，在2.5D场景中与NPC对话，并由NPC进入资料库、念能力测试、投稿、讨论等标准功能页面。
当前状态：阶段1可运行骨架。酒吧场景和NPC将在阶段2实现。
- 分阶段混合社区：编辑内容为主体，用户可评论、收藏、投稿和纠错。
- 结构化资料库与专题文章并列为一等内容模型。
- 漫画为主线正典，同时明确记录1999动画、2011动画及其他材料差异。
- 首版采用可访问的2.5D酒吧场景；访客可进入，写操作和个人记录才要求登录。
- NPC使用确定性、配置驱动的对话图；业务逻辑不写进NPC。
- 首版为模块化单体：TypeScript、Next.js App Router、PostgreSQL。
- 试运行参考部署：GitHub + Vercel Hobby + Supabase Free。
- 代码采用 Apache-2.0；媒体资产、用户内容与第三方作品另行授权。
- 项目上下文
- 决策登记表
- 产品边界
- 核心用户旅程
- NPC与功能映射
- 系统总览
- 领域模型
- 模块边界
- 数据模型
- 安全与权限
- 部署方案
- 可观测性与恢复
- 质量门槛
- MVP交付路线
- 阶段1完成清单
- 阶段1环境接入手册
关键架构选择记录在 docs/adr 下。实现阶段的Pull Request必须遵守这些边界；若要改变已接受决策，应先新增或替代ADR。
需要Node.js 24 LTS、pnpm 11和兼容Docker Compose的容器运行时。
- 将
.env.example复制为.env.local。 - 执行
docker compose up -d postgres启动本地PostgreSQL。 - 执行
pnpm install --frozen-lockfile安装锁定依赖。 - 执行
pnpm db:migrate应用版本化迁移。 - 执行
pnpm dev启动网站。
可用的运行状态接口为/health/live和/health/ready。提交前执行pnpm quality；它会检查格式、Lint、严格类型、模块边界、测试、迁移和生产构建。