diff --git a/src/migrations/README.md b/src/migrations/README.md
new file mode 100644
index 00000000..a76d0fe9
--- /dev/null
+++ b/src/migrations/README.md
@@ -0,0 +1,3 @@
+# migrations
+
+there are sea_orm migrations to apply to your database
diff --git a/src/model/README.md b/src/model/README.md
new file mode 100644
index 00000000..f2761262
--- /dev/null
+++ b/src/model/README.md
@@ -0,0 +1,3 @@
+# model
+
+these are orm entities, with associated relations, constructors and sometimes utility functions