Skip to content

Conversation

@devlasbe
Copy link
Owner

This pull request adds comprehensive documentation and workflow guides for the Open Franchise project, focusing on development, code quality, and project conventions. The new files provide detailed instructions for creating, reviewing, and maintaining code in both the frontend (Next.js) and backend (NestJS), as well as for handling database, build, and lint processes. The documentation also introduces specialized agents to automate planning, code writing, and code reviewing tasks.

Key changes include:

Agent Workflow & Roles

  • Added planner, code-expert, and code-reviewer agent guides, defining their roles, workflows, and checklists for automated feature planning, TypeScript code writing, and code review/quality improvement. These agents enforce project conventions and automate parts of the development lifecycle. [1] [2] [3]

Backend & Frontend Development Guides

  • Added detailed guides for creating new NestJS modules (new-module.md) and Next.js components (new-component.md), including directory structure, code templates, and best practices for both server and client components. [1] [2]
  • Introduced a comprehensive DTO (Data Transfer Object) guide for NestJS, including templates, validation rules, and controller usage examples to standardize API contracts.

Project Command Documentation

  • Provided clear documentation for essential project commands:
    • Development server startup (dev.md)
    • Production build and Dockerization (build.md)
    • Database management with Prisma (db.md)
    • Linting and code formatting (lint.md)
    • API TypeScript type generation from Swagger (api-types.md)
      [1] [2] [3] [4] [5]

These additions ensure that all contributors have access to standardized, step-by-step guides for every major development and maintenance task, improving onboarding, code consistency, and overall project quality.

claude and others added 19 commits January 21, 2026 09:58
- Add root CLAUDE.md with project overview and common conventions
- Add apps/web/CLAUDE.md with Next.js specific patterns
- Add apps/server/CLAUDE.md with NestJS specific patterns
- Add .claude/rules for TypeScript, Next.js, NestJS, and Git conventions
- Add .claude/commands for common development tasks

Co-Authored-By: Claude <noreply@anthropic.com>
- Add DTO skill with comprehensive guide for backend DTOs
- Add Swagger skill for API documentation best practices
- Add code-expert agent for code writing standards
- Add planning-expert agent for feature development planning
- Update server CLAUDE.md with strict any prohibition and DTO requirements

Co-Authored-By: Claude <noreply@anthropic.com>
- Simplify apps/server/CLAUDE.md to project-specific info only
- Streamline .claude/rules/nestjs.md with core rules
- Reference detailed guides in .claude/commands/
- Reduce 798 lines of duplicate content to 130 lines

Co-Authored-By: Claude <noreply@anthropic.com>
- Introduced a new planner agent for structured implementation planning
- Updated code-expert agent with detailed coding standards and TypeScript guidelines
- Added mandatory planning steps to ensure systematic development
- Revised CLAUDE.md to emphasize the importance of DTOs and Swagger documentation
- Removed outdated planning-expert agent to streamline documentation

Co-Authored-By: Claude <noreply@anthropic.com>
- Fix agent tools: change Shell to Bash in code-expert and code-reviewer
- Add frontmatter description to all command files for slash commands
- Expand settings.local.json permissions for development workflows
- Remove duplicate AGENTS.md files (consolidated into CLAUDE.md)

https://claude.ai/code/session_01Ao3D3rLSAxxHV26R5XtVbp
docs: Add comprehensive Claude agent guides and project documentation
- Move lib/utils.ts to utils/cn.ts
- Move lib/fetchService.ts to utils/api.ts
- Remove redundant services/defaultUrl.ts
- Update all import paths from @/lib to @/utils
- Update components.json aliases
- Update AGENTS.md documentation

https://claude.ai/code/session_017kLXLLpBtmZ1xLQf6x6F9m
…ure-XlMQ5

Refactor: Reorganize utility files from lib to utils directory
- 환경 상수를 constants 모듈로 중앙화
- fetchService에서 서버 에러 메시지 파싱 개선
- robots.ts, sitemap.xml에서 constants 사용

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- checkbox, dialog, label, switch, tabs 컴포넌트 추가
- radix-ui 의존성 추가

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Comment 모델 추가 (브랜드별 댓글, 답글, 소프트 삭제)
- BlockedIp 모델 추가 (CIDR 지원, 만료일 설정)
- 댓글 API: 조회, 작성, 삭제 (비밀번호 확인)
- IP 차단 API: CRUD (관리자 전용)
- Trust Proxy 활성화 (클라이언트 IP 추적)
- PrismaPg 어댑터로 마이그레이션

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- 브랜드 상세 페이지에 댓글 섹션 추가
- 댓글 작성/답글/삭제 UI 구현
- 페이지네이션 및 IP 차단 다이얼로그
- CommentService 추가

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- 관리자 페이지 탭 구조로 리팩토링
- DataCollectionTab: 데이터 수집
- CommentsTab: 댓글 관리 (검색, 강제 삭제)
- BlockedIpsTab: IP 차단 관리 (CIDR, 만료일)
- BrandBlockTab: 브랜드별 차단
- AdminService에 댓글/IP 차단 API 추가

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- 댓글/IP 차단 기능 문서화
- 새 API 엔드포인트 추가
- 서비스 클래스 및 컴포넌트 구조 업데이트
- AGENTS.md 삭제 (CLAUDE.md로 통합)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@vercel
Copy link

vercel bot commented Jan 24, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
open-franchise-web Ready Ready Preview, Comment Jan 24, 2026 7:17pm

- Added new Bash commands to settings.local.json for Docker operations.
- Updated Dockerfile to copy node_modules for pnpm symbolic link resolution.
- Changed CMD in Dockerfile to point directly to server.js.
- Set dynamic export in sitemap route for runtime generation.
@devlasbe devlasbe merged commit 690b0fd into main Jan 24, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants