systemctl restart clearflask-server    # 改配置后重启 Java 服务
systemctl restart clearflask-connect   # 改 connect.config.json 后重启 Node 服务

$ curl -s http://127.0.0.1:8130/api/health
ok
$ ss -ltn | grep ':8130\b'
LISTEN 0 4096 0.0.0.0:8130 0.0.0.0:*
$ ps -ef | grep 'catalina.base' | grep -v grep | head -1
root 792229 792202 15 19:32 ? 00:05:32 /opt/java/openjdk/bin/java -Djava.util.logging.config.file=/usr/local/tomcat/conf/logging.properties ... -Xms256m -Xmx512m ... org.apache.catalina.startup.Bootstrap start

Server startup in 13309 ms

catalina.sh  ciphers.sh  configtest.sh  daemon.sh  digest.sh
makebase.sh  setclasspath.sh  shutdown.sh  startup.sh  tool-wrapper.sh  version.sh

$ catalina.sh version
Server version: Apache Tomcat/9.0.123
Server built:   Oct 6 2026 18:59:20 UTC
Server number:  9.0.123.0
OS Name:        Linux
OS Version:     7.0.0-38-generic
Architecture:   amd64
JVM Version:    17.0.20.1+1
JVM Vendor:     Eclipse Adoptium

$ mysqldump -h <索引库主机> -uroot -pclearflask clearflask > backup-mysql.sql
$ ls -l backup-mysql.sql
-rw-r--r-- 1 root root 9139 Nov  1 20:07 backup-mysql.sql
$ head -5 backup-mysql.sql
/*M!999999\- enable the sandbox mode */
-- MariaDB dump 10.19  Distrib 10.5.29-MariaDB, for debian-linux-gnu (x86_64)
--
-- Host: localhost    Database: clearflask

$ mysql -h <索引库主机> -uroot -pclearflask -e "use clearflask; show tables;"
Tables_in_clearflask
account
comment
comment_parent_id
idea
idea_funders
idea_tags
user

$ aws --endpoint-url=http://127.0.0.1:4566 dynamodb list-tables
{
    "TableNames": [
        "clearflaskprimary"
    ]
}
$ aws --endpoint-url=http://127.0.0.1:4566 s3 ls
2026-11-01 11:02:14 local-upload

$ curl -s -o project.zip -w '%{http_code}\n' \
    -H "x-cf-connect-token: $CONNECT_TOKEN" -H "Cookie: cf_act_auth=$TOK; cf_sup_auth=$TOK" \
    http://127.0.0.1:8080/api/v1/project/demo-9j4rx8vf/admin/export
200
$ file project.zip
project.zip: Zip archive data

$ TOK=$(curl -s -D- -X POST http://127.0.0.1:8130/api/v1/admin/account/login \
    -H 'Content-Type: application/json' \
    -d '{"email":"admin@localhost","password":"q1w2e3r4"}' \
    | grep -oP 'cf_sup_auth=\K[^;]+' | head -1)
$ echo "$TOK"
5a2362d290a742088e7a...   # 32 位小写十六进制会话 ID

$ curl -s -H "Cookie: cf_act_auth=$TOK; cf_sup_auth=$TOK" \
    http://127.0.0.1:8130/api/v1/project/config/admin
{"byProjectId":{}}

{
  "test": false,
  "projectId": "demo-project",
  "name": "DemoBoard",
  "slug": "demo",
  "cookieConsent": {},
  "layout": {
    "pages": [{"pageId": "page1", "name": "Feedback", "slug": "feedback", "components": {}, "panels": []}],
    "menu": [{"menuId": "menu1", "pageIds": ["page1"], "name": "Feedback"}]
  },
  "content": {
    "categories": [{
      "categoryId": "cat1", "name": "Ideas", "userCreatable": true, "visibility": "Public",
      "workflow": {"statuses": [{"statusId": "st1", "name": "Started", "disableFunding": false,
        "disableVoting": false, "disableExpressions": false, "disableIdeaEdits": false, "disableComments": false}]},
      "support": {"fund": false, "comment": true},
      "tagging": {"tags": [], "tagGroups": []}
    }]
  },
  "style": {"palette": {"darkMode": false}, "typography": {}, "animation": {"enableTransitions": true},
            "whitelabel": {"poweredBy": "Show"}},
  "users": {"displayName": {}, "onboarding": {
      "visibility": "Public", "accountFields": {"displayName": "Optional"},
      "notificationMethods": {"browserPush": false, "oauth": [],
        "email": {"mode": "SignupAndLogin", "verification": "None"}}}},
  "integrations": {}
}

