添加ApiOperation

src/main/java/com/syjiaer/clinic/server/controller/charge/ChargeLogController.java

@@ -25,6 +25,7 @@ public class ChargeLogController extends BaseController {
     /**
      * 每日收费报表
      */
+    @ApiOperation("每日收费报表")
     @RequestMapping("/reportWithDays")
     public Result<List<RetailOrderDailyChargingReportVo>> dailyChargingReport() {
         String startDateStr = parmsUtil.getString("startDate", "请选择开始时间");
@@ -41,6 +42,7 @@ public class ChargeLogController extends BaseController {
      * 病人付费记录
      * @return
      */
+    @ApiOperation("病人付费记录")
     @RequestMapping("/listByPatientId")
     public Result<List<ChargeOrder>> listByPatientId() {
         Integer patientId = parmsUtil.getInteger("patientId");
@@ -62,6 +64,7 @@ public class ChargeLogController extends BaseController {
     /**
      * 获取收退费记录
      */
+    @ApiOperation("获取收退费记录")
     @RequestMapping("listByDatetime")
     public Result<List<ChargeLog>> listByDatetime(){
         String begin = parmsUtil.getString("beginTime","开始时间为空");

src/main/java/com/syjiaer/clinic/server/controller/charge/ChargeOrderController.java

@@ -15,6 +15,7 @@ import com.syjiaer.clinic.server.entity.charge.vo.ChargeDetailVo;
 import com.syjiaer.clinic.server.entity.charge.vo.ChargeOrderPrintVo;
 import com.syjiaer.clinic.server.service.charge.ChargeService;
 import com.syjiaer.clinic.server.service.charge.vo.RetailOrderDailyChargingReportVo;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -32,6 +33,7 @@ public class ChargeOrderController extends BaseController {
      * @return
      */
     @RecordCommonLog(operation = "生成订单")
+    @ApiOperation("保存收费订单")
     @RequestMapping("/save")
     public Result<Object> save() {
         ChargeSaveDto dto = parmsUtil.getObject("data", ChargeSaveDto.class);
@@ -41,6 +43,7 @@ public class ChargeOrderController extends BaseController {
     /**
      * 根据诊断code和状态获取诊断信息
      */
+    @ApiOperation("根据诊断code和状态获取诊断信息")
     @RequestMapping("/getByDiagnosisCode")
     public Result<ChargeOrder> getByDiagnosisCode() {
         String diagnosisCode = parmsUtil.getString("diagnosisCode","诊断code不能为空");
@@ -53,6 +56,7 @@ public class ChargeOrderController extends BaseController {
      * 根据code查询订单详情
      * @return
      */
+    @ApiOperation("根据code查询订单详情")
     @RequestMapping("/getByCode")
     public Result<ChargeDetailVo> getByCode() {
         String code = parmsUtil.getString("code");
@@ -62,6 +66,7 @@ public class ChargeOrderController extends BaseController {
     /**
      * 根据订单号获取订单详情 小票打印用
      */
+    @ApiOperation("根据订单号获取订单详情,小票打印用")
     @RequestMapping("getPrintInfoByCode")
     public Result<ChargeOrderPrintVo> getPrintInfoByCode() {
         String code = parmsUtil.getString("code", "订单号不能为空");
@@ -71,6 +76,7 @@ public class ChargeOrderController extends BaseController {
      * 查询list 只有订单信息
      * @return
      */
+    @ApiOperation("查询list 只有订单信息")
     @RequestMapping("/list")
     public Result<Page<ChargeOrder>> list() {
         ChargeQuery chargeQuery = parmsUtil.getObject("query", ChargeQuery.class);
@@ -80,6 +86,7 @@ public class ChargeOrderController extends BaseController {
     /*
         查询list 带详情
      */
+    @ApiOperation("查询list 带详情")
     @RequestMapping("/listWithDetail")
     public Result<Page<ChargeDetailVo>> listWithDetail() {
         ChargeQuery chargeQuery = parmsUtil.getObject("query", ChargeQuery.class);
@@ -89,6 +96,7 @@ public class ChargeOrderController extends BaseController {
      * 完成订单
      * @return
      */
+    @ApiOperation("完成订单")
     @RecordCommonLog(operation = "完成订单")
     @RequestMapping("/complete")
     public Result<Object> complete() {

src/main/java/com/syjiaer/clinic/server/controller/charge/SocialController.java

@@ -6,6 +6,7 @@ import com.syjiaer.clinic.server.common.api.output.OM2207A;
 import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.service.charge.ChargeService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -19,6 +20,7 @@ public class SocialController extends BaseController {
      * 医保预支付
      * @return
      */
+    @ApiOperation("医保预支付")
     @RequestMapping("/prePay")
     public Result<OM2206A> prePay(){
         String changeOrderCode = parmsUtil.getString("changeOrderCode");
@@ -32,6 +34,7 @@ public class SocialController extends BaseController {
      * 医保真实支付
      * @return
      */
+    @ApiOperation("医保真实支付")
     @RecordCommonLog(operation = "医保收费")
     @RequestMapping("/realPay")
     public Result<OM2207A> realPay(){
@@ -49,6 +52,7 @@ public class SocialController extends BaseController {
      * 医保上传支付明细
      * @return
      */
+    @ApiOperation("医保上传支付明细")
     @RecordCommonLog(operation = "上传医保费用明细")
     @RequestMapping("/upload")
     public Result<Object> upload() {

src/main/java/com/syjiaer/clinic/server/controller/common/AuthController.java

@@ -6,6 +6,7 @@ import com.syjiaer.clinic.server.common.config.Config;
 import com.syjiaer.clinic.server.common.util.RsaUtil;
 import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -16,6 +17,7 @@ public class AuthController extends BaseController {
     @Autowired
     private Config config;
     @RequestMapping("set")
+    @ApiOperation("设置认证信息")
     @NoAuthCheck
     public Result<JSONObject> set() {
         String ciphertext = parmsUtil.getString("ciphertext", "请输入密文");
@@ -24,6 +26,7 @@ public class AuthController extends BaseController {
         return success();
     }
     @RequestMapping("get")
+    @ApiOperation("获取认证信息")
     @NoAuthCheck
     public Result<String> get() {
         String cert=config.get("common","cert");

src/main/java/com/syjiaer/clinic/server/controller/common/CommonConfigController.java

@@ -7,6 +7,7 @@ import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.entity.common.CommonConfig;
 import com.syjiaer.clinic.server.service.common.CommonConfigService;
 import com.syjiaer.clinic.server.service.common.FileService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -32,11 +33,13 @@ public class CommonConfigController extends BaseController {
     private Config config;
 
     @RequestMapping("list")
+    @ApiOperation("查询配置信息")
     public Result<Object> list() {
         return success(commonConfigService.list());
     }
 
     @RequestMapping("getAll")
+    @ApiOperation("查询所有配置信息")
     public Result<Object> getAll() {
         List<CommonConfig> list = commonConfigService.list();
         Map<String, String> map = new HashMap<>();
@@ -47,6 +50,7 @@ public class CommonConfigController extends BaseController {
     }
     @RecordCommonLog(operation = "修改配置信息")
     @RequestMapping("edit")
+    @ApiOperation("修改配置信息")
     public Result<Object> edit() {
         Map<String, Object> parms = getParms();
         for (String key : parms.keySet()) {
@@ -60,6 +64,7 @@ public class CommonConfigController extends BaseController {
 
 
     @RequestMapping("get")
+    @ApiOperation("根据key获取配置信息")
     public Result<Object> get() {
         String key = parmsUtil.getString("key", "请输入key");
         return success(commonConfigService.getOne(key));
@@ -71,6 +76,7 @@ public class CommonConfigController extends BaseController {
      * @return
      */
     @RecordCommonLog(operation = "修改打印机配置")
+    @ApiOperation("保存打印机配置")
     @RequestMapping("savePrinter")
     public Result<Object> savePrinter() {
         Map map = parmsUtil.getMap("printConfig");
@@ -86,6 +92,7 @@ public class CommonConfigController extends BaseController {
      * @return
      */
     @RequestMapping("getPrintConfig")
+    @ApiOperation("获取打印机配置")
     public Result<Map<String,String>> getPrintConfig() {
         Map<String,String> map = new HashMap<>();
         map.put("printName", config.get("print", "printerName"));

src/main/java/com/syjiaer/clinic/server/controller/common/CommonLogController.java

@@ -6,6 +6,7 @@ import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.entity.common.CommonLog;
 import com.syjiaer.clinic.server.entity.common.dto.CommonLogQuery;
 import com.syjiaer.clinic.server.service.common.CommonLogService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -18,6 +19,7 @@ public class CommonLogController extends BaseController {
 
 
     @RequestMapping("list")
+    @ApiOperation("查询操作日志")
     public Result<Page<CommonLog>> list() {
         CommonLogQuery query = parmsUtil.getObject("query", CommonLogQuery.class);
         return success(commonLogService.pageList(query));

src/main/java/com/syjiaer/clinic/server/controller/common/FileController.java

@@ -8,6 +8,7 @@ import com.syjiaer.clinic.server.common.util.StringUtil;
 import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.service.common.FileService;
+import io.swagger.annotations.ApiOperation;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.core.io.Resource;
@@ -37,12 +38,14 @@ public class FileController extends BaseController {
     @Autowired
     private CacheUtil cacheUtil;
     @RequestMapping("/upload")
+    @ApiOperation("上传文件")
     @NoAuthCheck
     public Result<?> handleFileUpload(@RequestParam("file") MultipartFile file) {
 
         return success(fileService.uploadFile(file));
     }
     @RequestMapping("/getImage/{fileName}")
+    @ApiOperation("获取图片")
     @NoAuthCheck
     public  ResponseEntity<Resource> getImage(@PathVariable String fileName) {
         try  {
@@ -55,6 +58,7 @@ public class FileController extends BaseController {
     }
 
     @RequestMapping("/download/{token}")
+    @ApiOperation("下载文件")
     @NoAuthCheck
     public ResponseEntity<Resource> download(@PathVariable String token){
 
@@ -76,6 +80,7 @@ public class FileController extends BaseController {
     }
 
     @RequestMapping("/uploadToTemp")
+    @ApiOperation("上传临时文件")
     @NoAuthCheck
     public String uploadToTemp(MultipartFile file) {
         try {

src/main/java/com/syjiaer/clinic/server/controller/common/ManagerUserController.java

@@ -5,6 +5,7 @@ import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.entity.manager.ManagerUser;
 import com.syjiaer.clinic.server.service.common.ManagerUserService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -29,6 +30,7 @@ public class ManagerUserController extends BaseController {
 
 
     @PostMapping("login")
+    @ApiOperation("登录")
     @NoAuthCheck
     public Result<String> login() {
         Map<String, Object> parms = getParms();
@@ -39,6 +41,7 @@ public class ManagerUserController extends BaseController {
 
 
     //验证token
+    @ApiOperation("验证token")
     @PostMapping("verify")
     public Result<ManagerUser> verify() {
         return success(managerUserService.verify());
@@ -48,6 +51,7 @@ public class ManagerUserController extends BaseController {
      * 所有人员信息
      * @return
      */
+    @ApiOperation("所有人员信息")
     @RequestMapping("list")
     public Result<List<ManagerUser>> list(){
         return success(managerUserService.list());

src/main/java/com/syjiaer/clinic/server/controller/common/SignController.java

@@ -5,6 +5,7 @@ import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.entity.manager.ManagerUserSign;
 import com.syjiaer.clinic.server.service.common.SignService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -17,6 +18,7 @@ public class SignController extends BaseController {
     private SignService signService;
 
     @RecordCommonLog(operation = "医保签到")
+    @ApiOperation("医保签到")
     @RequestMapping("/in")
     public Result<ManagerUserSign> in() {
         String mac = parmsUtil.getString("mac", "请输入mac地址");
@@ -25,6 +27,7 @@ public class SignController extends BaseController {
         return success(signResult);
     }
     @RecordCommonLog(operation = "医保签退")
+    @ApiOperation("医保签退")
     @RequestMapping("/out")
     public Result<String> out() {
         signService.out();

src/main/java/com/syjiaer/clinic/server/controller/diagnosis/DiagnosisController.java

@@ -14,6 +14,7 @@ import com.syjiaer.clinic.server.entity.patient.vo.SeeDoctorInfoVo;
 import com.syjiaer.clinic.server.service.diagnosis.CheckService;
 import com.syjiaer.clinic.server.service.diagnosis.DiagnosisService;
 import com.syjiaer.clinic.server.service.patient.PatientRegistrationService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -35,7 +36,8 @@ public class DiagnosisController extends BaseController {
      * 保存诊断
      * @return
      */
-    @RecordCommonLog(operation = "完成诊断。")
+    @RecordCommonLog(operation = "完成诊断")
+    @ApiOperation("保存诊断")
     @RequestMapping("/save")
     public Result<PatientRegistration> save() {
         DiagnosisDto saveDto = parmsUtil.getObject("data", DiagnosisDto.class);
@@ -52,7 +54,7 @@ public class DiagnosisController extends BaseController {
      * 查询患者病历
      * @return
      */
-
+    @ApiOperation("查询患者病历")
     @RequestMapping("/listByPatient")
     public Result<List<MedicalHistoryVo>> listByPatient() {
         Integer patientId = parmsUtil.getInteger("patientId", "患者不能为空");
@@ -63,6 +65,7 @@ public class DiagnosisController extends BaseController {
      *根据挂单号回显病历详情
      * @return
      */
+    @ApiOperation("根据挂单号回显病历详情")
     @RequestMapping("/getByRegisId")
     public Result<MedicalRecordVo> getByRegisId() {
         Integer regisId = parmsUtil.getInteger("regisId", "挂单id不能为空");
@@ -71,6 +74,7 @@ public class DiagnosisController extends BaseController {
     /**
      * 获取收费队列
      */
+    @ApiOperation("获取收费队列")
     @RequestMapping("/ChargeQueueList")
     public Result<Page<ChargeQueueVo>> ChargeQueueList() {
         ChargeQueueQuery query = parmsUtil.getObject("query", ChargeQueueQuery.class);
@@ -81,6 +85,7 @@ public class DiagnosisController extends BaseController {
     /**
      * 获取挂号信息
      */
+    @ApiOperation("获取挂号信息")
     @RequestMapping("/getRegistrationDetail")
     public Result<SeeDoctorInfoVo> getRegistrationDetail() {
         Integer regisId = parmsUtil.getInteger("regisId", "挂单id不能为空");
@@ -90,6 +95,7 @@ public class DiagnosisController extends BaseController {
     /**
      * 获取诊断信息
      */
+    @ApiOperation("获取诊断信息")
     @RequestMapping("/getByDiagnosisCode")
     public Result<MedicalRecordVo> getByDiagnosisCode() {
         String diagnosisCode = parmsUtil.getString("diagnosisCode", "诊断code不能为空");

src/main/java/com/syjiaer/clinic/server/controller/goods/GoodsCateController.java

@@ -5,6 +5,7 @@ import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.entity.goods.GoodsCate;
 import com.syjiaer.clinic.server.service.goods.GoodsCateService;
+import io.swagger.annotations.ApiOperation;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -32,6 +33,7 @@ public class GoodsCateController extends BaseController {
      * 获取商二级分类列表
      * 参数 type 商品一级类型
      */
+    @ApiOperation("根据type获取商品二级分类列表")
     @RequestMapping("list")
     public Result<List<GoodsCate>> list(){
         int type= parmsUtil.getInteger("type","类型不能为空");
@@ -42,6 +44,7 @@ public class GoodsCateController extends BaseController {
     /**
      * 获取所有的分类
      */
+    @ApiOperation("获取所有分类")
     @RequestMapping("getAllList")
     public Result<Map<Integer,List<GoodsCate>>> getAllList(){
         Map<Integer,List<GoodsCate>> resultMap=goodsCateService.listAll();
@@ -51,6 +54,7 @@ public class GoodsCateController extends BaseController {
      * 删除二级分类
      * 参数 id
      */
+    @ApiOperation("删除二级分类")
     @RecordCommonLog(operation = "删除分类")
     @RequestMapping("del")
     public Result del(){
@@ -63,6 +67,7 @@ public class GoodsCateController extends BaseController {
      * 保存二级分类
      * 参数 cateList
      */
+    @ApiOperation("保存二级分类")
     @RecordCommonLog(operation = "保存分类")
     @RequestMapping("save")
     public Result save(){

src/main/java/com/syjiaer/clinic/server/controller/goods/GoodsController.java

@@ -12,6 +12,7 @@ import com.syjiaer.clinic.server.entity.goods.dto.GoodsQuery;
 import com.syjiaer.clinic.server.entity.goods.vo.GoodsDetailVo;
 import com.syjiaer.clinic.server.entity.goods.vo.GoodsSearchVo;
 import com.syjiaer.clinic.server.service.goods.GoodsService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -40,6 +41,7 @@ public class GoodsController extends BaseController {
      * @return
      */
     @RecordCommonLog(operation = "商品建档或修改")
+    @ApiOperation("商品建档或修改")
     @RequestMapping("save")
     public Result<Object> save() {
 
@@ -80,6 +82,7 @@ public class GoodsController extends BaseController {
      * 商品重新初始化医保库存
      */
     @RecordCommonLog(operation = "商品重新初始化医保库存")
+    @ApiOperation("商品重新初始化医保库存")
     @RequestMapping("returnInit")
     public Result<Object> returnInit() {
         Integer goodId = parmsUtil.getInteger("id");
@@ -90,6 +93,7 @@ public class GoodsController extends BaseController {
     /**
      * 商品搜索 goods页搜索
      */
+    @ApiOperation("商品搜索")
     @RequestMapping("DetailWithSearch")
     public Result<Page<GoodsDetailVo>> DetailWithSearch() {
         GoodsQuery goodsQuery = parmsUtil.getObject("query", GoodsQuery.class);
@@ -100,6 +104,7 @@ public class GoodsController extends BaseController {
     /**
      * 商品搜索 一键建档内的搜索
      */
+    @ApiOperation("商品搜索一键建档内的搜索")
     @RequestMapping("search")
     public Result<List<GoodsSearchVo>> search() {
         Map<String, Object> parms = getParms();
@@ -112,6 +117,7 @@ public class GoodsController extends BaseController {
      * 根据商品id获取商品
      * @return
      */
+    @ApiOperation("根据商品id获取商品")
     @RequestMapping("get")
     public Result<Object> get() {
         int id = parmsUtil.getInteger("id", "请输入ID");
@@ -122,6 +128,7 @@ public class GoodsController extends BaseController {
      * 商品添加标识码
      * 参数：goodsId,idCode
      */
+    @ApiOperation("商品添加标识码")
     @RecordCommonLog(operation = "商品添加标识码")
     @RequestMapping("addIdCode")
     public Result<Object> addIdCode(){
@@ -135,6 +142,7 @@ public class GoodsController extends BaseController {
      * 获取二级分类绑定的商品数量
      * 参数 cateId 二级分类ID
      */
+    @ApiOperation("获取二级分类绑定的商品数量")
     @RequestMapping("getByCateId")
     public Result<Long> getCountByCateId() {
         Integer cateId = parmsUtil.getInteger("cateId", "请输入分类ID");
@@ -144,6 +152,7 @@ public class GoodsController extends BaseController {
     /**
      * 停售
      */
+    @ApiOperation("停售商品")
     @RecordCommonLog(operation = "停售商品")
     @RequestMapping("disableSale")
     public Result<Goods> disableSale() {
@@ -153,6 +162,7 @@ public class GoodsController extends BaseController {
     /**
      * 启售商品
      */
+    @ApiOperation("起售商品")
     @RecordCommonLog(operation = "启售商品")
     @RequestMapping("enableSale")
     public Result<Goods> enableSale() {

src/main/java/com/syjiaer/clinic/server/controller/inventory/InventoryApplyController.java

@@ -7,6 +7,7 @@ import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.entity.inventory.InventoryApply;
 import com.syjiaer.clinic.server.entity.inventory.dto.ApplyOrderQuery;
 import com.syjiaer.clinic.server.service.inventory.InventoryApplyService;
+import io.swagger.annotations.ApiOperation;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -27,6 +28,7 @@ public class InventoryApplyController extends BaseController {
      * 创建领用单并领用
      */
     @RecordCommonLog(operation = "创建领用单并领用")
+    @ApiOperation("创建领用单并领用")
     @RequestMapping("/create")
     public Result create() {
         List<Map> mapList = parmsUtil.getList("data",Map.class);
@@ -39,6 +41,7 @@ public class InventoryApplyController extends BaseController {
     /**
      * 分页查询领用单
      */
+    @ApiOperation("分页查询领用单")
     @RequestMapping("/list")
     public Result<Page> list() {
         ApplyOrderQuery query = parmsUtil.getObject("query", ApplyOrderQuery.class);
@@ -50,6 +53,7 @@ public class InventoryApplyController extends BaseController {
     /**
      * 获取领用单详情
      */
+    @ApiOperation("获取领用单详情")
     @RequestMapping("/getDetail")
     public Result<String> getDetail(){
         Integer applyId = parmsUtil.getInteger("id", "id不能为空");

src/main/java/com/syjiaer/clinic/server/controller/inventory/InventoryCheckController.java

@@ -7,6 +7,7 @@ import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.entity.inventory.InventoryCheck;
 import com.syjiaer.clinic.server.entity.inventory.dto.CheckQuery;
 import com.syjiaer.clinic.server.service.inventory.InventoryCheckService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -23,6 +24,7 @@ public class InventoryCheckController extends BaseController {
     /**
      * 盘点列表分页查询
      */
+    @ApiOperation("盘点列表分页查询")
     @RequestMapping("/list")
     public Result<Page<InventoryCheck>> list() {
         CheckQuery query= parmsUtil.getObject("query", CheckQuery.class);
@@ -34,6 +36,7 @@ public class InventoryCheckController extends BaseController {
     /**
      * 保存盘点记录
      */
+    @ApiOperation("保存盘点记录")
     @RecordCommonLog(operation = "完成盘点")
     @RequestMapping("/save")
     public Result save() {
@@ -47,6 +50,7 @@ public class InventoryCheckController extends BaseController {
     /**
      * 获取盘点单详情
      */
+    @ApiOperation("获取盘点单详情")
     @RequestMapping("/getDetail")
     public Result<String> getDetail(){
         Integer checkId = parmsUtil.getInteger("id", "id不能为空");

src/main/java/com/syjiaer/clinic/server/controller/inventory/InventoryController.java

@@ -10,6 +10,7 @@ import com.syjiaer.clinic.server.entity.inventory.Inventory;
 import com.syjiaer.clinic.server.service.goods.GoodsService;
 import com.syjiaer.clinic.server.service.inventory.InventoryPurchaseService;
 import com.syjiaer.clinic.server.service.inventory.InventoryService;
+import io.swagger.annotations.ApiOperation;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -35,6 +36,7 @@ public class InventoryController extends BaseController {
     /**
      * 根据采购单code 获取采购单信息
      */
+    @ApiOperation("获取采购单信息 根据code")
     @RequestMapping("/listByOrderCode")
     public Result<List<Inventory>> listByOrderCode() {
         String purchaseCode = parmsUtil.getString("orderCode", "请输入订单号");
@@ -45,6 +47,7 @@ public class InventoryController extends BaseController {
     /**
      * 根据goodsId 获取该goods的所有库存信息 带库存总量
      */
+    @ApiOperation("获取商品库存信息 根据goodsId")
     @RequestMapping("/getByGoodsId")
     public Result<Map<String, Object>> getByGoodsId() {
         int goodsId = parmsUtil.getInteger("goodsId", "请输入商品ID");
@@ -78,6 +81,7 @@ public class InventoryController extends BaseController {
     /**
      * 根据goodsId 获取该goods的所有库存信息
      */
+    @ApiOperation("获取商品库存信息 根据goodsId")
     @RequestMapping("/listByGoodsId")
     public Result<List<Inventory>> listByGoodsId() {
         int goodsId = parmsUtil.getInteger("goodsId", "请输入商品ID");
@@ -92,6 +96,7 @@ public class InventoryController extends BaseController {
     /**
      * 根据id集合获取库存信息
      */
+    @ApiOperation("根据库存id集合获取库存信息")
     @RequestMapping("/listByIds")
     public Result<List<Inventory>> listByIds() {
         List<Integer> ids = parmsUtil.getIntList("idList");
@@ -105,6 +110,7 @@ public class InventoryController extends BaseController {
     /**
      * 库存统计
      */
+    @ApiOperation("库存统计")
     @RequestMapping("/statistics")
     public Result<List<InventoryService.LineModel>> statistics() {
         int goodsId = parmsUtil.getInteger("goodsId", "请选择商品id");
@@ -119,6 +125,7 @@ public class InventoryController extends BaseController {
       * 库存日志
      */
     //todo getInventoryLog
+    @ApiOperation("获取库存日志")
     @RequestMapping("/log")
     public Result<List<Map<String, Object>>> log() {
         int goodsId = parmsUtil.getInteger("goodsId", "请选择商品id");
@@ -135,6 +142,7 @@ public class InventoryController extends BaseController {
      *
      * @return
      */
+    @ApiOperation("修改库存采购信息")
     @RecordCommonLog(operation = "更改采购单商品信息")
     @RequestMapping("/update")
     public Result update() {

src/main/java/com/syjiaer/clinic/server/controller/inventory/InventoryPurchaseController.java

@@ -11,6 +11,7 @@ import com.syjiaer.clinic.server.entity.inventory.InventoryPurchase;
 import com.syjiaer.clinic.server.entity.inventory.dto.PurchaseOrderQuery;
 import com.syjiaer.clinic.server.entity.inventory.vo.InventoryPurchaseVo;
 import com.syjiaer.clinic.server.service.inventory.InventoryPurchaseService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -38,6 +39,7 @@ public class InventoryPurchaseController extends BaseController {
      * 创建采购单
      * @return
      */
+    @ApiOperation("创建采购单")
     @RecordCommonLog(operation = "创建采购单")
     @RequestMapping("/create")
     public Result<Object> create() {
@@ -53,6 +55,7 @@ public class InventoryPurchaseController extends BaseController {
      * 分页查采购单
      * @return
      */
+    @ApiOperation("分页查询采购单")
     @RequestMapping("/list")
     public Result<Page<InventoryPurchaseVo>> list() {
         PurchaseOrderQuery query = parmsUtil.getObject("query", PurchaseOrderQuery.class);
@@ -63,6 +66,7 @@ public class InventoryPurchaseController extends BaseController {
     /**
      * 获取采购单详情
      */
+    @ApiOperation("获取采购单详情")
     @RequestMapping("/detail")
     public Result<Map<String, Object>> detail() {
         String code = parmsUtil.getString("code","采购单号不能为空");
@@ -74,6 +78,7 @@ public class InventoryPurchaseController extends BaseController {
      * 更新采购单基本信息
      * @return
      */
+    @ApiOperation("更新采购单基本信息")
     @RecordCommonLog(operation = "更新采购单基本信息")
     @RequestMapping("/update")
     public Result update() {
@@ -89,6 +94,7 @@ public class InventoryPurchaseController extends BaseController {
      * 采购单修改时 添加采购的商品
      * @return
      */
+    @ApiOperation("采购单修改时 添加采购的商品")
     @RecordCommonLog(operation = "已有的采购单中添加商品")
     @RequestMapping("/addGoods")
     public Result addGoods() {
@@ -108,6 +114,7 @@ public class InventoryPurchaseController extends BaseController {
      *采购单退货
      * @return
      */
+    @ApiOperation("采购单退货")
     @RecordCommonLog(operation = "采购单退货")
     @RequestMapping("/refund")
     public Result refund() {
@@ -123,6 +130,7 @@ public class InventoryPurchaseController extends BaseController {
      *转excel
      * @return
      */
+    @ApiOperation("采购一键导入，生成excel")
 
     @RequestMapping("/toExcel")
     public Result toExcel() {
@@ -138,6 +146,7 @@ public class InventoryPurchaseController extends BaseController {
      *从excel导入
      * @return
      */
+    @ApiOperation("采购一键导入，解析excel")
     @RequestMapping("/fromExcel")
     public Result fromExcel() {
         String file_token = parmsUtil.getString("token");

src/main/java/com/syjiaer/clinic/server/controller/inventory/InventorySupplierController.java

@@ -7,6 +7,7 @@ import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.entity.inventory.InventorySupplier;
 import com.syjiaer.clinic.server.entity.inventory.dto.SupplierQuery;
 import com.syjiaer.clinic.server.service.inventory.InventorySupplierService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -21,6 +22,7 @@ public class InventorySupplierController extends BaseController {
      * 分页查询 供货商
      * @return
      */
+    @ApiOperation("分页查询供货商")
     @RequestMapping("/list")
     public Result<Page> list() {
         SupplierQuery query= parmsUtil.getObject("query", SupplierQuery.class);
@@ -32,6 +34,7 @@ public class InventorySupplierController extends BaseController {
      * 保存供货商
      * @return
      */
+    @ApiOperation("保存供货商")
     @RecordCommonLog(operation = "保存供货商")
     @RequestMapping("/save")
     public Result save() {

src/main/java/com/syjiaer/clinic/server/controller/item/ItemController.java

@@ -10,6 +10,7 @@ import com.syjiaer.clinic.server.entity.item.ItemGroupList;
 import com.syjiaer.clinic.server.entity.item.param.ItemParam;
 import com.syjiaer.clinic.server.entity.item.vo.ItemSearchVo;
 import com.syjiaer.clinic.server.service.item.ItemService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -25,6 +26,7 @@ public class ItemController extends BaseController {
     /*
     * 获取非组套列表
      */
+    @ApiOperation("获取非组套列表")
     @RequestMapping("/list")
     public Result<Page<Item>> getAllItems() {
         int page = parmsUtil.getInteger("pageNum", "页码不能为空");
@@ -37,6 +39,7 @@ public class ItemController extends BaseController {
     /*
      * 获取组套列表
      */
+    @ApiOperation("获取组套列表")
     @RequestMapping("/groupList")
     public Result<Page<Item>> groupList() {
         int page = parmsUtil.getInteger("page", "页码不能为空");
@@ -48,6 +51,7 @@ public class ItemController extends BaseController {
     /*
       * 获取项目详情
      */
+    @ApiOperation("获取项目详情")
     @RequestMapping("/get")
     public Result<Item> get() {
         Integer id = parmsUtil.getInteger("id");
@@ -59,6 +63,7 @@ public class ItemController extends BaseController {
     /*
      * 添加项目
      */
+    @ApiOperation("添加项目")
     @RecordCommonLog(operation = "保存服务项目")
     @RequestMapping("/add")
     public Result<?> createItem() {
@@ -69,6 +74,7 @@ public class ItemController extends BaseController {
     /*
       * 修改项目
      */
+    @ApiOperation("修改项目")
     @RecordCommonLog(operation = "编辑服务项目")
     @RequestMapping("/edit")
     public Result<?> updateItem() {
@@ -80,6 +86,7 @@ public class ItemController extends BaseController {
     /*
       * 删除项目
      */
+    @ApiOperation("删除项目")
     @RequestMapping("/delete")
     public Result<?> deleteItem() {
         Integer id = parmsUtil.getInteger("id");
@@ -89,6 +96,7 @@ public class ItemController extends BaseController {
     /*
       * 搜索项目
      */
+    @ApiOperation("搜索项目")
     @RequestMapping("/search")
     public Result<List<ItemSearchVo>> search() {
         String keyword = parmsUtil.getString("keyword");
@@ -98,6 +106,7 @@ public class ItemController extends BaseController {
     /*
       * 保存组套
      */
+    @ApiOperation("保存组套")
     @RequestMapping("/saveGroup")
     public Result<?> saveGroup() {
         List<ItemGroupList> itemGroupList = parmsUtil.getList("list", ItemGroupList.class,"请求参数list不能为空");
@@ -111,6 +120,7 @@ public class ItemController extends BaseController {
     /*
       * 获取组套
      */
+    @ApiOperation("获取组套")
     @RequestMapping("/getGroup")
     public Result<?> getGroup() {
         Integer itemId = parmsUtil.getInteger("id","item_id为空");
@@ -119,6 +129,7 @@ public class ItemController extends BaseController {
     /*
       * 删除组套
      */
+    @ApiOperation("删除组套")
     @RequestMapping("/deleteGroup")
     public Result<?> deleteGroup() {
         Integer itemId = parmsUtil.getInteger("id","item_id为空");

src/main/java/com/syjiaer/clinic/server/controller/organization/OrganizationMemberController.java

@@ -9,6 +9,7 @@ import com.syjiaer.clinic.server.entity.organization.OrganizationMember;
 import com.syjiaer.clinic.server.entity.organization.dto.DockerSearchQuery;
 import com.syjiaer.clinic.server.entity.organization.dto.OrganizationMemberSaveDto;
 import com.syjiaer.clinic.server.service.organization.OrganizationMemberService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -20,6 +21,8 @@ import java.util.List;
 public class OrganizationMemberController extends BaseController {
     @Autowired
     private OrganizationMemberService organizationMemberService;
+
+    @ApiOperation("分页查询成员列表")
     @RequestMapping("/list")
     public Result<Page<OrganizationMemberSaveDto>> list() {
         int page = parmsUtil.getInteger("page","页码不能为空");
@@ -28,6 +31,8 @@ public class OrganizationMemberController extends BaseController {
         String tel = parmsUtil.getString("tel");
         return success(organizationMemberService.pageList(page,size,name,tel));
     }
+
+    @ApiOperation("保存成员信息")
     @RequestMapping("/save")
     @RecordCommonLog(operation = "保存成员信息")
     public Result<?> save() {
@@ -38,6 +43,8 @@ public class OrganizationMemberController extends BaseController {
         organizationMemberService.save(dto);
         return success();
     }
+
+    @ApiOperation("删除成员")
     @RequestMapping("/delete")
     @RecordCommonLog(operation = "删除成员")
     public Result<?> delete() {
@@ -48,12 +55,16 @@ public class OrganizationMemberController extends BaseController {
         organizationMemberService.delete(id);
         return success();
     }
+
+    @ApiOperation("获取成员信息")
     @RequestMapping("/get")
     public Result<OrganizationMemberSaveDto> get() {
         Integer id = parmsUtil.getInteger("id","id不能为空");
         return success(organizationMemberService.get(id));
     }
 
+
+    @ApiOperation("搜索成员")
     @RequestMapping("/search")
     public Result<List<OrganizationMember>> search() {
         DockerSearchQuery dockerSearchQuery = parmsUtil.getObject("query", DockerSearchQuery.class);
@@ -64,6 +75,7 @@ public class OrganizationMemberController extends BaseController {
      * 获取当前科室的所有医生
      * @return
      */
+    @ApiOperation("获取当前科室的所有医生")
     @RequestMapping("/listBySectionId")
     public Result<List<OrganizationMember>> listBySectionId() {
         Integer sectionId = parmsUtil.getInteger("sectionId");

src/main/java/com/syjiaer/clinic/server/controller/organization/OrganizationSectionController.java

@@ -9,6 +9,7 @@ import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.entity.organization.OrganizationSection;
 import com.syjiaer.clinic.server.service.organization.OrganizationSectionService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -20,6 +21,8 @@ import java.util.List;
 public class OrganizationSectionController extends BaseController {
     @Autowired
     private OrganizationSectionService organizationSectionService;
+
+    @RecordCommonLog(operation = "分页查询科室列表")
     @RequestMapping("/list")
     public Result<Page<OrganizationSection>> list() {
         int page = parmsUtil.getInteger("page","页码不能为空");
@@ -30,6 +33,8 @@ public class OrganizationSectionController extends BaseController {
         String resperTel = parmsUtil.getString("resperTel");
         return success(organizationSectionService.list(page,size,name,caty,resperName,resperTel));
     }
+
+    @ApiOperation("添加科室")
     @RecordCommonLog(operation = "添加科室")
     @RequestMapping("/add")
     public Result<?> add() {
@@ -40,6 +45,8 @@ public class OrganizationSectionController extends BaseController {
         organizationSectionService.add(organizationSection);
         return success("添加成功");
     }
+
+    @ApiOperation("修改科室信息")
     @RecordCommonLog(operation = "修改科室信息")
     @RequestMapping("/edit")
     public Result<?> edit() {
@@ -51,6 +58,7 @@ public class OrganizationSectionController extends BaseController {
         return success("编辑成功");
     }
 
+    @ApiOperation("删除科室")
     @RecordCommonLog(operation = "删除科室")
     @RequestMapping("/delete")
     public Result<?> delete() {
@@ -61,6 +69,9 @@ public class OrganizationSectionController extends BaseController {
         organizationSectionService.delete(id);
         return success("删除成功");
     }
+
+
+    @ApiOperation("获取科室信息")
     @RequestMapping("/get")
     public Result<OrganizationSection> get() {
         Integer id = parmsUtil.getInteger("id");
@@ -74,6 +85,8 @@ public class OrganizationSectionController extends BaseController {
      * 获取所有科室
      * @return
      */
+
+    @ApiOperation("获取所有科室")
     @RequestMapping("/allList")
     public Result<List<JSONObject>> allList() {
         return success( organizationSectionService.getAllList());
@@ -83,6 +96,8 @@ public class OrganizationSectionController extends BaseController {
      * 获取当前成员的所属科室
      * @return
      */
+
+    @ApiOperation("获取当前成员的所属科室")
     @RequestMapping("/listByMemberId")
     public Result<List<OrganizationSection>> listByMemberId() {
         Integer memberId = parmsUtil.getInteger("memberId");

src/main/java/com/syjiaer/clinic/server/controller/patient/PatientController.java

@@ -6,6 +6,7 @@ import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.entity.patient.PatientInfo;
 import com.syjiaer.clinic.server.service.patient.PatientInfoService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -27,6 +28,8 @@ public class PatientController extends BaseController {
     @Autowired
     private PatientInfoService patientInfoService;
 
+
+    @ApiOperation("创建患者")
     @RequestMapping("/create")
     @RecordCommonLog(operation = "创建患者")
     public Result<Object> create() {
@@ -35,6 +38,8 @@ public class PatientController extends BaseController {
 
         return success();
     }
+
+    @ApiOperation("修改患者信息")
     @RecordCommonLog(operation = "修改患者信息")
     @RequestMapping("/update")
     public Result<Object> update() {
@@ -43,6 +48,8 @@ public class PatientController extends BaseController {
         return success();
     }
 
+
+    @ApiOperation("删除患者")
     @RequestMapping("/delete")
     @RecordCommonLog(operation = "删除患者")
     public Result<Integer> delete() {
@@ -50,6 +57,8 @@ public class PatientController extends BaseController {
         return success(patientInfoService.removeById(patientId));
     }
 
+
+    @ApiOperation("分页查询患者列表")
     @RequestMapping("/list")
     public Result<Page<PatientInfo>> selectList() {
         String keyword = parmsUtil.getString("keyword");
@@ -59,6 +68,7 @@ public class PatientController extends BaseController {
         return success(list);
     }
 
+    @ApiOperation("获取患者信息")
     @RequestMapping("/get")
     public Result<PatientInfo> get() {
         int id = parmsUtil.getInteger("id", "ID不能为空");
@@ -66,12 +76,16 @@ public class PatientController extends BaseController {
         return success(patientInfo);
     }
 
+    @ApiOperation("搜索患者")
     @RequestMapping("/search")
     public Result<List<PatientInfo>> search() {
         String keyword = parmsUtil.getString("keyword", "关键字不能为空");
         List<PatientInfo> list = patientInfoService.search(keyword);
         return success(list);
     }
+
+
+    @ApiOperation("改变会员等级")
     @RecordCommonLog(operation = "改变会员等级")
     @RequestMapping("/changeLevel")
     public Result<Object> changeLevel() {
@@ -83,6 +97,4 @@ public class PatientController extends BaseController {
     }
 
 
-
-
 }

src/main/java/com/syjiaer/clinic/server/controller/patient/PatientIntegralController.java

@@ -8,6 +8,7 @@ import com.syjiaer.clinic.server.entity.vip.VipIntegralLog;
 import com.syjiaer.clinic.server.entity.vip.dto.VipIntegralLogQuery;
 import com.syjiaer.clinic.server.service.patient.PatientInfoService;
 import com.syjiaer.clinic.server.service.vip.VipIntegralLogService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -20,6 +21,8 @@ public class PatientIntegralController extends BaseController {
     @Autowired
     private PatientInfoService patientInfoService;
 
+
+    @ApiOperation("添加会员积分")
     @RecordCommonLog(operation = "添加会员积分")
     @RequestMapping("/add")
     public Result add(){
@@ -29,6 +32,8 @@ public class PatientIntegralController extends BaseController {
         patientInfoService.changeIntegral(vipId,Integral,remark);
         return success();
     }
+
+    @ApiOperation("分页查询会员积分记录")
     @RequestMapping("/list")
     public Result<Page<VipIntegralLog>> listByVipId(){
         VipIntegralLogQuery query = parmsUtil.getObject("query", VipIntegralLogQuery.class);

src/main/java/com/syjiaer/clinic/server/controller/patient/PatientLevelConfigController.java

@@ -5,6 +5,7 @@ import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.entity.vip.VipLevelConfig;
 import com.syjiaer.clinic.server.service.vip.VipLevelConfigService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -24,6 +25,9 @@ import java.util.List;
 public class PatientLevelConfigController extends BaseController {
     @Autowired
     private VipLevelConfigService vipLevelConfigService;
+
+
+    @ApiOperation("新增会员等级配置")
     @RecordCommonLog(operation = "创建会员等级配置")
     @RequestMapping("/create")
     public Result<Object> create() {
@@ -31,6 +35,8 @@ public class PatientLevelConfigController extends BaseController {
         vipLevelConfigService.create(levelConfig);
         return success();
     }
+
+    @ApiOperation("修改会员等级配置")
     @RecordCommonLog(operation = "修改会员等级配置")
     @RequestMapping("/edit")
     public Result<Object> edit() {
@@ -41,6 +47,8 @@ public class PatientLevelConfigController extends BaseController {
         return success();
     }
 
+
+    @ApiOperation("保存会员等级配置")
     @RecordCommonLog(operation = "保存会员等级配置")
     @RequestMapping("/save")
     public Result<Object> save() {
@@ -49,6 +57,8 @@ public class PatientLevelConfigController extends BaseController {
 
         return success();
     }
+
+    @ApiOperation("删除一个会员等级配置")
     @RecordCommonLog(operation = "删除一个会员等级配置")
     @RequestMapping("/delete")
     public Result<Object> delete() {
@@ -58,6 +68,7 @@ public class PatientLevelConfigController extends BaseController {
         return success();
     }
 
+    @ApiOperation("分页查询会员等级配置")
     @RequestMapping("/list")
     public Result<List<VipLevelConfig>> selectList() {
 
@@ -65,6 +76,8 @@ public class PatientLevelConfigController extends BaseController {
         return success(list);
     }
 
+
+    @ApiOperation("根据leveId获取会员等级配置")
     @RequestMapping("/get")
     public Result<VipLevelConfig> get() {
         int levelId = parmsUtil.getInteger("levelId", "ID不能为空");

src/main/java/com/syjiaer/clinic/server/controller/patient/RegistrationController.java

@@ -12,6 +12,7 @@ import com.syjiaer.clinic.server.entity.patient.vo.PatientAndRegistrationInfoVo;
 import com.syjiaer.clinic.server.entity.patient.vo.PatientRegistrationVo;
 import com.syjiaer.clinic.server.service.patient.PatientInfoService;
 import com.syjiaer.clinic.server.service.patient.PatientRegistrationService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -32,6 +33,7 @@ public class RegistrationController extends BaseController {
      */
     @RecordCommonLog(operation = "挂号")
     @RequestMapping("/add")
+    @ApiOperation("挂号")
     public Result<?> add() {
 
         RegistrationSaveDto registrationParam = parmsUtil.getObjectWithCheck("data", RegistrationSaveDto.class);
@@ -45,6 +47,7 @@ public class RegistrationController extends BaseController {
      * 分页查询 挂号列表
      * @return
      */
+    @ApiOperation("分页查询挂号列表")
     @RequestMapping("/list")
     public Result<Page<PatientRegistration>> list() {
         int page = parmsUtil.getInteger("page", "页码不能为空");
@@ -58,6 +61,7 @@ public class RegistrationController extends BaseController {
     /**
      *取消挂号
      */
+    @ApiOperation("取消挂号")
     @RecordCommonLog(operation = "取消挂号")
     @RequestMapping("/cancel")
     public Result<?> cancel() {
@@ -70,6 +74,7 @@ public class RegistrationController extends BaseController {
      * 修改挂号信息
      * @return
      */
+    @ApiOperation("修改挂号信息")
     @RecordCommonLog(operation = "修改挂号信息")
     @RequestMapping("/edit")
     public Result<?> edit() {
@@ -86,6 +91,7 @@ public class RegistrationController extends BaseController {
      * 删除挂号信息
      * @return
      */
+    @ApiOperation("删除挂号信息")
     @RecordCommonLog(operation = "删除挂号信息")
     @RequestMapping("/delete")
     public Result<?> delete() {
@@ -101,6 +107,7 @@ public class RegistrationController extends BaseController {
      * 获取挂号信息
      * @return
      */
+    @ApiOperation("获取挂号信息 根据挂号id")
     @RequestMapping("/get")
     public Result<PatientRegistrationVo> get() {
         Integer id = parmsUtil.getInteger("id");
@@ -111,6 +118,7 @@ public class RegistrationController extends BaseController {
         return success(result);
     }
 
+    @ApiOperation("获取挂号信息列表")
     @RequestMapping("/allList")
     public Result<List<PatientRegistration>> allList() {
         List<PatientRegistration> list = patientRegistrationService.listAll();
@@ -121,6 +129,7 @@ public class RegistrationController extends BaseController {
      * 挂号信息分页搜索
      * @return
      */
+    @ApiOperation("挂号信息分页搜索")
     @RequestMapping("/listByType")
     public Result<Page<PatientRegistration>> listByType() {
         RegistrationQuery query = parmsUtil.getObject("query", RegistrationQuery.class);
@@ -131,6 +140,7 @@ public class RegistrationController extends BaseController {
      * 根据id返回挂号详细信息 包含患者信息
      * @return
      */
+    @ApiOperation("根据id返回挂号详细信息 包含患者信息")
     @RequestMapping("/getWithPatient")
     public Result<PatientAndRegistrationInfoVo> getWithPatient(){
         Integer regisId= parmsUtil.getInteger("id","挂号单不能为空");
@@ -142,6 +152,7 @@ public class RegistrationController extends BaseController {
      * 更改挂号单状态 在诊断 诊断
      * @return
      */
+    @ApiOperation("更改挂号单状态")
     @RecordCommonLog(operation = "更改挂号单状态")
     @RequestMapping("/changeStatus")
     public Result<PatientRegistration> changeStatus(){

src/main/java/com/syjiaer/clinic/server/controller/social/SocialChineseMedicinalGranulaController.java

@@ -3,6 +3,7 @@ package com.syjiaer.clinic.server.controller.social;
 import com.syjiaer.clinic.server.common.exception.MessageException;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.service.social.SocialChineseMedicinalGranulaService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -13,6 +14,7 @@ public class SocialChineseMedicinalGranulaController extends BaseController {
     @Autowired
     private SocialChineseMedicinalGranulaService socialChineseMedicinalGranulaService;
     @RequestMapping("download")
+    @ApiOperation("下载中药颗粒")
     public String download() {
         String version = parmsUtil.getString("version");
         if (version == null || version.isEmpty()) {

src/main/java/com/syjiaer/clinic/server/controller/social/SocialDiagnoseController.java

@@ -4,6 +4,7 @@ import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.entity.social.SocialDiagnose;
 import com.syjiaer.clinic.server.service.social.SocialDiagnoseService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -15,6 +16,8 @@ import java.util.List;
 public class SocialDiagnoseController extends BaseController {
     @Autowired
     private SocialDiagnoseService socialDiagnoseService;
+
+    @ApiOperation("诊断搜索")
     @RequestMapping("search")
     public Result<List<SocialDiagnose>> getDiagnosis() {
         String keyword = parmsUtil.getString("keyword");

src/main/java/com/syjiaer/clinic/server/controller/social/SocialDirectoryController.java

@@ -9,6 +9,7 @@ import com.syjiaer.clinic.server.entity.social.SocialItem;
 import com.syjiaer.clinic.server.entity.social.vo.SocialDirectoryView;
 import com.syjiaer.clinic.server.entity.social.vo.SocialItemVo;
 import com.syjiaer.clinic.server.service.social.*;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -42,6 +43,8 @@ public class SocialDirectoryController extends BaseController {
     @Autowired
     private DictoryUtil dictoryUtil;
 
+
+    @ApiOperation("搜索目录信息")
     @RequestMapping("search")
     public Result<Object> search() {
 
@@ -54,6 +57,8 @@ public class SocialDirectoryController extends BaseController {
 
         return success(socialDirectoryService.search(keyword, type, page, size));
     }
+
+    @ApiOperation("搜索企业信息")
     @RequestMapping("searchProducer")
     public Result<List<Map<String,Object>>> searchProducer() {
         String keyword = parmsUtil.getString("keyword","请输入搜索关键词");
@@ -61,16 +66,22 @@ public class SocialDirectoryController extends BaseController {
         return success(socialDirectoryService.searchProducer(keyword, type));
 
     }
+
+    @ApiOperation("根据医保码，获取医保商品信息")
     @RequestMapping("getByCode")
     public Result<SocialDirectoryView> getByCode() {
         String code = parmsUtil.getString("code");
         return success(socialDirectoryService.getByCode(code));
     }
+
+    @ApiOperation("根据医保码，获取医保服务项目信息")
     @RequestMapping("getItemByCode")
     public Result<SocialItemVo> getItemByCode() {
         String code = parmsUtil.getString("code");
         return success(socialItemService.getByCode(code));
     }
+
+    @ApiOperation("下载目录")
     @PostMapping("download")
     public Result<Object> download() {
         Map<String, Object> parms = getParms();
@@ -110,6 +121,7 @@ public class SocialDirectoryController extends BaseController {
 
     }
 
+    @ApiOperation("获取目录列 列表")
     @RequestMapping("column_list")
     public Result<Object> get_column_list() {
         Map<String,Object> parms= parmsUtil.getMap();
@@ -117,7 +129,7 @@ public class SocialDirectoryController extends BaseController {
         List<Map<String, Object>> columnList = socialDirectoryService.getColumnList(type);
         return success(columnList);
     }
-
+    @ApiOperation("获取目录列表")
     @RequestMapping("get_doc_list")
     public Result<Page<?>> get_doc_list() {
         Map<String,Object> parms= parmsUtil.getMap();
@@ -149,6 +161,8 @@ public class SocialDirectoryController extends BaseController {
 
 
     }
+
+    @ApiOperation("服务项目搜索")
     @RequestMapping("itemSearch")
     public Result<Page<SocialItem>> itemSearch() {
         String keyword = parmsUtil.getString("keyword","请输入搜索关键词");
@@ -163,6 +177,7 @@ public class SocialDirectoryController extends BaseController {
         return success(socialItemService.pageList(pageNum,pageSize,keyword));
     }
 
+    @ApiOperation("同步到MongoDB")
     @PostMapping("syncToMongo")
     public Result<Object> syncToMongo() {
         return success(socialDirectoryService.syncSocialDirectoryCache(parmsUtil.getInteger("page","请输入page")));

src/main/java/com/syjiaer/clinic/server/controller/social/SocialDirectoryLimitController.java

@@ -3,6 +3,7 @@ package com.syjiaer.clinic.server.controller.social;
 import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.service.social.SocialDirectoryLimitService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -23,6 +24,7 @@ public class SocialDirectoryLimitController extends BaseController {
     @Autowired
     private SocialDirectoryLimitService socialDirectoryLimitService;
 
+    @ApiOperation("分页查询目录限制信息")
     @RequestMapping("get_page")
     public Result get_page() {
         Map<String, Object> parms = getParms();

src/main/java/com/syjiaer/clinic/server/controller/social/SocialDirectorySelfController.java

@@ -3,6 +3,7 @@ package com.syjiaer.clinic.server.controller.social;
 import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.service.social.SocialDirectorySelfService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -23,6 +24,7 @@ public class SocialDirectorySelfController extends BaseController {
     @Autowired
     private SocialDirectorySelfService socialDirectorySelfService;
 
+    @ApiOperation("分页查询自付比例信息")
     @RequestMapping("get_page")
     public Result get_page() {
         Map<String, Object> parms = getParms();

src/main/java/com/syjiaer/clinic/server/controller/social/SocialDirectoryUpinfoController.java

@@ -3,6 +3,7 @@ package com.syjiaer.clinic.server.controller.social;
 import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.service.social.SocialDirectoryUpinfoService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -22,7 +23,7 @@ import java.util.Map;
 public class SocialDirectoryUpinfoController extends BaseController {
     @Autowired
     private SocialDirectoryUpinfoService socialDirectoryUpinfoService;
-
+    @ApiOperation("分页查询更新信息")
     @RequestMapping("get_page")
     public Result get_page() {
         Map<String, Object> parms = getParms();

src/main/java/com/syjiaer/clinic/server/controller/social/SocialDirectoryVersionController.java

@@ -6,6 +6,7 @@ import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.entity.social.SocialDirectoryVersion;
 import com.syjiaer.clinic.server.service.social.SocialDirectoryVersionService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -23,14 +24,14 @@ import org.springframework.web.bind.annotation.RestController;
 public class SocialDirectoryVersionController extends BaseController {
     @Autowired
     private SocialDirectoryVersionService socialDirectoryVersionService;
-
+    @ApiOperation("获取当前医保目录版本")
     @RequestMapping("get_current")
     public Result<Object> get_current() {
         Integer type = parmsUtil.getInteger("type","type不能为空");
         SocialDirectoryVersion current = socialDirectoryVersionService.getCurrent(type);
         return success(current);
     }
-
+    @ApiOperation("获取医保目录版本列表")
     @RequestMapping("list")
     public Result<Page<SocialDirectoryVersion>> list() {
         int page = parmsUtil.getInteger("page","page不能为空");

src/main/java/com/syjiaer/clinic/server/controller/social/SocialPersonController.java

@@ -5,6 +5,7 @@ import com.syjiaer.clinic.server.common.vo.Result;
 import com.syjiaer.clinic.server.controller.BaseController;
 import com.syjiaer.clinic.server.entity.social.vo.SocialPersonInfoVo;
 import com.syjiaer.clinic.server.service.social.SocialUserService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -15,6 +16,8 @@ import org.springframework.web.bind.annotation.RestController;
 public class SocialPersonController extends BaseController {
     @Autowired
     private SocialUserService socialUserService;
+
+    @ApiOperation("获取社保人员信息")
     @RequestMapping("getCustomSocialInfo")
     public Result<SocialPersonInfoVo> getCustomSocialInfo() {
         IM1101 im1101 = parmsUtil.getObject("data", IM1101.class);
@@ -23,7 +26,7 @@ public class SocialPersonController extends BaseController {
         }
         return success(socialUserService.getSocialInfo(im1101));
     }
-
+    @ApiOperation("根据社保人员编号获取医保人员信息 redis")
     @RequestMapping("getSocialInfoByPsnNo")
     public Result<SocialPersonInfoVo> getSocialInfoByPsnNo() {
         String psnNo = parmsUtil.getString("psnNo");

src/main/java/com/syjiaer/clinic/server/controller/social/SocialReconciliationController.java

@@ -13,6 +13,7 @@ import com.syjiaer.clinic.server.entity.social.dto.ReconciliationLogQuery;
 import com.syjiaer.clinic.server.entity.social.vo.ReconciliationDetailVo;
 import com.syjiaer.clinic.server.entity.social.vo.ReconciliationItemVo;
 import com.syjiaer.clinic.server.service.social.SocialReconciliationService;
+import io.swagger.annotations.ApiOperation;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -33,6 +34,7 @@ public class SocialReconciliationController extends BaseController {
      * 医保-对账列表
      * @return
      */
+    @ApiOperation("医保-对账列表")
     @RequestMapping("/list")
     public Result<List<ReconciliationItemVo>> list(){
         String begin = parmsUtil.getString("beginTime","开始时间为空");
@@ -46,6 +48,7 @@ public class SocialReconciliationController extends BaseController {
     /**
      * 对账历史记录
      */
+    @ApiOperation("自动对账历史记录列表")
     @RequestMapping("/historyList")
     public Result<Page<SocialReconciliationLog>> historyList(){
         ReconciliationLogQuery query  = parmsUtil.getObject("query", ReconciliationLogQuery.class);
@@ -54,6 +57,7 @@ public class SocialReconciliationController extends BaseController {
     /**
      * 对总账
      */
+    @ApiOperation("对总账")
     @RecordCommonLog(operation = "对总账")
     @RequestMapping("/doTotal")
     public Result<OM3201> doTotal(){
@@ -63,6 +67,7 @@ public class SocialReconciliationController extends BaseController {
     /**
      * 明细对账
      */
+    @ApiOperation("明细对账")
     @RecordCommonLog(operation = "明细对账")
     @RequestMapping("/doDetail")
     public Result<List<ReconciliationDetailVo>> doDetail(){
@@ -75,6 +80,7 @@ public class SocialReconciliationController extends BaseController {
     /**
      * 冲正
      */
+    @ApiOperation("冲正")
     @RecordCommonLog(operation = "冲正")
     @RequestMapping("/reversal")
     public Result reversal(){

src/main/java/com/syjiaer/clinic/server/controller/social/SocialUploadController.java

@@ -13,6 +13,7 @@ import com.syjiaer.clinic.server.entity.social.vo.SocialInventoryInitVo;
 import com.syjiaer.clinic.server.entity.social.vo.SocialInventoryLogVo;
 import com.syjiaer.clinic.server.entity.social.vo.SocialInventoryPurchaseLogVo;
 import com.syjiaer.clinic.server.service.social.SocialInventoryUploadService;
+import io.swagger.annotations.ApiOperation;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -28,6 +29,7 @@ public class SocialUploadController extends BaseController {
     /**
      * 分页查询 商品初始化数据
      */
+    @ApiOperation("分页查询 商品初始化数据")
     @RequestMapping("get3501List")
     public Result<Page<SocialInventoryInitVo>> get3501List() {
         InventoryInitQuery initQuery = parmsUtil.getObject("query", InventoryInitQuery.class);
@@ -38,6 +40,7 @@ public class SocialUploadController extends BaseController {
     /**
      * 分页查询 商品库存变更记录
      */
+    @ApiOperation("分页查询 商品库存变更记录")
     @RequestMapping("get3502List")
     public Result<Page<SocialInventoryLogVo>> get3502List() {
         InventoryLogQuery logQuery = parmsUtil.getObject("query", InventoryLogQuery.class);
@@ -48,6 +51,7 @@ public class SocialUploadController extends BaseController {
     /**
      * 分页查询 库存采购数据
      */
+    @ApiOperation("分页查询 库存采购数据")
     @RequestMapping("get3503List")
     public Result<Page> get3503List() {
         InventoryPurchaseLogQuery pLogQuery = parmsUtil.getObject("query", InventoryPurchaseLogQuery.class);
@@ -60,6 +64,7 @@ public class SocialUploadController extends BaseController {
      *
      * @return
      */
+    @ApiOperation("获取3505列表")
     @RequestMapping("get3505List")
     public Result<Page> get3505List() {
         RetailInventoryQuery rlQuery = parmsUtil.getObject("query", RetailInventoryQuery.class);
@@ -70,6 +75,7 @@ public class SocialUploadController extends BaseController {
     /*
      * 获取进销存 3501-3506 未上报数量
      */
+    @ApiOperation("获取进销存 3501-3506 未上报数量")
     @RequestMapping("getNotDoNumber")
     public Result<NotDoNumberVo> getNotDoNumber() {
         return success(socialInventoryUploadService.getNotDoNumberDo());
@@ -81,6 +87,7 @@ public class SocialUploadController extends BaseController {
      *
      * @return
      */
+    @ApiOperation("进销存一键上报接口")
     @RequestMapping("quickUpload")
     public Result<NotDoNumberVo> quickUpload() {
         Boolean uploadResult = socialInventoryUploadService.upload3501();

src/main/java/com/syjiaer/clinic/server/controller/statistics/StatisticsController.java

@@ -9,6 +9,7 @@ import com.syjiaer.clinic.server.entity.statistics.*;
 import com.syjiaer.clinic.server.service.goods.GoodsService;
 import com.syjiaer.clinic.server.service.inventory.InventoryService;
 import com.syjiaer.clinic.server.service.statistics.StatisticsService;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -27,9 +28,11 @@ public class StatisticsController extends BaseController {
     private InventoryService inventoryService;
     @Autowired
     private GoodsService goodsService;
+
     /**
      * 营收概况
      */
+    @ApiOperation("营收概况")
     @RequestMapping("getRevenueOverview")
     public Result<RevenueOverviewVo> getRevenueOverview() {
         String begin = parmsUtil.getString("beginTime", "开始时间为空");
@@ -44,6 +47,7 @@ public class StatisticsController extends BaseController {
     /**
      * 库存预警
      */
+    @ApiOperation("库存预警")
     @RequestMapping("numberEarlyWarning")
     public Result<Page<Goods>> numberEarlyWarning() {
         Integer pageNum = parmsUtil.getInteger("pageNum", "pageNum为空");
@@ -52,9 +56,11 @@ public class StatisticsController extends BaseController {
         Page<Goods> page = goodsService.page(pageNum, pageSize);
         return success(page);
     }
+
     /*
      * 有效期预警
      */
+    @ApiOperation("有效期预警")
     @RequestMapping("expiryDateWarning")
     public Result<Page<Map<String, Object>>> expiryDateWarning() {
         Integer pageNum = parmsUtil.getInteger("pageNum", "pageNum为空");
@@ -62,10 +68,11 @@ public class StatisticsController extends BaseController {
         Page<Map<String, Object>> maps = inventoryService.expiryDateWarning(pageSize, pageNum);
         return success(maps);
     }
+
     /*
      * 经营概况
      */
-
+    @ApiOperation("经营概况")
     @RequestMapping("getPayOverview")
     public Result<PersonPayOverviewVo> getPayOverview() {
         String begin = parmsUtil.getString("beginTime", "开始时间为空");
@@ -76,9 +83,11 @@ public class StatisticsController extends BaseController {
         return success(personPayOverviewVo);
 
     }
+
     /**
      * 销售人次趋势
      */
+    @ApiOperation("销售人次趋势")
     @RequestMapping("getSalesVolumeOverview")
     public Result<SalesVolumeOverviewVo> getSalesVolumeOverview() {
         String begin = parmsUtil.getString("beginTime", "开始时间为空");
@@ -89,9 +98,11 @@ public class StatisticsController extends BaseController {
         return success(salesVolumeOverviewVo);
 
     }
+
     /**
      * 销售人员统计
      */
+    @ApiOperation("销售人员统计")
     @RequestMapping("/salePerson")
     public Result<List<SalePersonReportVo>> salePerson() {
         return success(statisticsService.salePersonReport());
@@ -100,6 +111,7 @@ public class StatisticsController extends BaseController {
     /**
      * 获取收费队列 就诊队列数量
      */
+    @ApiOperation("获取收费队列 就诊队列数量")
     @RequestMapping("/getQueueCount")
     public Result<TipCountVo> getQueueCount() {
         String begin = parmsUtil.getString("beginTime", "开始时间为空");
@@ -108,9 +120,11 @@ public class StatisticsController extends BaseController {
         LocalDateTime endTime = DateUtil.getDateTime(end);
         return success(statisticsService.getTipCount(beginTime, endTime));
     }
+
     /**
      * 商品统计
      */
+    @ApiOperation("商品统计")
     @RequestMapping("/goodsStatistics")
     public Result<GoodsStatistics> getGoodsStatistics() {
         return success(statisticsService.getGoodsStatistics());