admin/goodgo-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: fix Next.js 14→15 version refs, add libs to CLAUDE.md

Browse Source 
- Update stale Next.js 14 references to 15 in audit docs
- Add libs/ai-services and libs/mcp-servers to CLAUDE.md project structure

Resolves TEC-2259

Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
Ho Ngoc Hai
2026-04-16 04:05:39 +07:00
parent ea5d4af30c
commit baaeb56849
4 changed files with 18 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
CLAUDE.md
View File

@@ -15,8 +15,9 @@ pnpm dev # Start all apps (API :3001, Web :3000)
## Architecture
- **apps/api** — NestJS backend (CQRS, DDD, clean architecture)
- **apps/web** — Next.js 14 frontend (App Router, Tailwind, Zustand)
- **libs/mcp-servers** — MCP tool server library
- **apps/web** — Next.js 15 frontend (App Router, Tailwind, Zustand)
- **libs/ai-services** — Python FastAPI AI/ML services (AVM, content moderation, NLP)
- **libs/mcp-servers** — MCP tool server library (property search, analytics, valuation)
- **prisma/** — Schema, migrations, seed scripts
- **e2e/** — Playwright E2E tests (API + Web projects)
@@ -35,7 +36,7 @@ pnpm dev # Start all apps (API :3001, Web :3000)
- **Runtime**: Node.js >= 22, pnpm 10
- **Backend**: NestJS, Prisma ORM, PostgreSQL 16 + PostGIS, Redis
- **Frontend**: Next.js 14, React 18, Tailwind CSS 3, Zustand, Mapbox GL
- **Frontend**: Next.js 15, React 18, Tailwind CSS 3, Zustand, Mapbox GL
- **Testing**: Vitest (unit), Playwright (E2E)
- **CI**: GitHub Actions (lint → typecheck → test → build)
@@ -63,6 +64,14 @@ apps/api/src/modules/
Each module follows DDD layers: `domain/` → `application/` → `infrastructure/` → `presentation/`.
## Project Structure (Libs)
```
libs/
ai-services/ — Python FastAPI AI/ML services (AVM, content moderation, NLP)
mcp-servers/ — MCP tool server library (property search, analytics, valuation)
```
## Database
- PostgreSQL 16 with PostGIS extension for geospatial queries

6
docs/audits/AUDIT_INDEX.md
View File

@@ -33,7 +33,7 @@
### ✅ 3. Apps/Web Frontend
- **File**: COMPREHENSIVE_AUDIT_2026-04-11.md, Section 3
- **Coverage**: 28 routes across 4 layout groups, 66 components, 16,568 LOC
- **Findings**: Full Next.js 14 implementation, limited unit tests (6 only)
- **Findings**: Full Next.js 15 implementation, limited unit tests (6 only)
### ✅ 4. Prisma Database Layer
- **File**: COMPREHENSIVE_AUDIT_2026-04-11.md, Section 4
@@ -115,7 +115,7 @@ Git Commits: 203
1. ✅ Mature DDD + CQRS architecture
2. ✅ 76K LOC of real implementation
3. ✅ 745+ test files (229 API, 31 E2E)
4. ✅ Modern tech stack (NestJS 11, Next.js 14, PostgreSQL 16)
4. ✅ Modern tech stack (NestJS 11, Next.js 15, PostgreSQL 16)
5. ✅ Strong DevOps (Docker, K8s, GitHub Actions)
6. ✅ Excellent documentation (89 docs + 81 audits)
7. ✅ Type-safe TypeScript (strict mode)
@@ -208,7 +208,7 @@ Git Commits: 203
| Layer | Technology | Version |
|-------|-----------|---------|
| Backend | NestJS | 11 |
| Frontend | Next.js | 14 |
| Frontend | Next.js | 15 |
| Runtime | Node.js | 22+ |
| Database | PostgreSQL | 16 + PostGIS 3.4 |
| Search | Typesense | 27 |

2
docs/audits/AUDIT_INDEX_ROOT.md
View File

@@ -207,7 +207,7 @@ This audit overview with:
| Layer | Technology | Version | Status |
|-------|-----------|---------|--------|
| Backend | NestJS | 11 | ✅ Latest |
| Frontend | Next.js | 14 | ✅ LTS |
| Frontend | Next.js | 15 | ✅ Latest |
| Database | PostgreSQL | 16 | ✅ Latest |
| Search | Typesense | 27 | ✅ Current |
| Cache | Redis | 7 | ✅ Current |

4
docs/audits/FRONTEND_EXPLORATION.md
View File

@@ -1,9 +1,9 @@
# GoodGo Platform Frontend Exploration Report
## apps/web (Next.js 14 with App Router)
## apps/web (Next.js 15 with App Router)
**Date:** April 9, 2026
**Status:** Pre-i18n (No existing i18n setup detected)
**Next.js Version:** 14.2.0 | **React:** 18.3.0
**Next.js Version:** 15.5.14 | **React:** 18.3.0
**Primary Language:** Vietnamese (vi_VN)
---