Dự Án Tốt Nghiệp

# ---- Stage 1: Build ----
FROM node:20-alpine AS builder
WORKDIR /app

# Copy package files trước (tận dụng Docker layer cache)
COPY package*.json ./
RUN npm ci --omit=dev

COPY . .

# Generate Prisma client
RUN npx prisma generate

# ---- Stage 2: Production ----
FROM node:20-alpine AS runner
WORKDIR /app

# Non-root user — best practice security
RUN addgroup --system --gid 1001 nodejs
RUN adduser  --system --uid 1001 appuser

# Copy chỉ những gì cần cho production
COPY --from=builder --chown=appuser:nodejs /app/node_modules ./node_modules
COPY --from=builder --chown=appuser:nodejs /app/src        ./src
COPY --from=builder --chown=appuser:nodejs /app/prisma     ./prisma
COPY --from=builder --chown=appuser:nodejs /app/package.json ./

USER appuser

EXPOSE 3000
ENV NODE_ENV=production

CMD ["node", "src/index.js"]

version: '3.9'

services:
  api:
    build: .
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://postgres:password@db:5432/myapp
      - JWT_SECRET=${JWT_SECRET}
      - NODE_ENV=development
    depends_on:
      db:
        condition: service_healthy
    volumes:
      - ./src:/app/src  # Hot reload

  db:
    image: postgres:16-alpine
    environment:
      - POSTGRES_DB=myapp
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=password
    volumes:
      - db_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 5s
      retries: 5

volumes:
  db_data:

# === RAILWAY (Backend) ===
# Cài Railway CLI
npm install -g @railway/cli

# Login và deploy
railway login
railway init          # Link project
railway up            # Deploy lên cloud
railway vars set JWT_SECRET=your_secret_here
railway vars set NODE_ENV=production

# === VERCEL (Frontend) ===
# Deploy React/Next.js
npx vercel            # Theo hướng dẫn
npx vercel --prod     # Deploy production

# Set env vars
npx vercel env add VITE_API_URL production
# → Nhập: https://your-api.railway.app

# === RENDER (Backend alternative) ===
# Web Service → Connect GitHub repo
# Build Command: npm install && npx prisma generate
# Start Command: node src/index.js

name: CI/CD Pipeline

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4
      
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      
      - name: Install dependencies
        run: npm ci
      
      - name: Run ESLint
        run: npm run lint
      
      - name: Run tests
        run: npm test
        env:
          DATABASE_URL: "file:./test.db"
          JWT_SECRET: "test_secret_for_ci"
      
      - name: Check test coverage
        run: npm run test:coverage -- --passWithNoTests

  deploy:
    needs: test            # Chỉ deploy khi test pass
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'  # Chỉ deploy từ main branch

    steps:
      - uses: actions/checkout@v4
      
      - name: Deploy to Railway
        run: |
          curl -fsSL https://railway.app/install.sh | sh
          railway up --detach
        env:
          RAILWAY_TOKEN: ${{ secrets.RAILWAY_TOKEN }}

## 🚀 [Tên Dự Án](https://live-demo-url.vercel.app)

**Stack:** React · Express.js · Prisma · PostgreSQL · Tailwind CSS

**Mô tả:** [1-2 câu mô tả vấn đề dự án giải quyết và cho ai]

**Tính năng nổi bật:**
- [Tính năng 1 — dùng động từ: "Implements...", "Enables...", "Automates..."]
- [Tính năng 2]
- [Tính năng 3]

**Điểm kỹ thuật đáng chú ý:**
- JWT authentication với refresh token rotation
- Optimistic UI updates cho trải nghiệm mượt mà
- 85% test coverage với Jest + Supertest