HTTP 200
{"projectId":"demo-9j4rx8vf","config":{"config":{...,"slug":"demo",...},"version":"new"},
 "user":{"userId":"admin-swt4n","name":"Admin","isMod":true,"email":"admin@localhost",...}}

$ curl -s -H "x-cf-connect-token: $CONNECT_TOKEN" -H "Cookie: cf_act_auth=$TOK; cf_sup_auth=$TOK" \
    http://127.0.0.1:8080/api/v1/project/demo-9j4rx8vf/admin/config   # GET 读全量 Config
$ curl -s -X PUT -H 'Content-Type: application/json' \
    -H "x-cf-connect-token: $CONNECT_TOKEN" -H "Cookie: cf_act_auth=$TOK; cf_sup_auth=$TOK" \
    --data @config-updated.json \
    http://127.0.0.1:8080/api/v1/project/demo-9j4rx8vf/admin/config   # PUT 回写全量

HTTP 500
JsonSyntaxException: Expected BEGIN_OBJECT but was BOOLEAN at path $.content.categories[0].support.vote.iWantThis

$ curl -s -X POST -H 'Content-Type: application/json' \
    -H "x-cf-connect-token: $CONNECT_TOKEN" -H "Cookie: cf_act_auth=$TOK; cf_sup_auth=$TOK" \
    -d '{"name":"Feedback User","email":"feedback@localhost","password":"q1w2e3r4"}' \
    http://127.0.0.1:8080/api/v1/project/demo-9j4rx8vf/admin/user
{"userId":"feedback-user-pjv4","name":"Feedback User","email":"feedback@localhost","hasPassword":true,"balance":0,...}

$ curl -s -D- -X POST -H 'Content-Type: application/json' \
    -H "x-cf-connect-token: $CONNECT_TOKEN" \
    -d '{"email":"feedback@localhost","password":"q1w2e3r4"}' \
    http://127.0.0.1:8080/api/v1/project/demo-9j4rx8vf/login | grep -i 'set-cookie\|HTTP/'
HTTP/1.1 200
Set-Cookie: cf_usr_auth_demo-9j4rx8vf=ba2a6e08ea234ae88ede1e135c54f2ee; Path=/; HttpOnly; SameSite=Strict; Expires=Sat, 28 Aug 2027 12:25:27 GMT
Set-Cookie: cf_usr_auth_demo-9j4rx8vf=; Domain=localhost; Expires=Thu, 01 Jan 1970 00:00:00 GMT

# 管理侧建 idea（也可由门户用户经 /idea 端点创建，需门户会话）
$ curl -s -X POST -H 'Content-Type: application/json' \
    -H "x-cf-connect-token: $CONNECT_TOKEN" -H "Cookie: cf_act_auth=$TOK; cf_sup_auth=$TOK" \
    -d '{"authorUserId":"admin-swt4n","title":"支持导出反馈为CSV","description":"希望仪表盘能一键导出全部反馈数据为CSV。","categoryId":"cat1","tagIds":[],"statusId":"st1"}' \
    http://127.0.0.1:8080/api/v1/project/demo-9j4rx8vf/admin/idea
{"ideaId":"csv-eowcvlnv","authorName":"Admin","title":"支持导出反馈为CSV","categoryId":"cat1","statusId":"st1","vote":{},...}

# 门户用户投票（vote 是枚举字符串，不是数字！）
$ curl -s -X PATCH -H 'Content-Type: application/json' \
    -H "x-cf-connect-token: $CONNECT_TOKEN" \
    -H "Cookie: cf_usr_auth_demo-9j4rx8vf=$USER_SESSION" \
    -d '{"vote":"upvote"}' \
    http://127.0.0.1:8080/api/v1/project/demo-9j4rx8vf/vote/idea/csv-eowcvlnv
{"vote":{"vote":"upvote"},"idea":{"ideaId":"csv-eowcvlnv",...,"voteValue":1,...}}

$ curl -s -X POST -H 'Content-Type: application/json' -H "x-cf-connect-token: $CONNECT_TOKEN" \
    -d '{}' http://127.0.0.1:8080/api/v1/project/demo-9j4rx8vf/ideasearch
{"results":[{"ideaId":"csv-eowcvlnv",...,"vote":{}}],"hits":{"value":1,"isGte":true}}

service:jmx:rmi:///jndi/rmi://localhost:9950/jmxrmi