feat: manually mirror opencoze's code from bytedance

Change-Id: I09a73aadda978ad9511264a756b2ce51f5761adf

docker/atlas/README.md

@@ -0,0 +1,71 @@
+## 0. setup environment
+
+On Mac :
+
+	brew install ariga/tap/atlas
+
+On Linux :
+
+	curl -sSf https://atlasgo.sh | sh -s -- --community
+
+Setup to you database url :
+
+	export ATLAS_URL="mysql://coze:coze123@localhost:3306/opencoze?charset=utf8mb4&parseTime=True"
+
+## 2. init baseline
+
+	# cd ./docker/atlas
+	atlas migrate diff initial --env local --to $ATLAS_URL
+	
+	# The following command is the same as the one above.
+	atlas migrate diff initial \
+	  --dir "file://migrations" \
+	  --to $ATLAS_URL \
+	  --dev-url "docker://mysql/8/"
+
+## 3. update database table
+
+On developer machine（I want add/update table for my business）
+
+	# First, add or update your table as needed.
+	
+	# Second, autogenerate diff sql 
+	# cd ./docker/atlas
+	atlas migrate diff update --env local --to $ATLAS_URL  # step 1
+	
+	# The following command is the same as the one above.
+	atlas migrate diff update \
+	  --dir "file://migrations" \
+	  --to $ATLAS_URL \
+	  --dev-url "docker://mysql/8/"
+	# will autogenerate some xxxxx_update.sql in margrations
+	
+	
+	# Third, Check whether the contents of the new xxxx_update.sql file are correct.
+	# If any changes are needed, please modify it manually.
+	# If you manually modified margrations file, you need to run the following command to update its hash value.
+	# If you did not manually modify margrations file, do not run the following command.
+	atlas migrate hash  # step 2 if need
+	atlas migrate status --url $ATLAS_URL --dir "file://migrations" # check status 
+	
+	# Last, dump the lastest database schema for other developer
+	atlas schema inspect -u $ATLAS_URL --exclude "atlas_schema_revisions,table_*"  > opencoze_latest_schema.hcl # step 3 
+
+## 4. apply migration
+
+On developer machine（I want to update my local database with the changes that others developer have made）
+
+	# cd ./docker/atlas
+	atlas schema apply -u $ATLAS_URL --to file://opencoze_latest_schema.hcl # step 1 for developer on mac, this command will execute in start_debug.sh
+
+On Server machine
+
+	atlas migrate apply --url $ATLAS_URL --dir "file://migrations"  --baseline "20250703095335" # step 1 for dev server
+
+
+
+
+
+
+
+