[🔗 Live Demo](https://...) · [📦 Source Code](https://github.com/...)

# === KHỞI TẠO REPO ===
git init
echo "node_modules/\ndist/\n.env\n*.db\ncoverage/" > .gitignore
git add .gitignore README.md
git commit -m "chore: initial project setup"

# Tạo branch strategy:
# main     — production code (protected, chỉ merge qua PR)
# develop  — staging/integration
# feature/ — feature branches
# fix/     — hotfix branches

git checkout -b develop
git push origin develop

# === KHI LÀM TÍNH NĂNG MỚI ===
git checkout develop
git pull origin develop
git checkout -b feature/user-authentication

# Làm việc... commit thường xuyên
git add src/controllers/authController.js
git commit -m "feat(auth): add JWT register and login endpoints"

git add tests/integration/auth.test.js
git commit -m "test(auth): add integration tests for register/login"

# Push và tạo Pull Request
git push origin feature/user-authentication
# Vào GitHub → Create Pull Request → Review → Merge vào develop

# === COMMIT MESSAGE CONVENTION (Conventional Commits) ===
# feat:     Tính năng mới
# fix:      Sửa bug
# docs:     Cập nhật documentation
# style:    Format code (không thay đổi logic)
# refactor: Tái cấu trúc code
# test:     Thêm hoặc sửa tests
# chore:    Cài dependency, cấu hình tool

# Ví dụ commit messages tốt:
git commit -m "feat(notes): add pinned notes sorting to GET /api/notes"
git commit -m "fix(auth): prevent user enumeration in login endpoint"
git commit -m "refactor(db): extract Prisma client to singleton module"
git commit -m "docs: update API reference with new endpoints"

## Pre-Deploy Checklist

### Security
- [ ] JWT_SECRET đủ mạnh (min 32 chars, random)
- [ ] Passwords được hash với bcrypt (salt rounds >= 12)
- [ ] Không có credentials trong code (dùng .env)
- [ ] .env file trong .gitignore
- [ ] CORS configured đúng (không dùng * trong production)
- [ ] Rate limiting cho auth endpoints
- [ ] helmet() middleware bật

### Code Quality
- [ ] ESLint pass với 0 errors
- [ ] Tất cả tests pass (npm test)
- [ ] Không có console.log debug còn sót
- [ ] Error messages không expose stack trace

### Database
- [ ] Production database là PostgreSQL (không phải SQLite)
- [ ] Migrations chạy thành công
- [ ] Database backup strategy

### Frontend
- [ ] Build thành công (npm run build)
- [ ] Environment variables với prefix VITE_ đúng
- [ ] Loading states cho tất cả API calls
- [ ] Error messages thân thiện với user

### Documentation
- [ ] README có installation instructions đầy đủ
- [ ] API endpoints documented (Swagger hoặc Markdown)
- [ ] .env.example file (không có values thực tế)

# 🚀 Tên Dự Án

[![CI/CD](https://github.com/username/repo/actions/workflows/ci.yml/badge.svg)](...)
[![Coverage](https://codecov.io/gh/username/repo/badge.svg)](...)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](...)

> Mô tả ngắn gọn, súc tích về app (1-2 câu)

## 🎯 Demo

🔗 **Live:** https://your-app.vercel.app
🎥 **Video:** [Xem demo 2 phút](https://loom.com/...)
📸 **Screenshots:**

![screenshot](docs/screenshot.png)

## ✨ Tính Năng

- ✅ Đăng nhập / Đăng ký với JWT
- ✅ CRUD với real-time updates
- ✅ Responsive mobile-first
- ✅ Dark/Light mode

## 🛠 Tech Stack

**Frontend:** React 18, TypeScript, Tailwind CSS, Vite
**Backend:** Node.js, Express, Prisma ORM, PostgreSQL
**DevOps:** GitHub Actions CI/CD, Vercel, Railway

## 🚀 Cài Đặt

```bash
# Clone
git clone https://github.com/username/repo.git

# Backend
cd backend && npm install
cp .env.example .env  # Fill in values
npx prisma migrate dev
npm run dev

# Frontend (tab mới)
cd frontend && npm install
npm run dev
```

## 📁 Cấu Trúc Project

```
├── frontend/       # React + Vite
│   ├── src/components/
│   └── src/pages/
└── backend/        # Express + Prisma
    ├── src/routes/
    └── src/middleware/
```

## 🤝 Contributing

PRs welcome! Xem [CONTRIBUTING.md](CONTRIBUTING.md)

## 📝 License

MIT © [Tên Của Bạn]