kunming-it-companies

Project Brief / 项目简介

昆明技术机会雷达 / Kunming Tech Radar 是一个面向昆明与云南的开源技术机会数据库。

它整理公开来源中的公司、招聘入口、活动、社群和政府数字化项目线索,帮助学生、开发者、自由职业者、创业者和企业更容易发现本地技术生态中的节点。

What It Is

What It Is Not

Main Data Files

File Purpose
data/companies.json Primary company dataset maintained by contributors.
COMPANIES.md Generated human-readable company index.
data/companies.csv Generated table export for spreadsheets.
data/source-leads.csv Public source entry points for future verification.
data/communities.csv Public community and organization entry points.
data/events.csv Public event and activity entry points.
data/gov-projects.csv Government procurement and digital project portals.

Public Entry Pages

Page Purpose
submit.html Low-friction submission page for users who cannot or do not want to use GitHub.
docs/use-cases.md How students, developers, freelancers, founders, companies, and non-local readers can use the project.
docs/search-guide.md Maps common search phrases to real data files, filters, and verification boundaries.
docs/domestic-site-deploy.md Deployment notes for using kunming.tianmind.com as the main public entry.
docs/data-quality-report.md Shows current verification status, missing districts, and weak-source records.

Data Quality Rules

Every record should be traceable to a public source. When the source is weak, the record should stay marked as community_pending or use a lower confidence_score.

The project does not copy private contact details, private chat records, screenshots, unverified salary claims, or negative rumors. If a public source contains private contact details, keep the source URL but do not duplicate the private details into the dataset.

Best First Contributions

  1. Add official websites for community_pending companies.
  2. Add official recruiting pages without claiming active hiring.
  3. Add missing district information.
  4. Add source corrections for outdated or broken links.
  5. Add public pages for local university tech groups, developer meetups, park activities, and digital-government portals.

Maintainer Workflow

npm run generate:companies
npm run export:csv
npm run validate

data/companies.json is the source of truth for company data. Do not hand-edit generated company tables unless the generator is also updated.