Tiến độ thi công
Website so sánh tiến độ thực tế với kế hoạch cho nhiều dự án xây dựng cùng lúc, để theo dõi và dự đoán trễ.
Kế hoạch lập từ BOQ hợp đồng; thực tế cập nhật từ công trường (khối lượng theo mặt bằng, ép cọc, nhân công, máy móc).
Chỉ phạm vi tiến độ — không có hồ sơ nghiệm thu, QAQC, đệ trình hay thanh toán. Chi tiết: xem CLAUDE.md.
App HTML (Gantt / mặt bằng / ép cọc / báo cáo) chạy trên Next.js + Vercel. Dữ liệu chung nằm trên MongoDB Atlas — một document một dự án.
Việc bạn làm trên Atlas
- mongodb.com/atlas → tạo cluster (M0 free được).
- Database Access → user/password, quyền
Read and write to any database.
- Network Access → Add IP
0.0.0.0/0 (Vercel serverless đổi IP).
- Connect → Drivers → copy URI
mongodb+srv://....
Chạy local
copy .env.example .env.local
Điền MONGODB_URI, AUTH_SECRET (openssl rand -base64 32), ADMIN_EMAIL / ADMIN_PASSWORD.
npm install
npm run seed
npm run dev
Mở http://localhost:3000 → đăng nhập admin. Ghi đè 3 JSON mẫu: npm run seed -- --reset.
Việc bạn làm trên Vercel
-
Import git repo (hoặc npx vercel).
-
Environment variables (Production + Preview):
MONGODB_URIMONGODB_DB = tiendoAUTH_SECRET (cùng giá trị local)AUTH_URL = https://<project>.vercel.app (phải có https://, không copy localhost)
-
Deploy. Chạy seed một lần từ máy bạn (đã trỏ URI Atlas): npm run seed.
Không đưa URI Mongo vào client. Không commit .env.local.
Vai trò
| Vai trò | Ý nghĩa |
|---|
| xem | Đọc, PDF, xuất JSON. Không lưu. |
| member | Nút “Vào mặt bằng” trên login, không nhập gì. Chỉ xem/sửa tab Mặt bằng (tick căn). Server chỉ ghi field done. |
| sửa | Lưu dự án được gán, tick mặt bằng. Không xóa dự án. |
| admin dự án / admin hệ thống | Xóa dự án; admin hệ thống vào /admin thêm user / cấp PIN. |
Hai người sửa cùng lúc: findOneAndUpdate theo rev — ai ghi khớp rev trước thì được, bản sau (rev cũ) bị bỏ, client im lặng nhận bản đã lưu. Không khóa, không hỏi ghi đè.
Cấu trúc giữ nguyên
Tiến_độ_thi_công_V15 (trial ver).html — bản gốc.src/assets/tien-do.html — bản chạy (gọi /api/projects thay claude.use('db')).Package 3.json / Package 4.json / Casa_Bonita_1.json — seed.
