claude-flow-novice 1.2.1 → 1.3.1

package/examples/05-swarm-apps/rest-api-advanced/src/routes/product.routes.js

@@ -0,0 +1,276 @@
+const express = require('express');
+const router = express.Router();
+const { validationResult } = require('express-validator');
+const { authenticate, authorize } = require('../middleware/auth');
+const productController = require('../controllers/product.controller');
+const {
+  createProductValidation,
+  updateProductValidation,
+  productIdValidation,
+  searchProductsValidation,
+  addReviewValidation,
+  updateReviewValidation,
+  markReviewHelpfulValidation,
+  updateInventoryValidation,
+  bulkUpdateInventoryValidation,
+  uploadImagesValidation,
+} = require('../validators/product.validator');
+
+// Validation middleware
+const validate = (req, res, next) => {
+  const errors = validationResult(req);
+  if (!errors.isEmpty()) {
+    return res.status(400).json({ errors: errors.array() });
+  }
+  next();
+};
+
+/**
+ * @swagger
+ * components:
+ *   schemas:
+ *     Product:
+ *       type: object
+ *       properties:
+ *         id:
+ *           type: string
+ *         name:
+ *           type: string
+ *         description:
+ *           type: string
+ *         price:
+ *           type: number
+ *         category:
+ *           type: string
+ *         stock:
+ *           type: integer
+ *         images:
+ *           type: array
+ *           items:
+ *             type: string
+ *         isActive:
+ *           type: boolean
+ *         createdAt:
+ *           type: string
+ *           format: date-time
+ */
+
+/**
+ * @swagger
+ * /api/products:
+ *   get:
+ *     summary: Get all products
+ *     tags: [Products]
+ *     parameters:
+ *       - in: query
+ *         name: page
+ *         schema:
+ *           type: integer
+ *           default: 1
+ *       - in: query
+ *         name: limit
+ *         schema:
+ *           type: integer
+ *           default: 20
+ *       - in: query
+ *         name: search
+ *         schema:
+ *           type: string
+ *       - in: query
+ *         name: category
+ *         schema:
+ *           type: string
+ *       - in: query
+ *         name: minPrice
+ *         schema:
+ *           type: number
+ *       - in: query
+ *         name: maxPrice
+ *         schema:
+ *           type: number
+ *       - in: query
+ *         name: sort
+ *         schema:
+ *           type: string
+ *           enum: [price, -price, name, -name, createdAt, -createdAt]
+ *     responses:
+ *       200:
+ *         description: List of products
+ */
+router.get('/', searchProductsValidation, validate, productController.getProducts);
+
+/**
+ * @swagger
+ * /api/products/{id}:
+ *   get:
+ *     summary: Get product by ID
+ *     tags: [Products]
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema:
+ *           type: string
+ *     responses:
+ *       200:
+ *         description: Product details
+ *       404:
+ *         description: Product not found
+ */
+router.get('/:id', productIdValidation, validate, productController.getProduct);
+
+/**
+ * @swagger
+ * /api/products:
+ *   post:
+ *     summary: Create new product (admin only)
+ *     tags: [Products]
+ *     security:
+ *       - bearerAuth: []
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             required:
+ *               - name
+ *               - price
+ *               - category
+ *             properties:
+ *               name:
+ *                 type: string
+ *               description:
+ *                 type: string
+ *               price:
+ *                 type: number
+ *               category:
+ *                 type: string
+ *               stock:
+ *                 type: integer
+ *     responses:
+ *       201:
+ *         description: Product created successfully
+ */
+router.post('/', authenticate, authorize('admin'), createProductValidation, validate, productController.createProduct);
+
+/**
+ * @swagger
+ * /api/products/{id}:
+ *   put:
+ *     summary: Update product (admin only)
+ *     tags: [Products]
+ *     security:
+ *       - bearerAuth: []
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema:
+ *           type: string
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             properties:
+ *               name:
+ *                 type: string
+ *               description:
+ *                 type: string
+ *               price:
+ *                 type: number
+ *               category:
+ *                 type: string
+ *               stock:
+ *                 type: integer
+ *               isActive:
+ *                 type: boolean
+ *     responses:
+ *       200:
+ *         description: Product updated successfully
+ */
+router.put('/:id', authenticate, authorize('admin'), updateProductValidation, validate, productController.updateProduct);
+
+/**
+ * @swagger
+ * /api/products/{id}:
+ *   delete:
+ *     summary: Delete product (admin only)
+ *     tags: [Products]
+ *     security:
+ *       - bearerAuth: []
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema:
+ *           type: string
+ *     responses:
+ *       200:
+ *         description: Product deleted successfully
+ *       404:
+ *         description: Product not found
+ */
+router.delete('/:id', authenticate, authorize('admin'), productIdValidation, validate, productController.deleteProduct);
+
+/**
+ * @swagger
+ * /api/products/{id}/images:
+ *   post:
+ *     summary: Upload product images
+ *     tags: [Products]
+ *     security:
+ *       - bearerAuth: []
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema:
+ *           type: string
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         multipart/form-data:
+ *           schema:
+ *             type: object
+ *             properties:
+ *               images:
+ *                 type: array
+ *                 items:
+ *                   type: string
+ *                   format: binary
+ *     responses:
+ *       200:
+ *         description: Images uploaded successfully
+ */
+router.post('/:id/images', authenticate, authorize('admin'), uploadImagesValidation, validate, productController.uploadImages);
+
+// Additional routes
+router.get('/category/:category', productController.getProductsByCategory);
+router.get('/featured', productController.getFeaturedProducts);
+router.get('/popular', productController.getPopularProducts);
+router.get('/:id/related', productIdValidation, validate, productController.getRelatedProducts);
+
+// Review routes
+router.post('/:id/reviews', authenticate, addReviewValidation, validate, productController.addReview);
+router.put('/:id/reviews', authenticate, updateReviewValidation, validate, productController.updateReview);
+router.delete('/:id/reviews', authenticate, productIdValidation, validate, productController.deleteReview);
+router.post('/:productId/reviews/:reviewId/helpful', authenticate, markReviewHelpfulValidation, validate, productController.markReviewHelpful);
+
+// Inventory routes
+router.put('/:id/inventory', authenticate, authorize('admin'), updateInventoryValidation, validate, productController.updateInventory);
+router.put('/inventory/bulk', authenticate, authorize('admin'), bulkUpdateInventoryValidation, validate, productController.bulkUpdateInventory);
+router.get('/inventory/report', authenticate, authorize('admin'), productController.getInventoryReport);
+
+// Category routes
+router.get('/categories/list', productController.getCategories);
+
+// Image management
+router.delete('/:id/images/:imageId', authenticate, authorize('admin'), productController.deleteImage);
+
+// Export
+router.get('/export/data', authenticate, authorize('admin'), productController.exportProducts);
+
+module.exports = router;

