花了小半年开发了一个 AI 套壳 APP ，这是我本人第一次尝试开发 APP ，现学现做，投入了大量的时间和精力，然而大势已过，加上国家对 AIGC 类 APP 的管控越来越严格，APP 上架后第二版就被禁止在国内销售了，思来想去，再继续搞下去前途也比较迷茫。所以直接开源了，需要的自取哈。

作为一名phper，在使用Lumen框架开发微服务的时候，API文档的书写总是少不了的，比较流行的方式是使用swagger来写API文档，但是与Java语言原生支持 annotation 不同，php只能单独维护一份swagger文档，或者在注释中添加annotations来实现类似的功能，但是注释中书写Swagger注解是非常痛苦的，没有代码提示，没有格式化。

实现一个全局作用域功能只需要定义一个实现Illuminate\Database\Eloquent\Scope接口的类，该接口只有一个方法apply，在该方法中增加查询需要的约束

假设User模型关联了Phone模型，要定义这样一个关联，需要在User模型中定义一个phone方法，该方法返回一个hasOne方法定义的关联

使用Eloquent ['eləkwənt] 时，数据库查询构造器的方法对模型类也是也用的，使用上只是省略了DB::table('表名')部分。

在Laravel中执行数据库操作有两种方式，一种是使用\DB外观对象的静态方法直接执行sql查询，另外一种是使用Model类的静态方法（实际上也是Facade的实现，使用静态访问方式访问Model的方法，内部采用了__callStatic魔术方法代理了对成员方法的访问。