القائمة
Structured triage workflow for CarbonJ bugs — reproduce, isolate to a pipeline phase (ingest / accumulate / store / query), then write a failing test before patching.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Verify and auto-fix the BSD-3-Clause license headers that the build enforces. CarbonJ has no checkstyle/spotless — license headers are the only enforced static check.
Self-review checklist for a CarbonJ change before opening or merging a PR. Aligns with what CI enforces.
Build the bootJar and start CarbonJ locally on the default `dev` profile.
Run CarbonJ tests. Defaults to the service module's full unit+integration suite. Pass an FQCN (e.g. `com.demandware.carbonj.service.db.points.SomeTest`) or pattern to scope.
| name | debug |
| description | Structured triage workflow for CarbonJ bugs — reproduce, isolate to a pipeline phase (ingest / accumulate / store / query), then write a failing test before patching. |
cfgKinesis / cfgAccumulator overrides in effect.CarbonJ is ingest → accumulate → store → query. Identify which phase failed:
| Symptom | Likely phase | Where to look |
|---|---|---|
| Points dropped at the edge, line-protocol parse errors | ingest | engine/LineProtocolHandler, engine/PickleProtocolHandler, netty/, InputQueue, PointProcessor* |
| Kinesis lag, checkpoint stuck, KCL warnings | ingest (Kinesis) | engine/KinesisConsumer, KinesisRecordProcessor, cfgKinesis, FileCheckPointMgr, DynamoDbCheckPointMgr |
| Wrong rollup values, missing aggregated series | accumulate | accumulator/AccumulatorImpl, MetricAggregationRule, aggregation-rules-test.conf, recovery/ |
| Glob queries return nothing / wrong ids | store/index | db/index/MetricIndexImpl, IndexStoreRocksDB, QueryUtils, QueryPart |
| Data missing in 5m or 30m archive | store/points | db/points/DataPointArchiveRocksDB, IntervalProcessor*, StagingFile* |
| HTTP 500 / wrong JSON shape | query | engine/Graphite*Servlet, admin/ |
| Wrong routing between shards | relay | Relay, RelayRouter, RelayRules, relay-rules.conf, blacklist.conf |
cfg* classThe bean wiring for the phase is in the corresponding @Configuration class. Tunables almost always live there, not at the use site.
Add a JUnit 5 test in the matching package under carbonj.service/src/test/java/.... Reuse fixtures from carbonj.service/src/test/resources/ (e.g. aggregation-rules-test.conf).
Run scoped:
./gradlew :carbonj.service:test --tests <FQCN>.<method> --info
./gradlew :carbonj.service:test../gradlew licenseMain.60s24h, 5m7d, 30m2y — admin APIs depend on them.kinesis/, you need it running locally.master; debug commits should land on a feature branch.