Definition manual corresponding to Phase 2 (financials) of the company-research SOP, also used for any "how are the results" follow-up. Principles:Cumulative values are the raw material, the single quarter is the basic unit, TTM looks at scale, the latest period looks at inflection; every split / sum / ratio is a calc call。
0. Four iron rules
- What A-share financial reports disclose isreporting-period cumulative values(Q1 / H1 / Q1–Q3 / full year); any "single quarter" or "QoQ" must be obtained via
quarterizebreakdown, not subtracted in your head. - Deducted non-recurring vs. attributable to parent: use deducted non-recurring for the valuation numerator (one-off gains/losses cannot be ×4), use attributable to parent for the main growth judgment (same definition as consensus EPS); report both side by side, and when the difference is large you must explain it (investment income / subsidies / impairments / fair value changes).
- Numerator and denominator in the same period and same definition: YoY against the same quarter, TTM against TTM; do not compare cumulative values with single quarters.
- Ratios (gross margin / net margin / expense ratio / debt ratio / proportion) are all
ratio(numerator, denominator, label, unit_in), you guarantee both numbers are in the same unit; calc does not convert units.
1. Definition map
| Definition | Definition | calc function | Use | Prohibited |
|---|---|---|---|---|
| Cumulative value (YTD) | Original value disclosed for the reporting period | — (evidence) | Raw material | Do not directly compare reporting periods of different lengths |
| Single quarter | Q1 = YTD(Q1);Qn = YTD(n) − YTD(n−1) | quarterize(cumulative, unit, money=true) |
Basic unit | Previous period missing → no value for that quarter; do not substitute an average |
| Latest single quarter | Latest non-empty single quarter | latest_quarter(single_quarters, unit, money=true) |
Valuation numerator (deducted non-recurring), inflection judgment | — |
| TTM | Sum of the last 4 quarters | ttm_sum(single_quarters, end_period, unit, money=true) |
Scale, TTM PE | If any quarter is missing, then not_meaningful(do not make it up from 3 quarters) |
| TTM YoY | TTM(end) ÷ TTM(end − 4 quarters) − 1 | ttm_yoy(...) |
Fact of sustainable growth, cross-validation of forward CAGR | Requires 8 consecutive quarters |
| QoQ | Q(end) ÷ Q(end − 1) − 1 | qoq(...) |
Inflection / momentum signal | Prohibited as a growth rate, prohibited from annualizing, prohibited as a PEG denominator |
| Single-quarter YoY | Q(end) ÷ Q(end − 4) − 1 | growth_rate(current, base, label) |
Look at the direction of "this quarter relative to last year" | Prohibited as a PEG denominator (a low base falsely inflates it) |
| Ratio | Ratio of two line items in the same period and same unit | ratio(numerator, denominator, label, unit_in) |
Gross margin / net margin / expense ratio / debt ratio / operating cash flow ÷ net profit | Denominator ≤ 0 → not_meaningful, write it as is |
Use money=false for EPS series (yuan per share); for amount-type items use money=true and let calc normalize the unit.
2. Breakdown process (consistent with the financials phase of the SOP)
fetch_financials(★ required) → cumulative value series for revenue / net profit attributable to parent / deducted non-recurring / EPS (last 8–12 reporting periods).quarterizeRun each once: revenue_cum, net_profit_parent_cum, net_profit_deducted_cum (unit=yuan, money=true).latest_quarter(deducted non-recurring) → valuation numerator;ttm_sum(one each for attributable-to-parent and non-recurring-adjusted) → intermediate quantity;ttm_yoy(primarily attributable to parent, non-recurring-adjusted in parallel) → growth fact;qoq(latest single-quarter non-recurring-adjusted) → inflection signal.- Three-statement cross-check (○ optional endpoints):
sina_income_statement/sina_balance_sheet/sina_cashflow(A-shares),em_global_income/em_global_balance/em_global_cashfloworyahoo_financials(US / HK). Only for verification and supplementary line items (gross profit, expenses, operating cash flow, receivables, inventory, interest-bearing debt),record line-item raw values as-is from the source, without conversion. - Ratios: gross margin =
ratio(毛利, 营收); net margin =ratio(净利润, 营收); expense ratio =ratio(某费用, 营收); operating cash flow / net profit =ratio(经营现金流净额, 净利润); debt-to-asset ratio =ratio(总负债, 总资产)——one call per ratio, numerator and denominator for the same period and in the same unit, record calc id. - Every calc call passes
--run-dir(the CLI writes the record of that calculation into the run directory'scalcs/, and the orchestrator merges them at the end into the contract artifactcalculations.json; do not write any file by hand), and the stage JSON references calculation_id; for gaps follow the structured gaps in SOP §2.
3. Quality checklist (write into the inference section)
- One-off gains/losses: when the difference between attributable-to-parent and non-recurring-adjusted exceeds 20%, the source must be explained (investment income / government subsidies / impairment / fair value changes), and state which basis is used for valuation and which for growth.
- Seasonality: mark whether the latest single quarter is Q1 / Q2 / Q3 / Q4, and the company's historical peak/off-season direction (from the single-quarter series), and flag the directional bias of "single quarter × 4" (valuation §1).
- Reporting period alignment: year-on-year against the same quarter, TTM against TTM; when comparing across companies, first list their respective reporting periods.
- Cash flow vs profit: operating cash flow ÷ net profit persistently < 1 → mark "profit quality to be verified", and look at changes in receivables / inventory (three-statement cross-check).
- Balance sheet: interest-bearing debt, receivables / inventory growth vs revenue growth (use
growth_rateto calculate each once and then compare, do not do mental math). - Audit and announcements: annual report audit opinion, differences between earnings forecasts / flash reports and the formal report (
fetch_announcements/cninfo_announcements)。
4. Interpretation template ("turn to the latest period, scale to TTM")
| Question | What to look at | calc |
|---|---|---|
| Is it accelerating or decelerating? | Latest single-quarter non-recurring-adjusted quarter-on-quarter (inflection), single-quarter year-on-year direction, trend over two consecutive quarters | qoq、growth_rate |
| Has the growth materialized? | Difference between TTM year-on-year (attributable to parent) and forward CAGR | ttm_yoy → valuation's forward_vs_ttm_judgement |
| How is profit quality? | non-recurring-adjusted / attributable-to-parent, operating cash flow / net profit, gross margin trend | ratio |
| How large is the scale? | TTM revenue / profit | ttm_sum |
Five-question self-check (AGENTS.md §1): calculated or mental math? Are there fields pulled that could overturn the conclusion? Source / purpose, same period? Turn vs scale? Have you sought counter-evidence for strong conclusions?
5. Outputs
- Fact table: metric | value | unit | reporting period | source (ev id)
- Derived table: basis | value | reporting period | calc id
- Inference section: seasonality / one-off gains and losses / profit quality / turn judgment (each with basis and confidence)
- Gaps: which period / line item is missing, which sources were tried, impact on the conclusion
6. What not to do
- No mental math, no converting units yourself, no making a TTM out of 3 quarters, no using quarter-on-quarter as growth.
- Do not treat consensus expectations as facts (that is the estimates stage, and it is marked as a forecast).
- Do not give investment action recommendations.