轻量化 SaaS 文档管理程序——参数校验与数据库设计

在前五期已完成主要基础能力搭建后动态切换短信发送还有基本的工程架构已经就绪。但在实际开发中，仍然面临以下痛点：

• 参数校验缺乏统一规范。导致业务层代码冗余且易出错。
• 自定义注解实现不够灵活，无法快速 校验规则。
• 处理不集中。前端只能得到通用错误信息，缺乏针对性提示。老实说，
• 数据库表结构缺少统一模板。导致字段命名不一致、查询性能差。

本章围绕上述痛点。提供一套完整的参数校验组件与数据库设计方案，并演示如何在业务模块中落地使用。

1. 参数校验模块搭建

1.1 新建 ivy-starter-validation 模块

在项目根目录下创建 ivy-starter-validation 包含通用校验功能，并引入主要依赖：

vip.wayhua.ivy
ivy-starter-core
. 

1.2 自定义校验注解

实现两个常用注解：@Email 与 @Mobile。基于 Jakarta Validation 规范，可快速复用和

1.2.1 @Email 注解

package vip.wayhua.ivy.core.annotation;import jakarta.validation.Constraint;怎么说呢，import jakarta.validation.Payload;话说回来，import vip.wayhua.ivy.core.validator.EmailValidator;import java.lang.annotation.*;@Target
@Retention
@Constraint
@Documented
public @interface Email {
String message default "Email邮箱格式不正确";Class groups default {};Class payload default {};}

1.2.2 @Mobile 注解

package vip.wayhua.ivy.core.annotation;import jakarta.validation.Constraint;import jakarta.validation.Payload;老实说，import java.lang.annotation.*;@Target
@Retention
@Constraint
@Documented
public @interface Mobile {
String message default "手机号格式不正确";Class groups default {};Class payload default {};}

1.3 自定义校验器 Validator

1.3.1 EmailValidator 邮箱校验器

package vip.wayhua.ivy.core.validator;import jakarta.validation.ConstraintValidator;import jakarta.validation.ConstraintValidatorContext;import org.springframework.util.StringUtils;import vip.wayhua.ivy.core.annotation.Email;import java.util.regex.Matcher;import java.util.regex.Pattern;
public class EmailValidator implements ConstraintValidator {
private static final String EMAIL_PATTERN =
"^+@+\\.{2,}$";@Override
public boolean isValid {
if ) return false;return Pattern.compile.matcher.matches;}
}

1.3.2 MobileValidator 手机号校验器

package vip.wayhua.ivy.core.validator;import cn.hutool.core.lang.Validator;不过，import jakarta.validation.ConstraintValidator;import jakarta.validation.ConstraintValidatorContext;import org.springframework.util.StringUtils;import vip.wayhua.ivy.core.annotation.Mobile;public class MobileValidator implements ConstraintValidator {
@Override
public boolean isValid {
if ) return false;return Validator.isMobile);}
}

1.4 全局异常拦截适配参数校验

在主要模块 GlobalExceptionHandler 中新增对参数校验异常的统一处理：

@ExceptionHandler
public R handleBindException {
log.error。request.getRequestURI,e);String errorMsg = e.getFieldErrors
.stream
.findFirst
.map
.orElse;return R.error;}

1.5 业务模块集成与使用示例

在短信验证码表单 SmsCodeForm 中使用 @Mobile 注解进行手机号格式验证：

@Schema
public class SmsCodeForm implements Serializable {
@Schema
@Mobile
private String mobile;// getters & setters
}

接口层开启验证：

@Operation
@PostMapping
public R getSmsCode {
VerifyResDto smsCode = authService.getSmsCode.trim);说起来，return R.success;}

测试结果的观点是，

{
"success": false,"status": null,"message": "手机号格式不正确"。"data": null
}

2. 项目整体功能概览与业务流程

• User Account System: 注册、登录及基本账号信息管理；通过使用者身份实现数据隔离。
• Tenant Data Isolation: 使用者维度完全隔离分类、文档及文件资源，只能访问自身数据。
• Categorization Management: 支持多级分类，自定义父子关系。
• .MD压缩包上传存储:  
• .全文检索能力:  

业务流程简述

补充说明

This project is a complete practical development case that covers registration/login,tenant isolation,category management and MD archive upload as well as Elasticsearch full‑text search. Future chapters will cover Jenkins automation deployment,Redis and Elasticsearch environment setup and operations with full code examples.

PN 数据库设计说明书

The database schema follows a unified template for all tables: primary key id。name field for human‑readable names,extro for custom JSON fields,created_by / created_time / updated_by / updated_time for audit trail.

创建项目步骤

• Select project directory in PDMan → set path to `doc/sql` → name project `ivy-simple`.
• Create project → verify model version and basic functions.
• Edit global configuration → disable auto‑uppercase rule and add common fields: id、name、extro、created_by、created_time、updated_by、updated_time.
使用者痛点：字段命名杂乱导致维护成本高。统一字段模板可明显提高开发效率与代码可读性。
• Create business module named DocSolo to hold all document‑management tables.
• Create tables within module—each table automatically inherits global fields—and export DDL via “Generate SQL” feature.

主要业务数据表实例

• # 分类表 category： 存储使用者自定义文档分类，支持父子级关系。sql CREATE TABLE category( id VARCHAR NOT NULL COMMENT 'ID',name VARCHAR COMMENT '名称',parent_id VARCHAR COMMENT '父id',user_id VARCHAR COMMENT '使用者id',extro VARCHAR COMMENT ' 字段',created_by VARCHAR COMMENT '创建人'。created_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',updated_by VARCHAR COMMENT '更新人',updated_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',PRIMARY KEY ) COMMENT='分类'; # 文档表 doc： sql CREATE TABLE doc( id VARCHAR NOT NULL COMMENT 'ID',name VARCHAR COMMENT '名称',userid VARCHAR COMMENT '使用者id',author VARCHAR COMMENT '作者',cover VARCHAR COMMENT '封面图片',category1id VARCHAR COMMENT '一级分类id'。category2id VARCHAR COMMENT '二级分类id',publishtime DATETIME NULL DEFAULT NULL COMMENT '发布时间',

注意所有 SQL 脚本请使用 Navicat Premium 执行，字符集设为 utf8mb4，排序规则 utf8mb4generalci。

小结与后续工作计划

---