package/examples/05-swarm-apps/rest-api-advanced/src/routes/user.routes.js

@@ -0,0 +1,280 @@
+const express = require('express');
+const router = express.Router();
+const userController = require('../controllers/user.controller');
+const { protect, authorize } = require('../middleware/auth');
+const { authValidators, validate } = require('../validators/auth.validator');
+
+/**
+ * @swagger
+ * /api/users:
+ *   get:
+ *     summary: Get all users
+ *     tags: [Users]
+ *     security:
+ *       - bearerAuth: []
+ *     parameters:
+ *       - in: query
+ *         name: page
+ *         schema:
+ *           type: integer
+ *           default: 1
+ *         description: Page number
+ *       - in: query
+ *         name: limit
+ *         schema:
+ *           type: integer
+ *           default: 10
+ *         description: Number of items per page
+ *       - in: query
+ *         name: sort
+ *         schema:
+ *           type: string
+ *           default: -createdAt
+ *         description: Sort order
+ *       - in: query
+ *         name: role
+ *         schema:
+ *           type: string
+ *           enum: [user, admin]
+ *         description: Filter by role
+ *       - in: query
+ *         name: isActive
+ *         schema:
+ *           type: boolean
+ *         description: Filter by active status
+ *       - in: query
+ *         name: isEmailVerified
+ *         schema:
+ *           type: boolean
+ *         description: Filter by email verification status
+ *       - in: query
+ *         name: search
+ *         schema:
+ *           type: string
+ *         description: Search in name and email
+ *     responses:
+ *       200:
+ *         description: List of users
+ *       401:
+ *         description: Unauthorized
+ *       403:
+ *         description: Forbidden - Admin access required
+ */
+router.get('/', protect, authorize('admin'), validate(authValidators.userQuery), userController.getAllUsers);
+
+/**
+ * @swagger
+ * /api/users/stats:
+ *   get:
+ *     summary: Get user statistics
+ *     tags: [Users]
+ *     security:
+ *       - bearerAuth: []
+ *     responses:
+ *       200:
+ *         description: User statistics
+ *       401:
+ *         description: Unauthorized
+ *       403:
+ *         description: Forbidden - Admin access required
+ */
+router.get('/stats', protect, authorize('admin'), userController.getUserStats);
+
+/**
+ * @swagger
+ * /api/users/change-password:
+ *   put:
+ *     summary: Change password
+ *     tags: [Users]
+ *     security:
+ *       - bearerAuth: []
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             required:
+ *               - currentPassword
+ *               - newPassword
+ *               - confirmPassword
+ *             properties:
+ *               currentPassword:
+ *                 type: string
+ *               newPassword:
+ *                 type: string
+ *                 minLength: 6
+ *               confirmPassword:
+ *                 type: string
+ *     responses:
+ *       200:
+ *         description: Password changed successfully
+ *       401:
+ *         description: Unauthorized or incorrect password
+ */
+router.put('/change-password', protect, validate(authValidators.changePassword), userController.changePassword);
+
+/**
+ * @swagger
+ * /api/users/change-email:
+ *   put:
+ *     summary: Change email address
+ *     tags: [Users]
+ *     security:
+ *       - bearerAuth: []
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             required:
+ *               - newEmail
+ *               - password
+ *             properties:
+ *               newEmail:
+ *                 type: string
+ *                 format: email
+ *               password:
+ *                 type: string
+ *     responses:
+ *       200:
+ *         description: Email changed successfully
+ *       400:
+ *         description: Email already in use
+ *       401:
+ *         description: Incorrect password
+ */
+router.put('/change-email', protect, validate(authValidators.changeEmail), userController.changeEmail);
+
+/**
+ * @swagger
+ * /api/users/{id}:
+ *   get:
+ *     summary: Get user by ID
+ *     tags: [Users]
+ *     security:
+ *       - bearerAuth: []
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema:
+ *           type: string
+ *         description: User ID
+ *     responses:
+ *       200:
+ *         description: User details
+ *       403:
+ *         description: Forbidden - Can only access own profile or admin required
+ *       404:
+ *         description: User not found
+ */
+router.get('/:id', protect, validate(authValidators.userId), userController.getUserById);
+
+/**
+ * @swagger
+ * /api/users/{id}:
+ *   put:
+ *     summary: Update user
+ *     tags: [Users]
+ *     security:
+ *       - bearerAuth: []
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema:
+ *           type: string
+ *         description: User ID
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             properties:
+ *               name:
+ *                 type: string
+ *               phone:
+ *                 type: string
+ *               address:
+ *                 type: object
+ *               avatar:
+ *                 type: string
+ *               role:
+ *                 type: string
+ *                 enum: [user, admin]
+ *                 description: Admin only
+ *               isActive:
+ *                 type: boolean
+ *                 description: Admin only
+ *     responses:
+ *       200:
+ *         description: User updated successfully
+ *       403:
+ *         description: Forbidden - Can only update own profile or admin required
+ *       404:
+ *         description: User not found
+ */
+router.put('/:id', protect, validate(authValidators.userId), validate(authValidators.updateProfile), userController.updateUser);
+
+/**
+ * @swagger
+ * /api/users/{id}:
+ *   delete:
+ *     summary: Delete user
+ *     tags: [Users]
+ *     security:
+ *       - bearerAuth: []
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema:
+ *           type: string
+ *         description: User ID
+ *     responses:
+ *       200:
+ *         description: User deleted successfully
+ *       403:
+ *         description: Forbidden - Can only delete own account or admin required
+ *       404:
+ *         description: User not found
+ */
+router.delete('/:id', protect, validate(authValidators.userId), userController.deleteUser);
+
+/**
+ * @swagger
+ * /api/users/{id}/activity:
+ *   get:
+ *     summary: Get user activity logs
+ *     tags: [Users]
+ *     security:
+ *       - bearerAuth: []
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema:
+ *           type: string
+ *         description: User ID
+ *       - in: query
+ *         name: page
+ *         schema:
+ *           type: integer
+ *           default: 1
+ *       - in: query
+ *         name: limit
+ *         schema:
+ *           type: integer
+ *           default: 50
+ *     responses:
+ *       200:
+ *         description: User activity logs
+ *       403:
+ *         description: Forbidden - Can only view own activity or admin required
+ */
+router.get('/:id/activity', protect, validate(authValidators.userId), userController.getUserActivity);
+
+module.exports = router;

package/examples/05-swarm-apps/rest-api-advanced/src/seeders/index.js

@@ -0,0 +1,30 @@
+const mongoose = require('mongoose');
+const seedProducts = require('./products.seeder');
+const seedOrders = require('./orders.seeder');
+
+async function runSeeders() {
+  try {
+    // Connect to database
+    await mongoose.connect(process.env.MONGODB_URI || 'mongodb://localhost:27017/rest-api-advanced');
+    console.log('Connected to MongoDB');
+    
+    console.log('\n========== Running Product Seeder ==========');
+    await seedProducts();
+    
+    console.log('\n========== Running Order Seeder ==========');
+    await seedOrders();
+    
+    console.log('\n========== All Seeders Completed ==========');
+    process.exit(0);
+  } catch (error) {
+    console.error('Seeding failed:', error);
+    process.exit(1);
+  }
+}
+
+// Run seeders if called directly
+if (require.main === module) {
+  runSeeders();
+}
+
+module.exports = { seedProducts, seedOrders, runSeeders };